文档概览

droidata 是面向 AI Agent 的金融数据 MCP 网关。本文档帮助你从零接入，理解工具调用模型、鉴权机制与合规约束。所有调用都遵循统一封套响应：code / data / audit_id / execution_time_ms。

从这里开始

5 分钟内发出你的第一个 MCP 调用。

把 droidata 接入 Claude Desktop、Cursor 等客户端。

JWT 登录与 API Key 管理、Bearer 调用。

理解 redistribution_allowed 与数据使用边界。

命名空间（namespace）：工具按 market / china / macro / trade / alternative / llm 六大命名空间组织，完整工具名形如 macro.fred_series。

Token 计量：每次调用消耗的 token 数取决于工具的 base_token_cost 与返回数据量，响应 _meta 中返回 token_cost 与剩余额度。

数据新鲜度（data_freshness）：每个响应都附带数据的更新时效，便于 Agent 判断是否需要重新拉取。