# PumpFun Claims Bot

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22
- Author: nirholas
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nirholas/pumpfun-claims-bot
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/pumpfun-claims-bot

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GITHUB_TOKEN`, `SOLANA_RPC_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add pumpfun-claims-bot --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> -- npx -y pumpfun-claims-bot
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> pumpfun-claims-bot npx -y pumpfun-claims-bot
```
Replace <…> with your own values

## When to use it
- 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
- 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?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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