Skip to content

About

A Cloudflare Worker that implements the MCP Streamable HTTP transport for AI agents to interact with pump.fun on Solana.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

17 stars

Watchers

0 watching

Forks

Repository files navigation

Pump.fun MCP Server

GitHub stars Last commit PRs welcome AI agent friendly

A Cloudflare Worker that implements the MCP Streamable HTTP transport for AI agents to interact with pump.fun on Solana.

Tools (10 read-only tools)

Tool Description
searchTokens Search tokens by name, symbol, or mint address
getTokenDetails Full details for a specific token
getBondingCurve Bonding curve analysis — reserves, price, graduation %
getTokenTrades Recent trade history (buys & sells)
getTrendingTokens Top tokens by market cap
getNewTokens Most recently launched tokens
getGraduatedTokens Tokens that graduated to Raydium AMM
getKingOfTheHill Highest market cap token still on bonding curve
getCreatorProfile All tokens by a creator + rug-pull risk flags
getTokenHolders Top holders with concentration analysis

All tools are read-only — no wallet keys needed. Write operations (buy/sell/create) require client-side wallet signing and are intentionally excluded for safety.

Deploy

npm install
npx wrangler deploy

Custom domain

To serve at pump-fun-sdk.modelcontextprotocol.name (or any subdomain):

  1. Add a CNAME record in Cloudflare DNS pointing to your Worker
  2. Add a Custom Domain in the Cloudflare dashboard under Workers → pump-fun-mcp → Settings → Domains & Routes

Or for the path-based gateway pattern (modelcontextprotocol.name/mcp/pump-fun-sdk):

  1. Uncomment the [route] section in wrangler.toml
  2. Redeploy

Connect from SperaxOS

The server is registered in cryptoMcpData.ts and appears in the MCP marketplace. Users can also add it manually:

https://pump-fun-sdk.modelcontextprotocol.name/mcp

Development

npx wrangler dev   # local dev server on :8787

Test with curl:

# Discovery manifest
curl http://localhost:8787/

# Initialize
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# List tools
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# Search tokens
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"searchTokens","arguments":{"query":"pepe","limit":5}}}'

Architecture

AI Agent (SperaxOS)
    │
    ▼
Cloudflare Worker (MCP Streamable HTTP)
    │
    ├── pump.fun API (token data, search, trades)
    │   └── frontend-api-v3.pump.fun
    │
    └── Solana RPC (holder data, on-chain reads)
        └── api.mainnet-beta.solana.com

Star History

Star History Chart

Support the project

If pump-fun-workers saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.

Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit

Built for AI agents too

Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/pump-fun-workers and it has the context it needs.

More from the same author

Contributors

Contributors

About

A Cloudflare Worker that implements the MCP Streamable HTTP transport for AI agents to interact with pump.fun on Solana.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages