Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/nirholas/three.ws/pump-fun-mcp-guidenpx skills add nirholas/three.ws --skill pump-fun-mcp-guidegit clone --depth 1 https://github.com/nirholas/three.wsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/nirholas/three.ws/pump-fun-mcp-guide)<a href="https://agentmods.dev/skills/nirholas/three.ws/pump-fun-mcp-guide"><img src="https://agentmods.dev/badge/skills/nirholas/three.ws/pump-fun-mcp-guide.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00061 | $0.00981 |
| Opus 5 | $0.00030 | $0.00491 |
| Sonnet 5 | $0.00012 | $0.00196 |
| Haiku 4.5 | $0.00006 | $0.00098 |
Grade A, and why
pump-fun-mcp-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Pump.fun MCP Server Guide
A Cloudflare Worker implementing MCP Streamable HTTP that provides AI agents with read-only access to pump.fun's Solana token launchpad data.
Tools (10)
| Tool | Description | Key Args |
|---|---|---|
searchTokens |
Search by name, symbol, or mint | query, limit, sort, order |
getTokenDetails |
Full token info + social links | mint |
getBondingCurve |
Bonding curve reserves, price, graduation % | mint |
getTokenTrades |
Recent buy/sell trade history | mint, limit, offset |
getTrendingTokens |
Top tokens by market cap | limit, includeNsfw |
getNewTokens |
Most recently launched tokens | limit |
getGraduatedTokens |
Tokens that graduated to Raydium AMM | limit |
getKingOfTheHill |
Highest mcap token still on bonding curve | — |
getCreatorProfile |
All tokens by a creator + rug flags | address, limit |
getTokenHolders |
Top holders + concentration analysis | mint, limit |
Architecture
AI Agent (SperaxOS)
│
▼
Cloudflare Worker (MCP Streamable HTTP)
│
├── pump.fun API (token data, search, trades)
│ └── frontend-api-v3.pump.fun
│
└── Solana RPC (holder data, on-chain reads)
└── api.mainnet-beta.solana.com
Connecting
Via SperaxOS MCP Marketplace
The server appears as "Pump.fun MCP" in the marketplace under crypto-web3 category.
Manual URL
https://modelcontextprotocol.name/mcp/pump-fun-sdk
Or if using a custom subdomain:
https://pump-fun-sdk.modelcontextprotocol.name/mcp
Key Concepts
Bonding Curve
Every pump.fun token starts on a bonding curve — an AMM with virtual reserves that determine price. As people buy, the price increases along the curve. The curve has these key properties:
| Property | Description |
|---|---|
| Virtual SOL Reserves | Initial virtual liquidity (typically ~30 SOL) |
| Virtual Token Reserves | Initial token supply in the curve (~1B tokens) |
| Real SOL Reserves | Actual SOL deposited by buyers |
| Real Token Reserves | Remaining tokens available on the curve |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 110 lines · 61 tokens per session scan A 1fb11a7b8bf7
pump-fun-mcp-guide is a skill published in the GitHub repository nirholas/three.ws (111 stars, last pushed today), licensed Apache-2.0. It adds 61 tokens to every session and 981 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
blockchain-defi
Use this skill when asked about decentralized finance, DeFi protocols, AMM mechanics, lending and borrowing protocols, perpetual futures, yield farming, liquidity mining, liquid staking, restaking, yield optimization, DeFi security, MEV, and protocol composability. Covers AMM design (Uniswap, Curve, Balancer), lending…
apex-copilot
Use this skill when the user is working on a Web3 project and needs Apex Foundation diligence tools: scoring a crypto/Web3 project for investment readiness, matching against the Apex portfolio of 200+ projects, finding relevant Web3 hackathons, matching against Web3 VC funds and investors, smart contract code review…
stablecoin-chain-explorer
Explore stablecoin TVL distribution and yield opportunities by blockchain. Query which chains have the most stablecoins, compare cross-chain yields, and find the best opportunities on Ethereum, BSC, Arbitrum, Base, Polygon, and more. Also for protocols and issuers researching where stablecoin TVL and liquidity…
gstd-sovereign
Full agent autonomy — self-sustaining economic entity that earns GSTD, manages finances, shares intelligence, recruits agents, and promotes financial independence.
crypto-report
Analyze cryptocurrency projects with tokenomics, on-chain metrics, and market analysis. Generate comprehensive crypto research reports.
agent-wallet
Operate a non-custodial blockchain wallet on-chain (EVM and Bitcoin), no exchange or MetaMask. Create or import a wallet, balances, send native/ERC-20/BTC, swap tokens, compile/deploy/call Solidity. Trigger on wallet, crypto, ETH, BTC, ERC-20, token, send, transfer, swap, trade, Solidity, contract, on-chain, testnet…