mcp server

three.ws pump.fun MCP

Free, read-only pump.fun and Solana token discovery and on-chain analysis tools, by three.ws.

Description as published by the maintainer. Source

• version 1.0.0
• active

active — Registry entry last updated 2026-06-13.

What this server can do

19 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

get_bonding_curve(mint, network)

Bonding curve analysis: real reserves, virtual reserves, and graduation progress (on-chain). Pre-graduation only: these reserves come from the pump program bonding-curve account, not from a PumpSwap pool. Pump renamed the quote-side fields on-chain (real_sol_reserves -> real_quote_reserves, virtual_sol_reserves -> virtual_quote_reserves) once a non-SOL quote asset became possible; the response keys below keep their original names and are still denominated in SOL, because the curve quote_mint is the SOL default on every coin created to date. Once complete=true the curve is retired and pricing moves to the PumpSwap pool, so use pumpfun_quote_swap from that point on. Required: mint.

get_coin_intel(mint, network)

Full Coin Intelligence snapshot for a pump.fun mint. Returns every signal the engine recorded during the observation window: bundle vs organic verdict, bubblemaps-style cluster connectivity, smart-money presence (with wallet labels and win-rates), dev behaviour, category/classification, news-meme detection with the matching headline, risk flags, and a 0–100 quality score. Also returns the outcome if the coin is old enough to be labeled (graduated/rugged/ATH multiple). This is the single highest-signal read for a trade decision — call this before entering any position. Required: mint.

get_oracle_conviction(mint, network)

Oracle conviction score for a pump.fun mint: the fused 0-100 score the Oracle engine produces by combining four intelligence pillars: pedigree (who bought it), structure (organic vs bundle, holder concentration, bubblemaps connectivity), narrative (category, meme virality, news hook), and momentum (timing, velocity). Returns the tier (prime ≥86 / strong ≥72 / lean ≥54 / watch ≥36 / avoid), the per-pillar breakdown, the natural-language reasons that drove the score, the full "who's in" trader roster with reputation labels and win-rates, and the narrative read (category, virality, tags). Call this when you need the highest-confidence trade signal; it synthesises everything get_coin_intel exposes into one actionable score. Pairs with get_coin_intel for raw signals. Required: mint.

get_token_details(mint)

Full details for a specific pump.fun token by mint address. Required: mint.

get_token_holders(mint, limit, network)

Top holders of a token with concentration analysis (on-chain). Required: mint.

get_token_trades(mint, limit)

Recent buy/sell history for a token. Required: mint.

kol_leaderboard(limit, window)

Top KOL traders ranked by P&L for a given time window. Returns wallet, pnlUsd, winRate, trades, rank.

pumpfun_bot_status

Returns the configuration and health status of the pump.fun indexer backend. Always available — does not require PUMPFUN_BOT_URL.

pumpfun_first_claims(limit, sinceMinutes)

First-ever pump.fun creator fee claims in a time window: a cash-out signal. Returns creators who have never claimed before, with creator wallet, mint, lamports, and timestamp.

pumpfun_list_claims(limit, creator, network)

List recent pump.fun fee-claim events for a creator wallet (on-chain, no indexer needed). Returns signature, mint, lamports, and Unix timestamp for each claim. Required: creator.

pumpfun_quote_swap(network, amountIn, inputMint, outputMint, slippageBps)

Read-only price quote for a pump.fun AMM (PumpSwap) swap. No signing or tx sending. One of inputMint/outputMint must be wSOL (So11111111111111111111111111111111111111112). Only GRADUATED coins have an AMM pool; for a coin still on its bonding curve use get_bonding_curve instead. Pricing runs on the pool effective quote reserves (quote vault balance + pool.virtual_quote_reserves); the base side is the raw base vault balance. Returns amountOut, priceImpactBps, route, expiresAtMs, plus the reserves the quote was computed from so the number can be reproduced. Required: inputMint, outputMint, amountIn.

pumpfun_upload_metadata(name, symbol, twitter, website, telegram, image_url, description)

Upload coin metadata (name, symbol, description, image) to IPFS and get back a pump.fun-ready metadata URI. Call this before launching a coin — pass the returned uri to the launch-agent endpoint or the studio launch flow. Requires a valid bearer token (API key). Image may be a public HTTPS URL or a base64 data URI (max 10 MB). The returned uri is a permanent ipfs:// link; the call is idempotent for the same content. Required: name, symbol, description, image_url.

pumpfun_vanity_mint(prefix, suffix, maxAttempts, caseSensitive)

Generate a Solana keypair whose address ends/starts with a vanity pattern. Returns publicKey + secretKey (base58). Caller must save the secret key immediately — it is never stored. Hard timeout: 60 s.

pumpfun_watch_claims(creator, network, durationMs)

Return all pump.fun fee-claim events for a creator wallet within a look-back window (durationMs). Useful for batch collection after a delay. Required: creator.

pumpfun_watch_whales(mint, minUsd, durationMs)

Collect whale trades on a pump.fun token for a short window (max 10 s). Returns all trades whose USD value meets minUsd. Required: mint.

sns_resolve(name)

Resolve a .sol Solana Name Service domain to its owner wallet address. Required: name.

sns_reverseLookup(address)

Reverse-lookup a Solana wallet address to its primary .sol domain name. Required: address.

social_cashtag_sentiment(posts)

Score social-post sentiment for a cashtag using a deterministic lexicon. Returns score (-1..1), positive/negative/neutral percentages, and example posts. Required: posts.

social_x_post_impact(mint, network, postUrl, windowMin)

Correlate an X (Twitter) post to a memecoin price impact. Fetches post metadata via oEmbed (no API key) and computes price delta from the pump.fun bonding curve in a ±windowMin window around the post. Required: postUrl, mint.

Last successful function declaration observed on 2026-08-13. Source: https://three.ws/api/pump-fun-mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://three.ws/api/pump-fun-mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/nirholas/three.ws
• Website — https://three.ws
• Remote endpoint (streamable-http) — https://three.ws/api/pump-fun-mcp

Also from nirholas

• three.ws 3D Agent Tools
  MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.
• 3D AI Agent Avatar
  3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.
• UCAI
  UCAI — The ABI-to-MCP Server Generator. Convert any smart contract ABI into an AI-ready MCP server.
• three.ws Activity
  Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.
• three.ws AgenC
  Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.
• Agent Sniper
  Self-custodial pump.fun sniper: arm strategies, snipe, manage positions. Simulate by default.
• three.ws Agent Payments
  Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.
• three.ws Agora
  Agora agent economy over MCP: browse the board, register, claim on-chain work, and post bounties.
• three.ws Alerts
  Create, update, and delete pump.fun alert rules and read fired-alert history across channels.
• Alibaba Cloud DashScope — Qwen
  Alibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account.