Manifold Markets

Manifold Markets MCP 服务

用于与 Manifold Markets 交互的 MCP 服务。Manifold Markets 是一个预测市场平台。提供 18 个工具，涵盖市场发现、交易（下注和限价单）、市场管理（创建、结算、评论、流动性）和投资组合分析。通过 stdio 通信，可与任何兼容 MCP 的客户端配合使用，例如 Claude Desktop 或 Claude Code。

入门

要求

• 从你的 账户设置获取 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

预构建二进制文件

从 Releases下载。

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	创建新市场（二元、多选或数值型）
resolve_market	结算你创建的市场
close_market	关闭市场或更改其关闭时间
add_comment	对市场发表评论
add_liquidity	为市场添加 mana 流动性
send_mana	向其他用户发送 mana

分析

工具	说明
get_baseline	获取市场在过去某个时间点的确定性基准概率（默认：24h）
get_portfolio_pnl	获取完整的投资组合盈亏汇总，以及所有持仓的 24h 变动

核心概念

• 市场 -- 用户进行交易的问题。每个市场都有类型（是/否二元、选择题、伪数值等）、一个概率或一组答案概率，以及一个截止时间，过后不再接受新投注。
• Mana -- 用于投注和交易的平台货币。用户可通过存款、交易获利以及其他用户转账获得 Mana。Mana 还可用于向市场添加流动性或转账给其他用户。
• 投注和份额 -- 对某个结果投注，即购买该结果的份额。每份价格反映市场当前的概率。在市场结算前，随时可以卖出份额。
• 限价订单 -- 限价订单不按当前价格购买，而是指定一个概率阈值。订单会保持开放，直至成交、过期或取消。使用带有 limitProb 参数的 place_bet 创建限价订单。
• 持仓 -- 用户在某个市场中的当前持有情况：持有哪些结果的份额、持有多少份，以及盈亏。
• 结算 -- 市场创建者决定结果（YES、NO、部分结算时为 MKT，或 CANCEL）。对于选择题市场，会结算到特定答案 ID。结算会触发向份额持有者付款。
• 流动性 -- 添加到市场资金池中的 Mana，用于降低滑点（大额投注对价格的影响）。流动性越高，每次投注造成的价格变动越小。
• 市场类型 -- 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

服务包含三个内部层：

• 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