pump.fun Solana Data

@three-ws/pumpfun-mcp

無料の読み取り専用 pump.fun + Solana MCP サーバー — トークンの発見、オンチェーン分析、ライブ 3D スナップショットを提供します。API キーは不要です。

インストール · クイックスタート · ツール · 設定 · three.ws

---

pump.fun と Solana に対応した、無料の読み取り専用 Model Context Protocol サーバーです。Claude やその他の MCP クライアントに、トークンのリアルタイム検索、オンチェーンのボンディングカーブと保有者の分析、クリエイターの手数料請求状況の追跡、Solana Name Service の名前解決、KOL シグナル、読み取り専用のスワップ見積もり、共有可能なライブ 3D トークンスナップショットを提供します。Solana RPC と pump.fun API のすべての呼び出しは、正規の three.ws バックエンドでサーバー側から実行されます。そのため、クライアントは設定不要のまま、データはリアルタイムのオンチェーンデータです。API キーも、RPC URL も、ウォレットも不要です。

インストール

Claude Code（ワンライナー）

claude mcp add pumpfun -- npx -y @three-ws/pumpfun-mcp

Claude Desktop / Cursor / 任意の MCP クライアント

MCP 設定（claude_desktop_config.json、.cursor/mcp.json、.mcp.json など）に追加します。

{
	"mcpServers": {
		"pumpfun": {
			"command": "npx",
			"args": ["-y", "@three-ws/pumpfun-mcp"]
		}
	}
}

クライアントを再起動すると、pump.fun ツールが表示されます。インストール手順は不要です。

直接実行

npx -y @three-ws/pumpfun-mcp
# or install globally and run the bin
npm i -g @three-ws/pumpfun-mcp && pumpfun-mcp

クイックスタート

サーバーは stdio JSON-RPC で通信します。MCP クライアントが上記の npx コマンドを使って起動します。設定後は、クライアントに自然言語で質問すると、適切なツールが選択されます。

"What's trending on pump.fun right now?"        → get_trending_tokens
"Show the bonding curve for <mint>"             → get_bonding_curve
"Who are the top holders of <mint>?"            → get_token_holders
"Resolve bonfida.sol"                           → sns_resolve
"Build a 3D snapshot for <mint>"                → pumpfun_token_3d

ツール

すべてのツールは読み取り専用です。トランザクションへの署名や送信は一切行いません。pumpfun_quote_swap は見積もりのみを行い、pumpfun_vanity_mint はご自身で使用するキーペアを返します。

6 つのツールはインデクサーが必要です。 search_tokens、get_trending_tokens、get_new_tokens、get_graduated_tokens、get_king_of_the_hill、get_creator_profile には pump.fun インデクサー（PUMPFUN_BOT_URL）が必要です。ホスト型エンドポイント three.ws/api/pump-fun-mcp にはインデクサーが設定されていないため、これら 6 つは tools/list から除外され、接続しても表示されません。独自のデプロイで環境変数を設定すれば、コードを変更せずにこれらのツールが利用可能になります。get_token_trades を含むその他の機能は、インデクサーなしでオンチェーンデータを利用します。pumpfun_bot_status を呼び出すと、現在の状態を確認できます。インデクサーがない場合、get_token_details が返すのは SPL アカウントの情報のみであり、name、symbol、uri は null になります。

ホスト型エンドポイントでは、以下の表に記載されていない 3 つのツールも提供しています。get_coin_intel、get_oracle_conviction、pumpfun_upload_metadata。

ツール	機能
search_tokens	名前、シンボル、またはミントアドレスで pump.fun のトークンを検索します。
get_token_details	ミントアドレスの詳細なメタデータを取得します。
get_bonding_curve	ボンディングカーブ上にあるコインの実際／仮想のクォート準備金と、卒業までの進捗状況をオンチェーンで取得します。カーブを空にする v3 の購入は、合成的な移行を通じて完了します。
get_token_trades	トークンの最近の購入／売却履歴を取得します。
get_trending_tokens	時価総額上位のトークンを取得します。
get_new_tokens	最も最近ローンチされたトークンを取得します。
get_graduated_tokens	PumpSwap プールへ卒業したトークンを取得します。
get_king_of_the_hill	ボンディングカーブ上にあるトークンのうち、時価総額が最も高いものを取得します。
get_token_holders	保有集中度の分析を含む、上位保有者の情報をオンチェーンで取得します。
get_creator_profile	ラグプルのリスクフラグを含む、クリエイターのトークンを取得します。
kol_leaderboard	24 時間／7 日／30 日の期間で、損益順にランキングした上位 KOL トレーダーを取得します。
pumpfun_list_claims	最近のクリエイター手数料請求イベントをオンチェーンで取得します。v3 カーブ／v2 プールでの取引手数料は、スイープ後に表示されます。
pumpfun_watch_claims	過去の指定期間における、クリエイターの手数料請求を取得します。
pumpfun_first_claims	クリエイターによる初回の手数料請求を取得します。現金化のシグナルとなります。
pumpfun_quote_swap	卒業済みコインの PumpSwap AMM スワップ見積もりを読み取り専用で取得します（署名は不要）。価格はボールトと符号付き（多くの場合、負の値）の virtual_quote_reserves に基づきます。
pumpfun_watch_whales	短期間における、トークンの大口取引を収集します。
pumpfun_vanity_mint	カスタム Solana キーペアを生成します（秘密鍵は呼び出し元に返され、保存されません）。
sns_resolve	.sol ドメインを所有者のウォレットに解決します。
sns_reverseLookup	ウォレットからプライマリ .sol ドメインを逆引きします。
social_cashtag_sentiment	指定された投稿に対し、決定論的な語彙ベースのセンチメント分析を行います。
social_x_post_impact	X の投稿とボンディングカーブの価格変動を相関分析します。
pumpfun_bot_status	pump.fun インデクサーバックエンドの設定と健全性を取得します。configured、healthy、および ping 遅延を確認できます。常に利用可能です。
pumpfun_token_3d	トークンのライブ 3D スナップショットを作成します。メタデータ、保有者、卒業状況を組み合わせ、共有可能な three.ws/coin3d ビューアー（回転するコインメダリオン＋保有者銀河＋卒業リング）を生成し、ディープリンク、埋め込み用 iframe、基礎データを返します。
ライブツール一覧は起動時にバックエンドから取得されます。オフライン時のフォールバックとしてコピーが同梱されているため、新規インストールでも常に正確な機能を提示できます。

価格の算出方法

pump.fun のコインには、2 つの異なるオンチェーンアカウントによって価格が決まる、2 つのライフサイクルがあります。ここにある各ツールは、どちらか一方だけに属しています。誤ったアカウントから数値を読み取ると、自信たっぷりに間違った回答をしてしまうことがよくあります。

卒業前：pump プログラムの BondingCurve アカウント。 現物価格は virtual_quote_reserves / virtual_token_reserves です。SOL 以外のクォート資産が利用可能になった際、クォート側のこれらのフィールドは上流で名前が変更されました（virtual_sol_reserves → virtual_quote_reserves、real_sol_reserves → real_quote_reserves）。また、カーブに quote_mint が追加されました。これまでに作成されたすべてのコインでは、既定値は SOL です。名前の変更は同じオフセットにある同じ u64 を指すため、レスポンスフィールド virtualSolReserves / solReserves は名前を維持し、SOL 建てのままです。get_bonding_curve と social_x_post_impact が提供します。

卒業後：PumpSwap（pump_amm）の Pool アカウント。 見積もりでは、実効クォートリザーブを基準に価格を算出します。

effective_quote_reserves = pool_quote_token_account.amount + pool.virtual_quote_reserves

pool.virtual_quote_reserves は、Pool に追加されたフィールドで、符号付きの i128 です。正の値は、ボールト外に保持されている深度を加算します。2026-09-30 以降、この値は一般的に負になります。PumpSwap v2 の取引（buy_v2、sell_v2、buy_exact_quote_in_v2）および multi_hop_swap は、スイープによって払い出されるまでプロトコル手数料とクリエイター手数料をクォートボールト内に保持し、その金額をここから差し引くため、未払いの手数料が流動性として数えられることはありません。そのため、quote_reserve だけでは深度が過大評価され、effective_quote_reserve はそれを下回る場合があります。プログラムにより、その合計が負にならないことが保証されています。このフィールドは符号付き整数として読み取ってください。符号なしとして扱ったり、0 に切り詰めたり、絶対値に変換したりしてはいけません。このフィールドが存在する前に作成されたプールでは、値は 0 として読み取られます。買いと売りのどちらも実効値を基準に価格が算出され、priceImpactBps はそこから導かれる現物価格に対する約定を測定するため、仮想流動性は価格インパクトではなく深度として反映されます。ベース側に変更はなく、引き続き生の pool_base_token_account.amount が使われます。pumpfun_quote_swap が提供します。

2 つの virtual_quote_reserves は、名前が同じだけで、異なるアカウント上の異なるフィールドです。コインが持つのはどちらか一方だけで、両方を持つことはありません。get_bonding_curve が complete: true を返したら、カーブの読み取りを止め、プールを使って見積もってください。

引き継ぎ：合成移行。 カーブを空にする v3 ボンディングカーブ購入（buy_v3、buy_exact_quote_in_v3）には最大サイズがありません。カーブに残っている分をカーブ価格で購入してカーブを完了させた後、PumpSwap プールで開始する価格で残りを購入します。そのため、大規模な最終購入が realTokenReserves によって制限されることはありません。Mayhem コインは対象外です。この購入後、移行が完了するまでカーブ取引はすべて失敗します。オフチェーンでの見積もりには、fetchBuyState の curveBaseTokenBalance と、@pump-fun/pump-sdk 4.0.0 の getBuyV3QuoteAmountFromTokenAmount / getBuyV3TokenAmountFromQuoteAmount を使用します。

クリエイター手数料はスイープされるまで保留されます。 v3 カーブ取引と v2 プール取引では、取引ごとにクリエイター手数料は支払われません。sweep_creator_fee によって手数料がクリエイターボールトに移されるまで、カーブ（BondingCurve.creator_fee）とプール（Pool.creator_fees）に保留されます。通常、同じトランザクション内で請求の直前にスイープされます。請求ツールが報告するのは請求済みの金額であるため、カーブまたはプールでスイープ待ちの手数料は、スイープされるまでどの請求にも含まれません。

上流の参考資料：pump-public-docs、特に NEGATIVE_VIRTUAL_QUOTE_RESERVES.md、SYNTHETIC_MIGRATION.md、instructions/SWEEP_FEES.md を参照してください。

ツールを確認する

npx -y @modelcontextprotocol/inspector npx @three-ws/pumpfun-mcp

使用例

実行可能な使用例はexamples/にあります。

node examples/list-tools.mjs     # every tool the backend currently serves, with schemas
node examples/token-report.mjs   # live on-chain report for one mint

どちらもこのサーバーをstdio経由で起動し、Solanaメインネットのライブデータを読み取ります。ここにあるすべてのツールは無料で、読み取り専用です。インデクサーがバックエンドに設定されているかどうかによって、案内されているツール数が変わる理由など、期待される出力についてはexamples/README.mdをご覧ください。

設定

設定は不要です。任意で指定できる上書き項目が1つあります。

環境変数	デフォルト	用途
PUMPFUN_MCP_URL	https://three.ws/api/pump-fun-mcp	バックエンドのエンドポイントです。ハンドラーをセルフホストする場合にのみ上書きしてください。

仕組み

このパッケージは、シンプルなstdio ↔ HTTPブリッジです。MCPのtools/callリクエストを、正規のthree.ws pump.fun JSON-RPCバックエンドに転送します。バックエンドが実際のSolana RPC読み取りとpump.fun APIクエリを実行します。これにより、信頼できる実装を一元化し、クライアントにシークレットを送信せず、ツールの提供内容を自動的に最新の状態に保てます。

pumpfun_token_3dはネイティブツールです。プロセス内で複数のバックエンド読み取り（メタデータ＋ボンディングカーブ＋ホルダー）をオーケストレーションし、オンチェーンメタデータURIからトークンのロゴを解決して、three.wsの3Dビューアーへのディープリンクを返します。追加のキーは不要で、新たなバックエンド依存関係も追加されません。

エラー

失敗時には、実際の原因を示すMCPツールエラー（isError: true）が返されます。空の結果が黙って返されることはありません。

エラーテキスト	意味	対処方法
Backend request failed: …	ブリッジがバックエンドに接続できませんでした（ネットワーク、非2xx、無効なJSON）。	接続状態とPUMPFUN_MCP_URLを確認してください。安全に再試行できます。
[-32602] …	無効な引数です（例：mintを指定せずにpumpfun_token_3dを呼び出した場合）。	メッセージで示された引数を修正してください。
[-32004] no on-chain data for <mint>: …	pumpfun_token_3dで、そのmintのメタデータ、カーブ、またはホルダーデータが見つかりませんでした。	mintアドレスとネットワーク（mainnet／devnet）を確認してください。
[<code>] <message>	その他のバックエンドJSON-RPCエラー（不明なツール、インデクサーが利用不可、オンチェーン読み取りの失敗など）がそのまま渡されます。	メッセージに上流で発生した原因が示されます。一時的なインデクサーエラーは安全に再試行できます。

pumpfun_token_3dは、問題があっても可能な限り処理を続行します。3つのデータソース読み取りのうち一部のみ成功した場合でも、欠落部分（no holder data available、no bonding-curve data available）を示したスナップショットを返します。3つすべてが失敗した場合にのみエラーになります。

要件

• Node.js >= 20（enginesに基づきます）。
• APIキー、RPC URL、ウォレットは不要です。three.wsバックエンド（またはPUMPFUN_MCP_URL）へのアウトバウンドHTTPS通信が必要です。

関連項目

• @three-ws/mcp-server — 有料のx402決済対応three.ws MCP（テキスト→3Dメッシュ、アバター、ポーズシード、ERC-8004レピュテーション、および有料のpump_snapshot）。

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• Issues：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。LICENSEをご覧ください。

---

_{3D AIエージェント、オンチェーンID、エージェント決済を提供するthree.ws SDKスイートの一部です。
ウェブサイト · 変更履歴 · GitHub}