快速开始

三步即可发出你的第一个 droidata MCP 调用。

1. 创建 API Key

注册后进入控制台的 API Key 页面，创建一个新 Key。明文密钥仅展示一次，请妥善保存（形如 drd_live_xxx）。

2. 调用工具

所有工具通过统一的 invoke 端点调用，传入 tool_name 与 args：

curl

curl -X POST https://mcp.droidata.com/mcp/v1/invoke \
  -H "Authorization: Bearer drd_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"macro.fred_series","args":{"series_id":"FEDFUNDS","start_date":"2024-01-01"}}'

3. 解析统一封套

响应遵循统一封套，便于错误处理与计费核对：

response.json

{
  "code": 200,
  "message": "ok",
  "data": { "series": [ { "date": "2024-01-01", "value": 5.33 } ], "units": "Percent" },
  "audit_id": "au_9f21a3",
  "execution_time_ms": 142,
  "data_freshness": "2h",
  "_meta": { "token_cost": 8, "plan": "free", "remaining_tokens": 99870 }
}

Python 示例

quickstart.py

import requests

resp = requests.post(
    "https://mcp.droidata.com/mcp/v1/invoke",
    headers={"Authorization": "Bearer drd_xxx"},
    json={"tool_name": "macro.fred_series",
          "args": {"series_id": "FEDFUNDS", "start_date": "2024-01-01"}},
)
print(resp.json()["data"])  # 时序数据