Pump.fun MCP Server
Provides tools to interact with pump.fun on Solana, including token search, details, bonding curve analysis, trade history, trending/new/graduated tokens, creator profiles, and token holder analysis.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Pump.fun MCP Server
A Cloudflare Worker that implements the MCP Streamable HTTP transport for AI agents to read pump.fun data on Solana. It is stateless: every request is answered on its own, with no sessions.
Tools (10 read-only tools)
Tool | Description | Source |
| Search tokens by name, symbol, or mint address | pump.fun API |
| Full details for a specific token | pump.fun API |
| Bonding curve read on-chain: reserves, spot price, market cap in SOL, exact graduation progress; for graduated coins, their PumpSwap pool | Solana RPC |
| Recent trade history (buys and sells), with | pump.fun API |
| Top tokens by market cap | pump.fun API |
| Most recently launched tokens | pump.fun API |
| Graduated tokens among the 50 largest by market cap | pump.fun API |
| Highest market cap token still on its bonding curve | pump.fun API |
| Tokens by a creator wallet, with a heuristic risk note | pump.fun API |
| Largest holders as a share of total supply, grouped by owner wallet, with the bonding-curve and PumpSwap pool vaults labelled | Solana RPC |
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. Every argument is validated (addresses must be 32-byte base58 keys, counts are bounded integers) before any upstream request.
How the on-chain numbers are derived:
Bonding curve. The curve account is the PDA
["bonding-curve", mint]of the pump program, decoded per the pump IDL. Spot price isvirtual_quote_reserves / virtual_token_reserves; market cap is spot price times total supply. A curve completes whenreal_token_reservesreaches 0, so graduation progress is the share of the curve's initial real token reserves already sold, computed exactly with theGlobalaccount's parameters. Curves created with other parameters report progress as unknown rather than a guess.Holders.
getTokenLargestAccountsreturns at most the 20 largest token accounts. Each account is resolved to its owner, accounts with the same owner are added together, and shares are measured againstgetTokenSupply. The bonding-curve vault and the canonical PumpSwap pool vault are labelled and left out of the top-5 concentration figure.
The pump.fun frontend API sits behind a bot challenge that can refuse datacenter traffic. When it does, the API-backed tools return a clear error; the two Solana RPC tools are unaffected.
Related MCP server: remote-mcp-server-authless
Deploy
npm install
npx wrangler deployConfiguration
Name | Kind | Purpose |
| variable or secret | Solana RPC endpoint. The default public endpoint rate-limits |
| variable | pump.fun frontend API base URL. |
| variable (optional) | Comma-separated browser origins allowed to call |
| rate limit binding | Per-IP limit on |
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 inwrangler.tomlRedeploy
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/mcpFrom Claude Code: claude mcp add --transport http pump-fun https://<your-worker>/mcp.
Transport behaviour
POST /mcptakes one JSON-RPC message, or a batch of up to 16, and answers withapplication/json.Notifications and client responses get
202 Acceptedwith no body.GETandDELETEon/mcpreturn405: the server opens no server-to-client stream and keeps no sessions.initializeechoes the client's protocol version when supported (2025-11-25,2025-06-18,2025-03-26,2024-11-05) and otherwise offers the latest. An unsupportedMCP-Protocol-Versionheader gets400.A browser
Originoutside the allowlist gets403. Bodies over 64 KiB get413, non-JSON content types415, and anAcceptheader that excludes JSON406. A rate-limited client gets429withRetry-After.Bad tool arguments come back as a tool result with
isError: true, so the model can correct them; an unknown tool is a JSON-RPC-32602error.
GET / (also /.well-known/mcp and /.well-known/mcp.json) returns a discovery manifest.
Development
npm run dev # wrangler dev, local server on :8787
npm run check # lint, typecheck, tests, and a wrangler dry-run bundle (what CI runs)Tests use node --test on the TypeScript sources directly (Node 22.18 or newer) and stub every upstream call.
Test with curl:
# Discovery manifest
curl http://localhost:8787/
# Initialize
curl -X POST http://localhost:8787/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
# List tools
curl -X POST http://localhost:8787/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
# Bonding curve, read on-chain
curl -X POST http://localhost:8787/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"getBondingCurve","arguments":{"mint":"<mint address>"}}}'Architecture
AI Agent (SperaxOS, Claude, ...)
│
▼
Cloudflare Worker (MCP Streamable HTTP, stateless)
│
├── pump.fun API (search, listings, token details, trades)
│ └── frontend-api-v3.pump.fun
│
└── Solana RPC (bonding curves, holders, supply)
└── SOLANA_RPC_URLSource layout: src/index.ts (HTTP transport), src/mcp.ts (JSON-RPC and MCP methods), src/tools.ts (tool schemas), src/executor.ts (tool handlers), src/validation.ts (argument checks), src/pumpApi.ts (pump.fun API client), src/solana.ts (RPC client and PDA derivation), src/curve.ts (bonding-curve decoding and math), src/holders.ts (holder arithmetic), src/format.ts (output hygiene).
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Cloudflare Workers MCP server: agent-workflow-engine
Cloudflare Workers MCP server: ai-agent-scratchpad
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA template for deploying an authentication-free MCP server on Cloudflare Workers. Provides a foundation for building custom tools accessible via SSE from MCP clients like Claude Desktop or the Cloudflare AI Playground.-
- FlicenseNot gradedqualityDmaintenanceDeploys a stateless remote MCP server on Cloudflare Workers without authentication, enabling MCP tool calls from clients like Claude Desktop and Cloudflare AI Playground.-
- FlicenseNot gradedqualityDmaintenanceEnables deploying a stateless remote MCP server on Cloudflare Workers without authentication, implementing the MCP 2026-07-28 specification and compatible with legacy clients for tool calls.-
- FlicenseNot gradedqualityBmaintenanceDeploys a stateless remote MCP server on Cloudflare Workers without authentication, enabling users to connect custom MCP tools to clients such as Cloudflare AI Playground and Claude Desktop.-