Manifold Markets

Manifold Markets MCP サーバー

予測市場プラットフォームである Manifold Markets を操作するための MCP サーバーです。市場の検索、取引（ベットと指値注文）、市場の管理（作成、決着、コメント、流動性）、ポートフォリオ分析をカバーする 18 個のツールを提供します。stdio 経由で通信し、Claude Desktop や Claude Code など、MCP 互換のあらゆるクライアントで使用できます。

はじめに

必要条件

• アカウント設定から取得した Manifold Markets API キー

設定

変数	必須	説明
MANIFOLD_API_KEY	はい	Manifold Markets API キー
MANIFOLD_API_URL	いいえ	カスタム API URL（デフォルト：https://api.manifold.markets）

ソースからインストール

Go 1.27.3 以降が必要です。

go install github.com/jbeshir/mcp-servers/manifold/cmd/manifold-mcp@latest

ビルド済みバイナリ

リリースからダウンロードしてください。

Docker

docker build -t manifold-mcp ./manifold
docker run -e MANIFOLD_API_KEY=<your-key> manifold-mcp

Claude Desktop

{
  "mcpServers": {
    "manifold": {
      "command": "/path/to/manifold-mcp",
      "env": { "MANIFOLD_API_KEY": "<your-key>" }
    }
  }
}

Claude Code

claude mcp add manifold -- env MANIFOLD_API_KEY=<your-key> /path/to/manifold-mcp

ツール

読み取り操作

ツール	説明
search_markets	キーワードとフィルターで市場を検索します
get_market	回答や説明を含む、市場の詳細情報を取得します
get_user	ユーザー名からユーザーのプロフィールを取得します
get_me	認証済みユーザーのプロフィールを取得します
list_bets	オプションのフィルターを指定してベットを一覧表示します
get_comments	市場へのコメントを取得します
get_positions	特定の市場におけるユーザーのポジションを取得します

取引

ツール	説明
place_bet	ベットまたは指値注文を行います（dryRun に対応）
sell_shares	市場のシェアを売却します
cancel_bet	保留中の指値注文をキャンセルします

市場の管理

ツール	説明
create_market	新しい市場を作成します（2択、複数選択、数値）
resolve_market	作成した市場を決着させます
close_market	市場を終了するか、終了時刻を変更します
add_comment	市場にコメントします
add_liquidity	市場に mana の流動性を追加します
send_mana	他のユーザーに mana を送ります

分析

ツール	説明
get_baseline	過去のある時点（デフォルト：24h）における市場の決定論的な基準確率を取得します
get_portfolio_pnl	すべてのポジションについて、24h の変動を含むポートフォリオ全体の損益概要を取得します

主要な概念

• 市場 -- ユーザーが取引する対象となる質問です。各市場には種類（2択のはい／いいえ、複数選択肢、疑似数値など）、確率または各回答の確率の集合、新たな賭けを受け付けなくなる締め切り時刻があります。
• マナ -- 賭けや取引に使用するプラットフォーム内通貨です。ユーザーは、入金、取引による利益、他のユーザーからの送金によってマナを受け取ります。マナは市場への流動性の追加や、他のユーザーへの送金にも使用されます。
• 賭けとシェア -- 結果に賭けると、その結果のシェアを購入します。シェアあたりの価格は、市場の現在の確率を反映します。シェアは、結果が確定する前であればいつでも売却できます。
• 指値注文 -- 現在の価格で購入する代わりに、指値注文では確率のしきい値を指定します。注文は、約定、期限切れ、またはキャンセルされるまで有効です。limitProb パラメーターを指定して place_bet を使用すると作成できます。
• ポジション -- 市場におけるユーザーの現在の保有状況です。保有している結果のシェアとその数、および損益が含まれます。
• 結果確定 -- 市場の作成者が結果（YES、NO、一部の場合はMKT、またはCANCEL）を決定します。複数選択肢の市場では、特定の回答IDが確定されます。結果が確定すると、シェア保有者への支払いが実行されます。
• 流動性 -- スリッページ（大口の賭けによる価格への影響）を抑えるために、市場のプールに追加されるマナです。流動性が高いほど、賭けごとの価格変動が小さくなります。
• 市場の種類 -- BINARY（はい／いいえ）、MULTIPLE_CHOICE（複数の名前付き回答）、FREE_RESPONSE（自由回答）、PSEUDO_NUMERIC（数値範囲を確率に対応付ける形式）、BOUNTY、POLL、NUMBERがあります。
• ドライラン -- place_bet ツールでは、dryRun=true を指定して、賭けを実行せずにシミュレーションできます。結果と費用がどうなるかを確認できます。

アーキテクチャの概要

graph LR
    Client["MCP Client<br/>(Claude Desktop, Claude Code)"]
    Server["manifold-mcp<br/>MCP Server"]
    HTTP["HTTP Client"]
    API["Manifold Markets<br/>REST API"]

    Client -- "JSON-RPC over stdio" --> Server
    Server --> HTTP
    HTTP -- "HTTPS + API key auth" --> API

サーバーには、次の3つの内部レイヤーがあります。

• cmd/manifold-mcp -- エントリーポイントです。環境変数から設定を読み込み、HTTP クライアントと MCP サーバーを作成して、stdio トランスポートを開始します。
• internal/server -- 18個の MCP ツールを登録し、受信したリクエストをハンドラーに振り分けて、レスポンスを整形します。ツール定義は、tools.go（読み取り操作）、tools_trading.go（取引）、tools_manage.go（市場の管理）に分かれています。
• internal/client -- Manifold Markets API 用の REST クライアントです。認証（Authorization ヘッダー内の API キー）、JSON のシリアライズ、エラー処理を行います。

データフロー

一般的な取引ワークフローでは、市場を検索し、内容を確認して、賭けをシミュレーションしてから実行します。

sequenceDiagram
    participant C as MCP Client
    participant S as manifold-mcp
    participant A as Manifold API

    C->>S: search_markets(term: "AI")
    S->>A: GET /v0/search-markets?term=AI
    A-->>S: Market list
    S-->>C: Formatted results

    C->>S: get_market(marketId: "abc123")
    S->>A: GET /v0/market/abc123
    A-->>S: Full market details
    S-->>C: Question, probability, answers

    C->>S: place_bet(contractId, amount, outcome, dryRun: true)
    S->>A: POST /v0/bet (dryRun)
    A-->>S: Simulated bet result
    S-->>C: Expected shares, probability change

    C->>S: place_bet(contractId, amount, outcome)
    S->>A: POST /v0/bet
    A-->>S: Executed bet
    S-->>C: Bet confirmation