Pump.fun MCP Server

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

cd workers/pump-fun-mcp
npm install
npx wrangler deploy

Custom domain

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

Add a CNAME record in Cloudflare DNS pointing to your Worker
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):

Uncomment the [route] section in wrangler.toml
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

Pump.fun MCP Server