PumpFun Claims Bot — Claude Code MCP server: what it does
Feeds your agent PumpFun on-chain data: fee claims, holders, token graduations and bundle checks. Useful when Solana events need to be read inside the chat.
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --transport stdio pumpfun-claims-bot -- npx -y pumpfun-claims-botWhat PumpFun Claims Bot does
The server runs locally through npx and talks to the client over stdio. It reads PumpFun chain events and enriches them: GitHub social fee claim cards, tokens moving from the bonding curve to PumpAMM, developer profiles, claim counters, lifetime SOL pulled from the PDA.
On top of raw events the bot computes a 0–100 credibility score and keeps a per-developer record. A repeat claimer's earlier tokens and their average score show up next to the new one. There is also an identity mismatch flag for cases where the GitHub user in a claim differs from the repository owner in the token metadata. Treat that flag as the real signal: a withdrawal alone proves nothing about who made or backs a coin.
The feed is read-only by design. Two values are required at startup: GITHUB_TOKEN and SOLANA_RPC_URL. Without them the server gets neither the GitHub profile nor Solana network access, so both go into the environment when you register it.
What it helps with
- see who claimed a PumpFun social fee first and when
- check a developer's record across previously launched tokens
- spot a mismatch between the claiming GitHub account and the repo owner
- inspect a graduation with its holders, liquidity and bundle activity
- tell a real fee payout from an instruction call with no payout
Example prompts for the agent
- Show the latest PumpFun claims with their credibility scores
- Check this token's developer and the coins they launched before
- Does this claim have a GitHub identity mismatch?
How to install PumpFun Claims Bot
Platform CLI
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --transport stdio pumpfun-claims-bot -- npx -y pumpfun-claims-botReplace <…> with your own values
Platform CLI
codex mcp add pumpfun-claims-bot --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> -- npx -y pumpfun-claims-botReplace <…> with your own values
Config file
{
"mcpServers": {
"pumpfun-claims-bot": {
"command": "npx",
"args": [
"-y",
"pumpfun-claims-bot"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"pumpfun-claims-bot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pumpfun-claims-bot"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> pumpfun-claims-bot npx -y pumpfun-claims-botReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PumpFun Claims Bot
How to install PumpFun Claims Bot in Claude Code?
Run claude mcp add pumpfun-claims-bot -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y pumpfun-claims-bot. Or pass the RPC endpoint too: `claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --transport stdio pumpfun-claims-bot -- npx -y pumpfun-claims-bot`.
What does PumpFun Claims Bot do?
It pulls PumpFun on-chain events for your agent: social fee claims, token graduations, holders, bundles. Each card carries a credibility score and developer history.
What does the server need to run?
Two environment variables, GITHUB_TOKEN and SOLANA_RPC_URL, passed at install time. One supplies the GitHub profile, the other gives access to Solana.
