pumpdata MCP server
Commit Oct 17, 2026Analyze pump.fun coin data, including deployer records, wallet performance, and historical trade replays on Solana.
Also known as pumpdatafun/pumpdata-examples, pumpdata-examples
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.3.2
- Last commit
- Oct 17, 2026
- License
- MIT
What is pumpdata MCP?
pumpdata analyzes pump.fun coin data, including deployer records, wallet performance, and historical trade replays on Solana.
Summary generated from the project's README
About pumpdata MCP server
Analyzing pump.fun coin data and Solana trading history is what pumpdata enables for developers building automated agents or research scripts. It provides access to every trade, bonding curve, and PumpSwap event recorded on the chain's ledger, including data for coins that are no longer active. Users can retrieve deployer records, analyze wallet performance, and perform historical trade replays to see how specific picks would have filled against past market conditions.
This server operates via an x402 payment system on Solana, meaning users pay for data using USDC rather than requiring SOL for network fees. While some public data like yesterday's base rates are available for free, specific queries such as wallet analysis or launch details require signed USDC transfers. Integration is straightforward for those using Claude Desktop, Cursor, or Cline, and it supports various frameworks like ElizaOS, Vercel AI SDK, and Solana Agent Kit. To use paid features, you must provide a payer key via the PUMPDATA_PAYER_KEY environment variable.
What you can do with it
- 1Evaluate market cap success ratesAsk the agent to find how many coins within a specific market cap band reached certain price multipliers within three hours.
- 2Audit wallet behaviorDetermine if a list of specific wallet addresses are winners, bots, or supply sellers.
- 3Investigate token launchesRetrieve the deployer's history and the insider share for a specific token mint.
- 4Backtest trading strategiesReplay up to 500 token picks against historical chain data to calculate fees and fills.
Written from the project's README. Every use case is checked against a quote from it.
How to install pumpdata MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall pumpdata MCP in Claude Code
$ claude mcp add --transport http pumpdata-examples https://pumpdata.fun/mcpInstall pumpdata MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pumpdata-examples": {
"url": "https://pumpdata.fun/mcp"
}
}
}Install pumpdata MCP in VS Code
.vscode/mcp.json
{
"servers": {
"pumpdata-examples": {
"type": "http",
"url": "https://pumpdata.fun/mcp"
}
}
}Install pumpdata MCP in VS Code CLI
$ code --add-mcp '{"name":"pumpdata-examples","type":"http","url":"https://pumpdata.fun/mcp"}'Install pumpdata MCP in Codex
$ codex mcp add pumpdata-examples --url https://pumpdata.fun/mcpInstall pumpdata MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.pumpdata-examples] url = "https://pumpdata.fun/mcp"
Install pumpdata MCP in Gemini CLI
$ gemini mcp add -s user --transport http pumpdata-examples https://pumpdata.fun/mcpInstall pumpdata MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pumpdata-examples": {
"url": "https://pumpdata.fun/mcp",
"type": "http"
}
}
}Configuration
PUMPDATA_PAYER_KEY
| Name | Description | |
|---|---|---|
| PUMPDATA_PAYER_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepumpdatafun/pumpdata-examples is public and reachablegithub.com/pumpdatafun/pumpdata-examples ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-21github.com/pumpdatafun/pumpdata-examples ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 53 msPass
README
View on GitHubpumpdata examples
Calling pumpdata.fun from an agent or a script: every pump.fun trade, ever, bonding curve and PumpSwap, since pump.fun's first day, read from the chain's ledger with the dead coins kept, sold by the call in USDC over x402 on Solana. No key, no account.
| call | asks | price |
|---|---|---|
GET /baserate?band=15k-28k&from=<iso>&to=<iso>&venue=any |
how many coins first traded inside a market-cap band in a window, and how many reached 2x, 5x, 10x, 20x within 3 h | $0.005 |
POST /wallets {"addresses": [...], "mint": "<optional>"} |
what up to 50 wallets have been: winner, bot, supply seller, new, with the SOL behind it | $0.01 |
GET /launch/{mint} |
the deployer's record, the bundle at creation, the insiders' share, and how launches that looked the same went over 24 h | $0.005 |
POST /replay {"picks": [{"mint", "at", "size_sol"}, ...]} |
up to 500 picks replayed against the chain's history with fees and fills (a queued job; poll GET /replay/{id}) |
$2 |
Free, no payment: yesterday's base rate for every band at /public/baserate.json, refreshed hourly.
Contract: /openapi.json. Docs for agents: /llms.txt. A skill: /skill.md.
How a call is paid
- Call without payment. The answer is 402 with the offer in the body and in the
PAYMENT-REQUIREDheader: price, payee, network (USDC on Solana mainnet), and a Bazaar declaration of the inputs. - Sign a USDC transfer for that amount with your wallet (the facilitator pays the network fee; you need no SOL).
- Call again with the signed payment in
PAYMENT-SIGNATURE. The answer is the data, with the receipt inPAYMENT-RESPONSE.
The x402 client libraries do steps 2 and 3 for you. Every answer carries X-Data-As-Of (the build it comes from) and X-Data-From (where the data begins). A window with no data answers 404 and costs nothing.
The examples
curl.sh: the 402 and the free file, no wallet needed.node.mjs: a paid call with@x402/fetchand a Solana keypair.python.py: the 402 and the free file from Python; the paid retry with thex402package.mcp.md: the same calls as MCP tools (Claude Code, Cursor, Cline, Claude Desktop).
Check the base rate before you ape: agent recipes
A paid GET /baserate ($0.005) in four shapes, each 17-21 lines. The payer key comes from PUMPDATA_PAYER_KEY
(base58, or the solana-keygen JSON array). The wallet needs USDC and no SOL. Never commit the key.
| file | what | run |
|---|---|---|
x402-fetch.ts |
plain fetch with the official client, @x402/fetch + @x402/svm |
npm run fetch |
elizaos-action.ts |
ElizaOS (@elizaos/core 1.x): a pumpdata plugin with a PUMPDATA_BASE_RATE action |
npm run eliza |
solana-agent-kit-tool.ts |
solana-agent-kit v2: an Action in a plugin, run through executeAction |
npm run agent-kit |
vercel-ai-tool.ts |
Vercel AI SDK (ai v7): a tool() for generateText / streamText |
npm run ai-sdk |
npm install
export PUMPDATA_PAYER_KEY='<secret key>'
npm run fetch # yesterday's (UTC) $15-28K base rate, any venue
npm run typecheck
The three framework files reuse baseRate() from x402-fetch.ts. Run on their own, they call the action or tool
directly, the way the framework would, so no model or agent is needed to try them.
Not affiliated with pump.fun.
pumpdata MCP questions
How do I add pumpdata MCP to Claude Code?
Run claude mcp add --transport http pumpdata-examples https://pumpdata.fun/mcp in your terminal. Add --scope user to make it available in every project.
How do I add pumpdata MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I pay for API calls?
Calls are paid using USDC on Solana via the x402 protocol. You sign a USDC transfer for the required amount and resubmit the call with the signature.
What kind of wallet information can I retrieve?
You can check up to 50 wallets to see if they are winners, bots, supply sellers, or new, along with the SOL they hold.