PolyMarket MCP サーバー

PolyMarket APIを通じて予測市場データへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、予測市場から市場情報、価格、履歴データを取得するための標準化されたインターフェースを実装しています。

特徴

現在の価格と確率を含むリアルタイム予測市場データ
カテゴリ、解決日、説明を含む詳細な市場情報
カスタマイズ可能な時間枠（1日、7日、30日、すべて）の過去の価格と取引量のデータ
組み込みのエラー処理とレート制限管理
簡単に消費できるクリーンなデータフォーマット

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の PolyMarket Predictions を自動的にインストールするには:

npx -y @smithery/cli install polymarket_mcp --client claude

クロードデスクトップ

MacOSの場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

    "mcpServers": {
        "polymarket-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
            "run",
            "polymarket-mcp" //or src/polymarket_mcp/server.py
            ],
            "env": {
                "KEY": "<insert poly market api key>",
                "FUNDER": "<insert polymarket wallet address"
            }
        }
    }

ローカルで実行

リポジトリをクローンし、依存関係をインストールします。

ライブラリをインストールする

uv pip install -e .

ランニング

json ファイル経由で Claude クライアントを MCP ツールに接続し、パッケージをインストールすると、Claude はサーバーの mcp ツールを確認できるようになります。

以下の方法でサーバーを自分で実行できます: polymarket-mcp リポジトリ内:

uv run src/polymarket_mcp/server.py

*サーバーと一緒にサーバーインスペクターを実行する場合:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.py

PolyMarket API キーを使用して.envファイルを作成します。

Key=your_api_key_here
Funder=poly market wallet address

Claude クライアントを json ファイル経由で MCP ツールに接続した後、サーバーを実行します。alpha-vantage-mcp リポジトリで、 uv run src/polymarket_mcp/server.py実行します。

利用可能なツール

サーバーは 4 つのツールを実装します。

get-market-info : 特定の予測市場に関する詳細情報を取得する
list-markets : フィルタリングオプションを使用して利用可能な予測市場を一覧表示する
get-market-prices : 現在の価格と取引情報を取得する
get-market-history : 過去の価格と取引量データを取得する

市場情報を取得する

入力スキーマ:

{
    "market_id": {
        "type": "string",
        "description": "Market ID or slug"
    }
}

応答例:

Title: Example Market
Category: Politics
Status: Open
Resolution Date: 2024-12-31
Volume: $1,234,567.89
Liquidity: $98,765.43
Description: This is an example prediction market...
---

リスト市場

入力スキーマ:

{
    "status": {
        "type": "string",
        "description": "Filter by market status",
        "enum": ["open", "closed", "resolved"]
    },
    "limit": {
        "type": "integer",
        "description": "Number of markets to return",
        "default": 10,
        "minimum": 1,
        "maximum": 100
    },
    "offset": {
        "type": "integer",
        "description": "Number of markets to skip (for pagination)",
        "default": 0,
        "minimum": 0
    }
}

応答例:

Available Markets:

ID: market-123
Title: US Presidential Election 2024
Status: Open
Volume: $1,234,567.89
---

ID: market-124
Title: Oscar Best Picture 2024
Status: Open
Volume: $234,567.89
---

市場価格を取得する

入力スキーマ:

{
    "market_id": {
        "type": "string",
        "description": "Market ID or slug"
    }
}

応答例:

Current Market Prices for US Presidential Election 2024

Outcome: Democratic
Price: $0.6500
Probability: 65.0%
---

Outcome: Republican
Price: $0.3500
Probability: 35.0%
---

市場履歴を取得する

入力スキーマ:

{
    "market_id": {
        "type": "string",
        "description": "Market ID or slug"
    },
    "timeframe": {
        "type": "string",
        "description": "Time period for historical data",
        "enum": ["1d", "7d", "30d", "all"],
        "default": "7d"
    }
}

応答例:

Historical Data for US Presidential Election 2024
Time Period: 7d

Time: 2024-01-20T12:00:00Z
Price: $0.6500
Volume: $123,456.78
---

Time: 2024-01-19T12:00:00Z
Price: $0.6300
Volume: $98,765.43
---

エラー処理

サーバーには、さまざまなシナリオに対応する包括的なエラー処理機能が含まれています。

レート制限（429エラー）
無効な API キー (403 エラー)
無効なマーケットID（404エラー）
ネットワーク接続の問題
APIタイムアウト条件（30秒タイムアウト）
不正な応答

エラーメッセージは、明確で人間が読める形式で返されます。

前提条件

Python 3.9以上
httpx>=0.24.0
mcp-core
python-dotenv>=1.0.0

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更については、まずIssueを開いて、変更したい点について議論してください。

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

堅牢なエラー処理とレート制限管理により、PolyMarket API との対話を可能にして、市場情報、価格、履歴データなどの予測市場データを取得します。

Related Resources

Reddit Discussion about this server

Related MCP Servers

coincap-mcp
QuantGeekDev
A
security
A
license
A
quality
Real-time cryptocurrency market data integration using CoinCap's public API, providing access to crypto prices and market information without API keys
Last updated -
3
147
37
TypeScript
MIT License
CoinGecko MCP Server
crazyrabbitLTC
A
security
A
license
A
quality
Enables interaction with the CoinGecko Pro API to access cryptocurrency data including price history and market metrics through both MCP and OpenAI function calling.
Last updated -
5
5
JavaScript
MIT License
CoinMarketCap MCP Server
szcharlesji
-
security
A
license
-
quality
Real-time access to cryptocurrency data from the CoinMarketCap API.
Last updated -
24
1
TypeScript
MIT License
Python Server MCP
stevearagonsite
-
security
A
license
-
quality
A cryptocurrency price service that provides real-time crypto pricing information through an MCP (Model Context Protocol) framework with CoinMarketCap API integration.
Last updated -
Python
GPL 3.0

View all related MCP servers

PolyMarket MCP Server