Sugra API MCP 是 Sugra API 的官方 Model Context Protocol（MCP）服务器，定位为 LLM 智能体与世界数据之间的连接器。它通过一个 MCP 服务器，让任意 AI 智能体访问来自 160 多个一手来源、覆盖 36 个数据领域的 1600 多个数据端点，数据范围包括市场、经济、公司、政府、新闻、气候、海事和实体筛查。
主要能力方面，服务器提供捆绑的端点目录，发现类操作（搜索、描述、工具集）在本地运行，无需网络调用，只有实际数据请求才会访问 API。每个工具结果都携带结构化元数据，包括来源归属、数据新鲜度和速率限制成本，使智能体能够引用来源并规划请求预算。服务器还附带六个工作流提示词，可在支持 MCP 提示词的客户端中变成一键流程，例如市场与宏观研究、带来源的股票快照、制裁与合规筛查、行业比较、气候/海事/贸易情报以及来源发现。
使用方式上，推荐使用托管 MCP，无需安装。在 Claude、ChatGPT 和 Codex 中，可从目录添加 Sugra API MCP 服务器：Claude 网页版、桌面版、移动版、Claude Code 和 Cowork 可通过 Anthropic 的 Connectors Directory 添加并登录 Sugra 账户；ChatGPT 和 Codex 可通过 OpenAI 的 Plugins Directory 添加。其他 MCP 客户端或手动设置可指向托管 Streamable HTTP 端点 https://mcp.sugra.ai/mcp（永久别名 https://app.sugra.ai/mcp），使用 OAuth 登录或 Authorization: Bearer sugra_xxx_... 的 API 密钥认证。本地安装则通过 stdio（或自托管 HTTP）运行，使用 SUGRA_API_KEY 认证，免费 API 密钥可在 app.sugra.ai/register 获取，免费层为每天 50 次请求。
本地包暴露八个网关工具，托管端点在此基础上额外提供三个组合分析工具（resolve_entity、get_snapshot 和 get_timeseries），这些工具依赖仅托管部署才有的基础设施凭据，因此 pip install sugra-api-mcp 的 stdio 和自托管 HTTP 始终只暴露经典八工具网关。对于合规实体查询（LEI / VAT、制裁筛查），可使用 sugra_entity_lookup 和 sugra_entity_screen，它们在所有传输方式下均可用。
适用场景包括：市场与宏观研究（如比较 G7 通胀和央行政策利率）、股票快照与来源引用、制裁与合规筛查、行业比较、气候/海事/贸易情报以及数据来源发现。支持的客户端包括 Anthropic Claude（Claude Desktop、Claude Code、claude.ai）、OpenAI GPT（ChatGPT 通过 MCP 连接器）、Google Gemini（Gemini CLI、Gemini Code Assist）、xAI（xAI SDK 和 Responses API 中的 Remote MCP Tools）、IDE（VS Code、Cursor、Zed、Cline、Continue.dev、Windsurf）以及基于 Python 或 TypeScript MCP SDK 构建的自定义智能体。
限制方面，托管端点独有的三个组合工具在本地 stdio 或自托管安装中不可用。ChatGPT 会话（MCP initialize 中客户端名为 openai-mcp，或未发送客户端名且 User-Agent 以其开头）会列出 145 个类型化工具，替代 search_endpoints、describe_endpoint、call_endpoint 和 fetch_data，这些类型化工具不接受原始位置输入（坐标、地址、邮政编码）。fields 投影最多接受 32 个路径，每个路径最多 256 个字符和 16 个点分段，超出会返回 projection_too_large；一次投影最多访问 100,000 个列表项、运行最多 5 秒、处理最多 2,000,000 字符的 JSON 响应；结果本身有 18,000 字符限制。塑形操作运行在独立的两个工作线程池上，最多 8 个任务运行或等待，单个调用者最多 4 个，2 秒内找不到空闲槽会返回 server_busy。
