# pumpdata

Gives your agent access to pump.fun trade history: deployer records, bundles, wallet PnL. Each call is paid in USDC on Solana.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: pumpdatafun
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pumpdatafun/pumpdata-examples
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/pumpdata

## What it does

The server connects to `https://pumpdata.fun/mcp` and exposes four tools. `GET /baserate` counts how many coins in a market-cap band launched in a window and how many hit 2x, 5x, 10x, 20x within 3 h. `POST /wallets` takes up to 50 addresses and tells you what they were: winner, bot, supply seller, new. `GET /launch/{mint}` shows the deployer's record, the bundle at creation and the insiders' share. `POST /replay` runs up to 500 picks against chain history with fees and fills.

Payment goes through x402: the first call returns 402 with the price and payee, you sign a USDC transfer, then repeat the request with the signature in `PAYMENT-SIGNATURE`. No key or account is needed, but the wallet must hold USDC — the facilitator covers the network fee, so no SOL is required. The x402 client libraries handle the signing steps for you. An empty window answers 404 and costs nothing.

Yesterday's base rate for every band sits at `/public/baserate.json` and refreshes hourly, free of charge. Agents can read `/llms.txt` and `/skill.md`; the contract is at `/openapi.json`. The repo's examples include `curl.sh`, `node.mjs` with `@x402/fetch`, `python.py`, and `mcp.md` with the same calls as MCP tools. The payer key comes from `PUMPDATA_PAYER_KEY`; never commit it.

## Requirements
- Remote server: `https://pumpdata.fun/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http pumpdata https://pumpdata.fun/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add pumpdata --url https://pumpdata.fun/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pumpdata": {
            "url": "https://pumpdata.fun/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pumpdata": {
            "type": "http",
            "url": "https://pumpdata.fun/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http pumpdata https://pumpdata.fun/mcp
```

## When to use it
- see how many coins in a market-cap band multiplied within 3 h
- check whether a wallet is a bot or a supply seller
- pull a deployer's record and the bundle at launch
- replay a list of trades against chain history with fees and fills
- get yesterday's base rate without paying

## Example prompts
- Show me the base rate for the 15k-28k band yesterday
- Check wallet `7xKX...` — is it a bot or a supply seller?
- Pull the deployer record for mint `ABC...` and the insiders' share

## Similar
- [x402 Wallet](https://affpapa.org/en/nevibecode/mcp/x402-wallet.md) — MCP server · ★ 250
- [x402 Universal Payer](https://affpapa.org/en/nevibecode/mcp/x402-universal-payer.md) — MCP server · ★ 250
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 274
- [ZendIQ](https://affpapa.org/en/nevibecode/mcp/zendiq.md) — MCP server · ★ 1
- [Palmyr](https://affpapa.org/en/nevibecode/mcp/palmyr.md) — MCP server · ★ 6
- [use-agent-wallet](https://affpapa.org/en/nevibecode/skills/use-agent-wallet.md) — skill · 804 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md