pumpfun-claims-bot docs
nirholas / pumpfun-claims-bot

pumpfun-claims-bot

PumpFun on-chain intelligence โ€” Telegram feed + MCP server for AI assistants. Query token data, GitHub social fee claims, creator profiles, and more.

v1.0.1SEE LICENSE IN LICENSETypeScript
npx pumpfun-claims-bot

What it does

Capabilities documented in this repository.

Features

See the full documentation for details.

Feed Types

See the full documentation for details.

Claim Intelligence

See the full documentation for details.

Graduation Cards

See the full documentation for details.

Influencer Tier System

See the full documentation for details.

Credibility Score & Dev Track Record

See the full documentation for details.

Get started

Install it, then run your first command.

npx pumpfun-claims-bot
CommandRuns
npm run devtsx watch src/index.ts
npm run startnode dist/index.js
npm run buildtsc
npm run typechecktsc --noEmit
npm run testvitest run

Read the full getting started guide

Examples

Taken directly from this repository's documentation.

๐ŸŸข Credibility: 100/100 ยท Strong
   โ†‘ claim verified ยท GitHub 6y ยท 42 repos ยท repo 150โ˜…
๐Ÿ“Š Dev track record: 3 prior tokens ยท avg ๐Ÿ”ด 19/100 (High Risk)
Solana RPC (WebSocket + HTTP polling)
        โ”‚
        โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  SocialFeeIndex   โ”‚โ”€โ”€โ–ถ Bootstraps ~148K SharingConfig โ†’ mint mappings
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   ClaimMonitor    โ”‚โ”€โ”€โ–ถ Decodes PumpFees program claim transactions
โ”‚   EventMonitor    โ”‚โ”€โ”€โ–ถ Decodes Pump program logs (graduations)
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚ FeeClaimEvent / GraduationEvent
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ Enrichment Layer  โ”‚
โ”‚  โ”œโ”€ GitHub API    โ”‚โ”€โ”€โ–ถ User profile, repos, followers
โ”‚  โ”œโ”€ X/Twitter API โ”‚โ”€โ”€โ–ถ Follower counts, influencer tier
โ”‚  โ”œโ”€ PumpFun API   โ”‚โ”€โ”€โ–ถ Token info, creator profile, holders, trades
โ”‚  โ”œโ”€ ClaimTracker  โ”‚โ”€โ”€โ–ถ First-claim detection, persistent counts
โ”‚  โ””โ”€ Fake Detect   โ”‚โ”€โ”€โ–ถ Instruction called but no payout (amountLamports=0)
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚ ClaimFeedContext
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚    Formatters     โ”‚โ”€โ”€โ–ถ Rich HTML cards with sections & emoji layout
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   grammY Bot      โ”‚โ”€โ”€โ–ถ Posts photo + caption to Telegram channel
โ”‚   (retry + rate   โ”‚    Falls back to text-only if photo fails
โ”‚    limiting)      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
npx pumpfun-claims-bot

More examples

Reference