graph-polymarket-mcp

graph-polymarket-mcp

MCP Registry に io.github.PaulieB14/graph-polymarket-mcp として公開されています。

前提条件

無料の Graph API キーが必要です（所要時間は約 2 分です）。

1. The Graph Studio にアクセスします
2. ウォレット（MetaMask、WalletConnect など）を接続します
3. サイドバーの 「API Keys」 をクリックし、キーを作成します
4. 無料プランには、月 100,000 回のクエリが含まれます

インストール

npm install -g graph-polymarket-mcp

または、npx を使って直接実行します。

npx graph-polymarket-mcp

設定

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "graph-polymarket": {
      "command": "npx",
      "args": ["-y", "graph-polymarket-mcp"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add graph-polymarket -- npx -y graph-polymarket-mcp

実行前に環境変数 GRAPH_API_KEY を設定してください。

Cursor / その他の MCP クライアント

npx graph-polymarket-mcp をコマンドとして指定し、環境変数として GRAPH_API_KEY を渡して、stdio トランスポートを使用します。

OpenClaw / リモートエージェント（SSE）

SSE トランスポートには認証がありません。 ポートに接続できる人は誰でもすべてのツールを呼び出せ、 その呼び出しによって あなたの GRAPH_API_KEY のクォータが消費されます。--http はコンテナ内で 0.0.0.0 にバインドするため、ホスト側では 127.0.0.1 に公開し、コンテナ外から到達可能なエンドポイントの 前段に、TLS と認証を備えたリバースプロキシを配置してください。ローカルエージェントでは、ネットワークに 一切公開されないデフォルトの stdio トランスポートを優先してください。

HTTP トランスポートを使ってサーバーを起動します。

# Dual transport — stdio + SSE on port 3851
GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http

# SSE only (for remote/server deployments)
GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http-only

# Custom port
MCP_HTTP_PORT=4000 GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http

次に、エージェントの接続先として SSE エンドポイントを指定します。

{
  "mcpServers": {
    "graph-polymarket": {
      "url": "http://localhost:3851/sse"
    }
  }
}

トランスポートモード

呼び出し方法	トランスポート	用途
npx graph-polymarket-mcp	stdio	Claude Desktop、Cursor、Claude Code
npx graph-polymarket-mcp --http	stdio + SSE :3851	デュアル — ローカルおよびリモートエージェント
npx graph-polymarket-mcp --http-only	SSE :3851	OpenClaw、リモートデプロイ

HTTP トランスポートが有効な場合、http://localhost:3851/health で /health エンドポイントを利用できます。

利用可能なツール

コアツール

ツール	説明
list_subgraphs	利用可能なすべての Polymarket サブグラフを、説明と主要なエンティティとともに一覧表示します
get_subgraph_schema	特定のサブグラフの GraphQL スキーマ全体を取得します
query_subgraph	任意のサブグラフに対してカスタム GraphQL クエリを実行します

ドメイン固有ツール

ツール	説明	サブグラフ
get_market_data	結果と解決ステータスを含む市場／条件データを取得します	Main
get_global_stats	プラットフォームの統計情報（市場数と実際の取引量／手数料／取引数）を取得します	Main + Orderbook
get_account_pnl	トレーダーの損益（P&L）とパフォーマンス指標（winRate、profitFactor、maxDrawdown）を取得します	Beefy P&L
get_top_traders	PnL、winRate、取引量、profitFactorで順位付けしたリーダーボードです。Orderbookと照合し、OBの取引量がBeefyで追跡されている取引量を上回る行にフラグを付け、リーダーボードに存在しないOBのみのトレーダーを表示します。	Beefy P&L + Orderbook
get_daily_stats	日次の取引量、手数料、トレーダー数、市場活動（1～90日）を取得します	Beefy P&L
get_market_positions	特定の結果トークンの上位保有者とその損益（P&L）を取得します	Beefy P&L
get_user_positions	現在のトークンポジションを取得します。Orderbookと照合し、totalBought=0 でもOBの取引量がある場合は ⚠ orderbook-only entry に、OBの取引量が分割担保の2倍を超える場合は ⚠ mixed entry にフラグを付けます。	Slimmed P&L + Orderbook
get_recent_activity	スプリット、マージ、償還とオーダーブックの約定を時系列で統合したフィードを取得します。アドレスによる任意のフィルターに対応しています。	Activity + Orderbook
get_orderbook_trades	メイカー／テイカーで絞り込んだ最近の注文約定を取得します	Orderbook
get_market_open_interest	未決済ポジションにロックされたUSDCの額で順位付けした上位市場を取得します。Mainサブグラフと照合し、解決済み市場の ⚠ dead money OI（オンチェーンで償還されることのない敗者側トークン）にフラグを付けます。	Open Interest + Main
get_oi_history	特定市場の時間単位のOIスナップショットを取得します（推移のグラフ化用）	Open Interest
get_global_open_interest	プラットフォーム全体の未決済建玉の合計と市場数を取得します	Open Interest
get_market_resolution	UMAオラクルの解決ステータスを取得します。ステータスで絞り込めます	Resolution
get_disputed_markets	オラクルによる解決中に異議申し立てを受けた市場（重要度の高いイベント）を取得します	Resolution
get_market_revisions	市場の解決に関するモデレーターの介入と更新を取得します	Resolution
get_trader_profile	CTFイベントとUSDCフローをOrderbookの約定と組み合わせた、トレーダーの完全なプロフィールを取得します。ウォレットをハイブリッド／オーダーブックのみ／分割担保のみとして分類し、P&Lサブグラフの信頼性が低い場合は警告します。	Traders + Orderbook
get_trader_usdc_flows	入出金の方向で絞り込めるUSDCの入出金履歴を取得します	Traders

Polymarket REST APIツール（Graph APIキー不要）

ツール	説明	API
search_markets	フィルター（アクティブ、終了、取引量／流動性による並べ替え）を指定して、テキストクエリで市場を検索します	Gamma
get_market_info	スラッグまたは条件IDで市場の詳細なメタデータを取得します	Gamma
list_polymarket_events	タグ／ステータスで絞り込んで、関連市場のグループであるイベントを閲覧します	Gamma
get_polymarket_event	関連するすべての市場を含む単一のイベントを取得します	Gamma
get_live_prices	結果トークンのリアルタイムCLOB価格（買い／売り、単一または一括）を取得します	CLOB
get_live_spread	市場の流動性を評価するための買値と売値のスプレッドおよび中間値を取得します	CLOB
get_live_orderbook	トークンの全注文板（未約定の買い注文と売り注文すべて）を取得します	CLOB
get_price_history	過去の価格時系列（1分から最大間隔まで、精度を設定可能）を取得します	CLOB
get_last_trade	結果トークンの最終取引価格を取得します	CLOB
get_clob_market	CLOB市場の詳細（トークンID、リアルタイム価格、最小注文サイズ／ティックサイズ）を取得します	CLOB
search_markets_enriched	強力なツール：市場を検索し、1回の呼び出しでリアルタイムCLOB価格とオンチェーン解決ステータスを自動的に追加します	Gamma + CLOB + Graph

CLOB V2 ツール

Polymarket は 2026-04-28 に V2 取引所コントラクトへ移行しました。これらのツールはブロック 84902353 からインデックス化される V2 サブグラフを読み取ります。サブグラフには移行前の履歴がありません。V1 と V2 は、旧版と新版ではなく、異なる時代です。

ツール	説明	サブグラフ
get_builder_leaderboard	ルーティングされた取引量、注文数、手数料で V2 ビルダーを順位付けし、各ビルダーの V2 取引量に対するシェアも表示します。V1 には相当するものがありません。V1 コントラクトはビルダーコードを一度も出力しませんでした	V2 Orderbook
get_builder_activity	1 つのビルダーコードによってルーティングされた最近の約定と、そのビルダーの集計値を表示します	V2 Orderbook
get_v2_top_traders	取引所コントラクトを除外した、実際の V2 トレーダーの上位を表示します	V2 Orderbook
check_subgraph_freshness	任意のサブグラフがチェーンヘッドからどれだけ遅れているかを、_meta ブロックからリアルタイムで読み取ります	任意

ビルダーのアトリビューションは、V2 で追加された機能です。すべての V2 約定には、その取引をルーティングしたフロントエンド、ボット、またはインテグレーターの builder コードが含まれます。そのため、「実際にこのフローをルーティングしているのは誰か」という問いに答えられるようになります。2026-08-08 時点で、ビルダーは 3,325 件です。

これらのツールが対処する 2 つの落とし穴。 注文がマッチした際、取引所が taker になるため、V2 取引所コントラクトは Account 行として表示されます。アカウントを単純に順位付けすると、0xe111…996b（1 億 7,600 万件の約定）と 0xe222…0f59（4,100 万件の約定）が、すべての人間のトレーダーより上位に表示されます。get_v2_top_traders はこれらを除外します。check_subgraph_freshness は、数値を信頼する前に、任意のサブグラフのヘッドブロックを報告します。

データソース

The Graph サブグラフ（GRAPH_API_KEY が必要）

オンチェーンのインデックス済みデータです。履歴分析、損益、未決済建玉、解決状況の確認において信頼できるデータです。

サブグラフ

CLOB V2 — プライマリ（ブロック 84902353 以降）

名前	IPFS ハッシュ	状態	説明
V2 Main	QmTKrqyYg23BjhihmsrRjbV9cVS2piNmnHsr7cjYaTgdWu	チェーンヘッドまで同期済み	条件、解決状況、カウンター（市場ツールのデフォルト）
V2 Orderbook	QmNtJGxpAjFgoHhMwdijyvbLrpPPiHHX2qct56nTpk42Bs	チェーンヘッドまで同期済み	ビルダーコードのアトリビューション付き V2 約定
V2 P&L	QmT21E4p8r6FCzW2EPK4NVj1dbcggdvKxZr8uuMcB4P5Cu	チェーンヘッドまで同期済み	V2 約定のみを対象とする取得原価と実現損益
Open Interest V2	QmbT2MmS2VGbGihiTUmWk6GMc2QYqoT9ZhiupUicYMWt6H	⚠️ インデクサー未割り当て（2026-10-15）	市場ごとおよび全体の未決済建玉と時間単位のスナップショット

状態は 2026-10-15 に _meta を使って確認しました。

V1 — レガシー（2026-04-28 の移行前の履歴）

名前	IPFS ハッシュ	説明
Main (legacy)	QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a	移行前を含む全期間の条件。subgraph: "main" を渡してください
Beefy P&L	QmbHwcGkumWdyTK2jYWXV3vX4WyinftEGbuwi7hDkhPWqG	包括的な損益トラッキング
Slimmed P&L	QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9ibTiTtwQU	最小限のポジションデータ
Activity	Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP	ポジション管理イベント
Orderbook	QmVGA9vvNZtEquVzDpw8wnTFDxVjB6mavTRMTrKuUBhi4t	注文の約定分析（全期間の取引量）
Resolution	QmZnnrHWCB1Mb8dxxXDxfComjNdaGyRC66W8derjn3XDPg	UMA オラクルの解決ライフサイクル
Traders	QmfT4YQwFfAi77hrC2JH3JiPF7C4nEn27UQRGNpSpUupqn	トレーダーごとのイベントログと USDC フロー

Open Interest はすでに V2 のデプロイです。ConditionalTokens を読み取りますが、これは V2 でも変更されていないため、移行による不連続はありません。

どちらの時代について尋ねるかは、次のとおりです。全期間または 2026-04-28 より前 → V1。 移行後のアクティビティ、またはビルダーに関する内容 → V2。beefy_pnl には、V2 P&L にはないヘッジファンド指標（winRate、profitFactor、maxDrawdown、日次系列）が含まれているため、トレーダーの質の評価には引き続き V1 を使います。

クエリ例

接続すると、AI エージェントは次のことができます。

市場の検索（Gamma API）

• 「AI に関する予測市場を検索して」
• 「現在、Polymarket で最も活発なイベントを表示して」
• 「2024 年の選挙に関する市場を取引量順に検索して」
• 「『crypto』カテゴリにはどの市場がありますか？」

ライブ取引データ（CLOB API）

• 「Trump YES トークンの現在価格はいくらですか？」
• 「この市場の注文板全体を表示してください」
• 「このトークンのビッド・アスクスプレッドはいくらですか？」
• 「この市場の過去 1 週間の価格履歴を表示してください」

オンチェーン分析（The Graph）

• 「Polymarket の現在の全体統計を教えてください」
• 「最新の注文板取引を 20 件表示してください」
• 「アドレス 0x... のポジションを教えてください」（ウォレットが OB の買いのみでエントリーした場合にフラグを立てます）
• 「トレーダー 0x... の損益を取得してください」
• 「現在、オープンインタレストが最も多い市場はどれですか？」（解決済み市場のロックされた資金を含む OI にフラグを立てます）
• 「Polymarket の係争中の市場を表示してください」
• 「トップトレーダーは誰ですか？」（Beefy の損益に反映されていない OB 取引量があるトレーダーにフラグを立てます）
• 「ウォレット 0x... の取引履歴全体を表示してください」（OB の約定とエントリー種別の分類を含みます）

開発

git clone https://github.com/PaulieB14/graph-polymarket-mcp.git
cd graph-polymarket-mcp
npm install
npm run build
GRAPH_API_KEY=your-key node build/index.js

ライセンス

MIT