Sugra API MCP Server

什么是 Sugra API MCP Server？

Sugra API MCP Server 是 Sugra API 官方托管的 MCP 端点，AI 智能体可以通过它发现并调用 1,600 多个数据端点，涵盖金融、宏观、实体（KYB 与制裁）、网络、新闻、地球与研究数据。

Sugra API 将来自 195 个一手数据源的 36 个领域整合为统一的响应格式，面向 AI 智能体、金融科技应用、研究团队和内部看板。托管的 Sugra MCP 服务器已上架 Anthropic 的 Connectors Directory 和 OpenAI Plugins Directory；PyPI 上还有本地 stdio 包 sugra-api-mcp。

如何使用 Sugra API MCP Server？

你需要一个 Sugra 账号（Free 计划无需信用卡）。发现类请求是公开的，但调用工具需要认证：可以在浏览器中通过 OAuth 登录，或用 Sugra API 密钥发送 Authorization: Bearer。MCP 调用与直接调用 API 共用同一个每日请求配额。

MCP 端点为 https://mcp.sugra.ai/mcp（服务器名称 sugra-api）。

Claude Code

使用 OAuth（运行 /mcp 登录）：

claude mcp add --transport http sugra https://mcp.sugra.ai/mcp

使用 API 密钥（与 Sugra 文档一致）：

claude mcp add --transport http sugra https://mcp.sugra.ai/mcp --header "Authorization: Bearer $SUGRA_API_KEY"

如果 Claude Code 已用 claude.ai 账号登录，并且已从 Connectors Directory 连接 Sugra，它会直接出现在 /mcp 中。

Claude Desktop 与 claude.ai

从 Connectors Directory 添加 Sugra，或选择 Customize → Connectors → Add custom connector，粘贴 URL 并用 Sugra 账号登录。

Cursor

{
  "mcpServers": {
    "sugra": {
      "url": "https://mcp.sugra.ai/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "sugra": {
      "type": "http",
      "url": "https://mcp.sugra.ai/mcp"
    }
  }
}

对于 Codex CLI，文档给出的命令是 codex mcp add sugra --url https://mcp.sugra.ai/mcp --bearer-token-env-var SUGRA_API_KEY。

Sugra API MCP Server 的主要功能

• 覆盖面广：股票、期权、加密货币、大宗商品、外汇和基本面；央行、统计机构和贸易；KYB、制裁、PEP 信号以及 LEI/VAT 解析；IP、ASN、BGP、RPKI 和 Tor；精选新闻与 GDELT；天气、气候、能源和卫星数据；arXiv、NBER 和 Crossref。
• 基于目录的工具：智能体先在本地捆绑的目录中搜索，再按 operation_id 调用端点，一个服务器即可覆盖整个 API。
• 智能体提示：端点描述包含耗时等级、并发上限和批量计费，方便智能体规划超时和并行调用。
• 托管专属的组合工具：一次调用即可完成实体解析、快照和时间序列。
• 合规意识的筛查：制裁结果以筛查信号（clear、review 或 hit）加免责声明的形式返回，而不是合规结论。
• 所有计划数据相同：Free（$0，每天 50 次请求）、Personal（$9/月，每天 1,000 次查询）、Dev（$25/月，每天 5,000 次）和 Pro（$59/月，每天 50,000 次），不做功能限制。

Sugra API MCP Server 工具

我们的探测返回了 11 个工具。

• 发现（读取捆绑目录，不调用 API）：search_endpoints、describe_endpoint、list_toolsets 和 list_sources。describe_endpoint 返回参数、JSON 请求体 POST 端点的 request_body_schema 以及 agent_hints。
• 数据调用：call_endpoint 按 ID 调用操作（批量端点按请求体中的每一项计 1 次请求）；fetch_data 把搜索和调用合并为一次往返，适合自然语言查询。
• 实体与合规：sugra_entity_screen 将个人或组织名称与制裁数据库进行比对；sugra_entity_lookup 将 LEI（通过 GLEIF）或欧盟 VAT 号码（通过 VIES）解析为 KYB 信息包。
• 组合智能体工具（仅托管版）：resolve_entity 把股票代码、公司、指标、币种或货币对转换为标准实体；get_snapshot 运行 company_snapshot、macro_calendar 等命名配方；get_timeseries 返回有界的价格、宏观或 ETF 资金流序列。

Sugra API MCP Server 的使用场景

• 市场问题：“显示苹果公司的当前报价和公司快照，再画出它过去一年的价格走势。”
• 宏观研究：“最新的美国 CPI 数据是多少？宏观日历上的下一次发布是什么时候？”
• 交易对手核查：“将这个供应商名称与制裁名单比对，并查询它的 LEI 记录。”
• 期权分析：“获取 VIX 期限结构，告诉我目前是升水还是贴水。”
• 网络情报：“查询这个 IP 地址的 ASN 和 RPKI 状态。”

Sugra API MCP Server 常见问题排查

• 工具调用返回 missing_bearer_token 或 401：发现类请求无需认证，但调用工具需要 OAuth 登录或带 API 密钥的 Authorization: Bearer。
• HTTP 429：超出了计划的每日配额，响应中带有 Retry-After 请求头。不会产生超额费用。
• upstream_timeout：标记为 “slow” 或 “heavy” 的端点在上游冷启动时可能较慢，重试一次通常就能成功。
• Claude 中出现重复的 Sugra 连接：如果先添加了自定义连接器，又从目录中添加，请删除自定义的那个。