Polymarket MCP

Polymarket MCP

Polymarket 向けの自己完結型 Rust MCP サーバーです。ソースリンク付きの市場概要、公開データの検索、正確な CLOB V2 板情報、ウォレット分析、リアルタイムの市場状態、SQLite による記録と再生、約定シミュレーション、安全策を備えたオプションの取引機能を提供します。

デフォルトの research プロファイルでは、API キーもウォレットも必要ありません。公開データとリアルタイムデータ用の 30 個のツールを公開し、認証が必要な取引ツールは公開せず、呼び出しも受け付けません。別の 11 ツール構成の chatgpt プロファイルは、コンパクトでステートレス、認証情報を参照せず、オプションのインライン市場カードとともに Streamable HTTP で利用できます。

1 分でインストール

macOS または Linux：

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/beejmaxx/polymarket-mcp-rs/main/scripts/install.sh | sh
polymarket-mcp-rs doctor

Windows PowerShell：

irm https://raw.githubusercontent.com/beejmaxx/polymarket-mcp-rs/main/scripts/install.ps1 | iex
polymarket-mcp-rs doctor

または、パッケージマネージャーを使用します：

brew install beejmaxx/tap/polymarket-mcp-rs

scoop bucket add beejmaxx https://github.com/beejmaxx/scoop-bucket
scoop install beejmaxx/polymarket-mcp-rs

次に、クライアントに追加します：

codex mcp add polymarket -- polymarket-mcp-rs
# or
claude mcp add polymarket -- polymarket-mcp-rs

ビルド済みバイナリとワンクリックでインストールできる polymarket-mcp.mcpb バンドルは、すべての GitHub リリースに添付されています。Claude Desktop、VS Code、ソースからのビルド、カスタムデータベースパス、Windows に関する詳細は、インストールガイドを参照してください。

このサーバーを選ぶ理由

• 検証済みの置き換え対象：公開データ、リアルタイムの板情報、調査ワークフロー、オプトインのアカウント操作にわたる 46 個のツールを備え、25 個すべての Python デモツールとのライブ監査を自動実行します。
• 回答にすぐ使えるワークフロー：1 つの市場概要に、メタデータ、実行可能な板情報、履歴、約定インパクト、ソース URL、タイムスタンプ、制限事項をまとめます。ウォレットと、明示的なネガティブリスクイベントの概要では、不要なツールの連続呼び出しを避けられます。
• 正確な数値の取り扱い：小数の金融値と 256 ビット ID は JSON でも文字列として保持されるため、浮動小数点や整数の精度が失われません。
• 状態を保持する市場調査：Rust が再構築した板情報とフィードの状態を内部で管理するため、すべてのティックをモデルに送る必要がありません。
• 誠実な再生機能：SQLite はこのプロセスが取得した観測データを保存し、取りこぼした更新を追跡します。取引所の履歴全体を網羅しているかのように見せることはありません。
• 安全なデフォルト設定：取引ツールはデフォルトで利用できません。ツールを公開するかどうかと、変更操作を有効にするかどうかは別々に決定できます。
• 運用がシンプル：単一バイナリ、stdio またはステートレスな Streamable HTTP、構造化エラー、ヘルスチェックと Prometheus エンドポイント、オフライン／オンラインの doctor、グレースフルシャットダウン、本番環境での日次カナリア、コンテナ、チェックサム、SBOM、リリースの来歴情報を備えています。

便利な最初のプロンプト

アクティブな Polymarket 市場のうち、取引高が最も多い 5 件を見つけてください。それぞれについて、現在のアウトカム価格、流動性、スプレッド、板の不均衡、100 株分の推定スリッページを示してください。データの制限事項を説明し、取引を推奨しないでください。

その他のデモ用プロンプトは docs/DEMO.md にあります。

ツールプロファイル

プロファイル	ツール数	用途
chatgpt	11	ホスト型クライアント向けの、コンパクトでステートレスな公開リサーチ機能
core	20	公開 REST の検索、ブック、ウォレット、回答作成向けの分析、シミュレーション
research (デフォルト)	30	Core にリアルタイム監視とローカルでの記録／再生を追加
trading	36	Core に認証済みアカウント、ユーザーイベントのストリーミング、取引操作を追加
all	46	Research と Trading の機能を統合

--tool-profile research または POLYMARKET_TOOL_PROFILE=research でプロファイルを選択します。非表示のツールは tools/list とディスパッチの両方から除外されます。trading または all を選択しても公開されるのはツール定義のみです。注文の変更には引き続き POLYMARKET_ENABLE_TRADING=true、署名者、ローカル上限、操作ごとの確認が必要です。公開 HTTP で指定できるのは chatgpt または core のみです。また、設計上、認証情報を無視するアプリケーションインスタンスが作成されます。

デフォルトのカタログを確認するには polymarket-mcp-rs tools を実行します。スキーマ全体を確認するには polymarket-mcp-rs --tool-profile all tools --json を実行します。グループ別のリファレンスについては、docs/TOOLS.md を参照してください。

アーキテクチャ

MCP client (stdio or Streamable HTTP)
        |
        v
tool profile + typed MCP schemas
        |
        v
validation and stable output mapping
   |              |                |                 |
Gamma/Data/    CLOB REST      realtime books      SQLite + trading
public APIs    exact books    WebSocket health    replay / audit

マーケット WebSocket エンジンは、監視対象の各トークンを CLOB REST から初期化した後、完全なスナップショットと価格の差分変更を適用します。認証済みプロファイルでは、アカウントの注文イベントと取引イベントを個別に監視できます。接続状態、再接続、ソース別のカウンター、ローカルでの受信時刻、フィードの経過時間、エラー、記録の欠落は、明示的に保持されます。SQLite への書き込みには容量制限付きチャネルと専用の書き込みスレッドを使用します。MCP EOF、SIGINT、または SIGTERM が発生すると、監視を停止する前に進行中の記録がフラッシュされます。

設定

変数	デフォルト	用途
POLYMARKET_TOOL_PROFILE	research	chatgpt、core、research、trading、または all
POLYMARKET_MCP_DB	OS のアプリケーションデータディレクトリ	SQLite の記録および承認監査データベース
POLYMARKET_WS_URL	本番環境のマーケット WebSocket	WebSocket URL 全体を上書き
POLYMARKET_WS_PROXY	未設定	認証なしの socks5://host:port WebSocket プロキシ
HTTPS_PROXY / HTTP_PROXY	環境に依存	HTTP API クライアントが使用するプロキシ
RUST_LOG	info	stderr のログフィルタリング

デフォルトのデータベースは、macOS では ~/Library/Application Support/polymarket-mcp/、Linux では $XDG_DATA_HOME/polymarket-mcp/（または ~/.local/share/polymarket-mcp/）、Windows では %LOCALAPPDATA%\polymarket-mcp\ にあります。POLYMARKET_WS_PROXY が未設定の場合、公開マーケット WebSocket では ALL_PROXY=socks5://... も使用されます。通常の制限のないネットワークでは、どちらの設定も必要ありません。このサーバーはテレメトリーを収集しません。

取引は個別のオプトインです

まず SECURITY.md と docs/THREAT_MODEL.md をお読みください。最低限、次の設定が必要です。

export POLYMARKET_TOOL_PROFILE=all
export POLYMARKET_ENABLE_TRADING=true
export POLYMARKET_PRIVATE_KEY=0x...
export POLYMARKET_MAX_ORDER_PUSD=100
export POLYMARKET_SIGNATURE_TYPE=eoa

EOA、レガシー Proxy、Gnosis Safe、POLY_1271 の設定に対応しています。preview_order はポリシーと現在のマーケットルールを確認し、5 分間有効な使い切りの承認を作成します。place_order はその承認を使用し、confirm=true を必須とします。一括発注には PLACE_BATCH が必要です。キャンセルにはそれぞれ個別の確認が必要です。承認状態の遷移は送信前に永続化され、ネットワークの結果が不明確な場合、安全に再試行できるとは報告されません。アカウントの読み取りやユーザーイベントの監視によって、切断時キャンセルのハートビートが暗黙に有効になることはありません。

開発とエビデンス

Rust 1.90 以降が必要です：

cargo fmt --check
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked --all-features
cargo test --locked --test live_api -- --ignored --nocapture

通常のテストはオフラインで実行され、コンパイル済みの実行ファイルを実際の stdio MCP サブプロセスとして起動します。無視対象のテストスイートでは、現在の本番用 Gamma、Data、CLOB REST、ウォレット、スキャン、WebSocket、記録、再生、シミュレーションの各経路を検証します。注文を出すことはありません。ツールカタログにはコミット済みのゴールデンコントラクトがあり、リリースタグでは 5 つの OS／アーキテクチャのターゲット向けに再ビルドします。

ライブ意味的置換監査では、このサーバーとリファレンスの Python サーバーの両方を MCP 経由で起動し、Python のデモツールをすべて対応付けます。Rust のエラーまたは不変条件違反が発生すると失敗します：

python3 scripts/parity_harness.py

• Python 置換マトリックス
• Python サーバーからの移行
• 同一トークンによる Python との比較
• 最新のライブ同等性監査の概要
• ChatGPT のセットアップ
• 読み取り専用 HTTP デプロイ
• 互換性
• コントラクトの安定性
• ロードマップ
• 貢献
• プライバシー
• サポート
• ローンチおよびデモキット

このソフトウェアは市場インフラを提供するものであり、取引の推奨や金融アドバイスを提供するものではありません。