polymarket-mcp

Polymarket MCP

AI エージェントに読み取り専用の Polymarket 予測市場データを提供する MCP サーバーです。ツールは Polymarket の公開 Gamma（市場の検索）API と Data（ポジション、ポートフォリオ、ランキング）API をラップします。CLOB との統合はありません。このサーバーでは取引の実行や注文板の閲覧はできません。

ツール

ツール	説明
search_markets	タイトルまたは説明文で市場を検索します
get_market_details	1 つの市場の詳細（スラッグまたは Polymarket の URL を指定）
get_trending_markets	出来高、流動性、または競争度順に並べたトレンドイベント
get_market_holders	市場のアウトカムごとの上位保有者（condition ID、スラッグ、または URL を指定）
get_leaderboard	損益または出来高順に並べた上位トレーダー
get_user_positions	ウォレットアドレスのオープンポジション
get_user_performance	1 つのウォレットのポートフォリオ価値、損益、出来高、ランキング順位

すべてのツールは、エージェントが利用しやすい Markdown 形式で結果を返します。API キーやウォレット署名は不要です。

リソース

静的なリファレンス情報（API 呼び出しなし）。MCP クライアントに添付するか、Inspector から読み取れます。

URI	説明
polymarket://glossary	イベント、市場、スラッグ、conditionId、ウォレットに関する用語
polymarket://categories	ランキングのカテゴリ、期間、タグのスラッグ
polymarket://tool-guide	各ツールを使う場面と、ツールを連携させるワークフロー

プロンプト

ツールを連携させる、ユーザーが起動するワークフローテンプレートです。

プロンプト	説明
research_market	市場の詳細 → 保有者 → 調査の要約（slug または market_link）
compare_traders	2 つのウォレットのパフォーマンスとポジションを並べて比較します
scan_trending	トレンドイベントをスキャンします。tag_slug と limit は任意です

要件

• Python 3.12+
• uv（推奨）または Docker
• Node.js（任意。MCP Inspector を使う場合のみ）

クイックスタート

このサーバーは http://127.0.0.1:8000/mcp で streamable HTTP を使用します。まずサーバーを起動してから、MCP クライアントをその URL に接続してください。

git clone https://github.com/0xChron/polymarket-mcp.git
cd polymarket-mcp
uv sync
uv run polymarket-mcp

Windows では、PowerShell、コマンドプロンプト、または Git Bash で同じコマンドを使用してください。MCP クライアントの接続中は、ターミナルを開いたままにしてください。

Docker

Docker Desktop がインストールされていれば、すべてのプラットフォームで同じように動作します。

git clone https://github.com/0xChron/polymarket-mcp.git
cd polymarket-mcp
docker build -t polymarket-mcp .
docker run --rm -p 8000:8000 -e FASTMCP_HOST=0.0.0.0 polymarket-mcp

FASTMCP_HOST=0.0.0.0 を設定すると、サーバーはコンテナ外部からの接続を受け入れます。

サーバーの確認

別のターミナルで MCP Inspector を開きます。

npx -y @modelcontextprotocol/inspector

Streamable HTTP トランスポートを使用して http://localhost:8000/mcp に接続します。

MCP クライアントから接続する

このサーバーは streamable-http トランスポートを使用します（stdio ではありません）。まずサーバーを起動して（クイックスタートを参照）、以下の設定を MCP クライアントに追加してください。

Claude Desktop

Claude → Settings → Developer → Edit Config に移動して claude_desktop_config.json を開き、以下を追加します。

{
  "mcpServers": {
    "polymarket": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

ほかの MCP サーバーをすでに設定している場合は、ファイル全体を置き換えるのではなく、既存の mcpServers オブジェクト内に "polymarket" エントリを追加してください。

手動で編集する場合の設定ファイルの場所は次のとおりです。

プラットフォーム	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

ファイルを保存したら、Claude Desktop を完全に終了して再起動してください。新しいチャットを開始する前に、ターミナルでサーバーを起動しておく必要があります。

Cursor

Settings → Tools & MCP → New MCP Server に移動して ~/.cursor/mcp.json（Windows の場合：%USERPROFILE%\.cursor\mcp.json）を開き、同じ polymarket エントリを追加します。

{
  "mcpServers": {
    "polymarket": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

保存後、Cursor を再起動してください。

エージェントのプロンプト例

接続すると、エージェントは自然な言葉でツールを呼び出せます。

• 「Bitcoin ETF に関する開催中の市場を Polymarket で検索して」
• 「現在、人気の市場は何ですか？」
• 「Trump 選挙市場の上位保有者は誰ですか？」
• 「暗号資産トレーダーの全期間 P&L ランキングを表示して」
• 「https://polymarket.com/event/will-bitcoin-hit-100k の詳細を取得して」
• 「ウォレット 0x… の未決済ポジションを表示して」
• 「0x… の全期間 P&L とランキング順位は？」

MCP Inspector では、Prompts タブ（例：research_market）を試すか、用語集とツールガイドを Resources で確認してください。

設定

任意の環境変数で API エンドポイントとサーバー設定を上書きできます。

macOS / Linux / Git Bash

export FASTMCP_HOST=0.0.0.0
export FASTMCP_PORT=8000
uv run polymarket-mcp

Windows（PowerShell）

$env:FASTMCP_HOST = "0.0.0.0"
$env:FASTMCP_PORT = "8000"
uv run polymarket-mcp

変数	デフォルト	説明
GAMMA_URL	https://gamma-api.polymarket.com	Gamma API のベース URL
DATA_URL	https://data-api.polymarket.com	Data API のベース URL
DEFAULT_TIMEOUT	15	HTTP リクエストのタイムアウト（秒）
FASTMCP_HOST	127.0.0.1	バインドアドレス（Docker の場合は 0.0.0.0）
FASTMCP_PORT	8000	リッスンポート

開発

uv run polymarket-mcp          # Start the server
uv run pytest                  # Run tests
npx -y @modelcontextprotocol/inspector   # Open MCP Inspector
docker build -t polymarket-mcp .         # Build Docker image

macOS/Linux では、make run、make test などの Makefile にあるショートカットで、同じコマンドを実行できます。

アーキテクチャ、規約、新しいツールの追加方法については、docs/PROJECT_KNOWLEDGE_BASE.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。