Polymarket MCP Server

Polymarket MCP サーバー

⚠️ お知らせ：Quantish はサービスを終了します。 Quantish プラットフォーム（quantish.live）は閉鎖されます。この MCP サーバーはセルフホスト可能で、独立して引き続き動作しますが、Quantish チームによる本プロジェクトの保守や更新は終了します。予測市場分野で開発を行っており、リアルタイムのデータ基盤が必要な場合は、polynode.devをご覧ください。

Polymarket の予測市場で取引するための、セルフホスト可能な MCP サーバーです。

概要

このパッケージは、Polygon ネットワーク経由で AI エージェントが Polymarket の予測市場で取引できるようにする MCP（Model Context Protocol）サーバーを提供します。

機能

• Polymarket の取引機能一式 - Polymarket のあらゆる市場で売買できます
• Polygon ウォレット管理 - Safe 連携によりウォレットを生成、管理できます
• ガス代不要のトランザクション - ほとんどの操作で Polymarket のリレイヤーを使用します（MATIC は不要です）
• MCP 互換 - Claude、Cursor、その他すべての MCP クライアントで動作します
• セルフホスト可能 - Railway、Fly.io、その他の Node.js ホストで実行できます

クイックスタート

git clone https://github.com/joinQuantish/polymarket-mcp
cd polymarket-mcp
npm install

環境変数

変数	必須	説明
DATABASE_URL	はい	PostgreSQL の接続文字列
ENCRYPTION_KEY	はい	ウォレット暗号化用の 32 バイトの 16 進数文字列
POLYGON_RPC_URL	はい	Polygon RPC エンドポイント
BOT_SIGNING_SECRET	いいえ	信頼されたボットの HMAC 認証用シークレット
PORT	いいえ	サーバーポート（デフォルトは 3000）

暗号化キーの生成

# Generate ENCRYPTION_KEY (32 bytes = 64 hex chars)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# Generate BOT_SIGNING_SECRET (for trusted bot auth)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

データベースのセットアップ

PostgreSQL データベースであれば、どれでも使用できます。選択肢は以下のとおりです。

プロバイダー	備考
Railway	PostgreSQL サービスを追加し、変数から DATABASE_URL をコピーします
Supabase	supabase.comで無料プランを利用できます。Settings > Database から接続文字列をコピーします
Neon	neon.techのサーバーレス Postgres で、無料プランも利用できます
ローカル Docker	docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres

DATABASE_URL を設定してから、次を実行します。

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

サーバーの実行

# Development
npm run dev

# Production
npm run build
npm start

利用可能なツール

アカウントとウォレット

ツール	説明
request_api_key	新しいウォレットでアカウントを作成します（または既存のアカウントを復元します）
setup_wallet	Safe ウォレットをデプロイし、承認を設定します
get_wallet_status	ウォレットのデプロイ状況と承認状況を確認します
get_balances	USDC/MATIC の残高を取得します
get_deposit_addresses	入金用アドレスを取得します（EVM、Solana、BTC）
export_private_key	ウォレットの秘密鍵をエクスポートします
import_private_key	既存のウォレットをインポートします

取引

ツール	説明
place_order	買い注文または売り注文を出します
cancel_order	未約定の注文をキャンセルします
cancel_all_orders	未約定の注文をすべてキャンセルします
get_orders	注文履歴を取得します
execute_atomic_orders	複数の注文をアトミックに実行します
get_orderbook	市場の買い気配と売り気配を取得します
get_price	市場の中間価格を取得します

ポジション

ツール	説明
get_positions	ポジションを取得します
sync_positions	Polymarket API からポジションを同期します
get_claimable_winnings	払い戻し可能な賞金を確認します
claim_winnings	決着した市場の賞金を請求します
get_onchain_shares	すべての ERC-1155 保有分（ギフト分を含む）を取得します

送金とスワップ

ツール	説明
transfer_usdc	ブリッジされた USDC を送金します
transfer_native_usdc	Circle ネイティブ USDC を送金します
transfer_shares	ERC-1155 のシェアを送金します
send_matic	EOA から MATIC を送金します
swap_tokens	LI.FI 経由でトークンをスワップします
get_swap_quote	スワップの見積もりを取得します

API キー

ツール	説明
list_api_keys	API キーの一覧を表示します
create_additional_api_key	新しい API キーを作成します
revoke_api_key	API キーを無効にします

注： 市場検索ツール（search_markets、get_market、get_active_markets）は、Discovery MCPから利用できます。

API フォーマット

サーバーは /mcp で JSON-RPC 2.0 エンドポイントを公開します。

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_balances",
      "arguments": {}
    },
    "id": 1
  }'

MCP クライアントの設定

Claude Desktop / Cursor

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "x-api-key: YOUR_API_KEY"
      ]
    }
  }
}

セキュリティ

リピーター

セキュリティ上、リピーター（既存の externalId）は、認証なしで新しい API キーを取得できません。次の方法があります。

1. 既存の API キーを使用 - 保存してある場合
2. HMAC 認証（信頼できるボットのみ） - BOT_SIGNING_SECRET で署名します：

   signature = HMAC-SHA256(externalId:timestamp, BOT_SIGNING_SECRET)
   

3. 新しいアカウント - 別の externalId を使用します

開発

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

リソース

• GitHub：joinQuantish/polymarket-mcp
• Discovery MCP：joinQuantish/quantish-discovery
• Polymarket のドキュメント：docs.polymarket.com

ライセンス

このプロジェクトは、PolyForm Noncommercial License 1.0.0 の下でライセンスされています。

個人利用、研究、非営利目的であれば無料で利用できます。 商用利用には Quantish Inc. の明示的な許可が必要です。商用ライセンスについては [email protected] までお問い合わせください。

---

Quantish Inc. が開発しました