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)

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.

Related MCP server: remote-mcp-server-authless

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

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

• All repositories by nirholas: the full catalog, grouped by topic

• three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments

• Questions or ideas: open an issue or start a discussion

Contributors