跳到正文
FinancialMD
English打开终端

面向 AI 智能体的 FinancialMD

FinancialMD 是面向智能体的 AI 原生金融终端，提供根据 SEC 申报文件整理的财务报表。每个数值都带有指回申报文件的证明，每次读取都可以指定过去的日期，因此智能体可以引用来源，回测时也不会用到未来数据。

第一步：连接 MCP 服务

MCP 服务地址是 https://mcp.financial.md/mcp（Streamable HTTP，无状态），提供 36 个只读工具。登录是可选的：不带令牌时，按免密钥的每日额度应答。

Claude Code：

claude mcp add --transport http financial-md https://mcp.financial.md/mcp

读取 JSON 配置的客户端（Cursor、VS Code、Windsurf 等）：

{
  "mcpServers": {
    "financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
  }
}

在 Claude 或 ChatGPT 中，把同一个地址添加为自定义连接器。服务卡片见 mcp.financial.md/.well-known/mcp.json，OAuth 元数据见 mcp.financial.md/.well-known/oauth-protected-resource。

先用 company_lookup，再用 snapshot_as_of（一次调用拿到某日已知的三张报表和比率）或 financials_standardized。用 verify_value 核对从别处得到的数字。

第二步：发起免密钥的 API 调用

HTTP API 无需账号，也无需密钥。下面的调用返回苹果最近五个年度的现金流量表，其中包括自由现金流：

curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"

每个数值都是一个值对象，带有 proof.accession、proof.form、proof.filed 和 proof.source_url（sec.gov 上的申报文件）。加上 as_of=2024-06-30 即可读取当日已知的数据。核对一个数字：

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
  -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

不带密钥时，每个 IP 地址每天有 25 次计量调用（比率、筛选、核对）、1,000 次申报层读取和 1,000 次元数据读取。每个响应都带 RateLimit-* 响应头；429 带 Retry-After，每个错误正文都列出解决办法。

第三步：按次付费（即将开放）

agent.financial.md 为通过 x402（Base 链上的 USDC）按次付费的智能体提供同样的路由，无需账号。目前尚未开通：那里的计价路由返回 402，正文会指回免密钥的主机。

每个路由的计划价格见 pricing.json 和 OpenAPI 文档 中的 x-price 字段。目前不收取任何费用，出错的调用永远不收费。

给智能体的文件

文件内容
openapi.jsonOpenAPI 3.1。每个操作都有说明和使用真实股票代码的示例请求
llms.txt简要指南：主机、公司标识、值对象、时点读取、额度
llms-full.txt全部内容合为一个文本文件：每个路由、比率公式和用法
skill.md一个 Agent Skill，含一次调用即可完成的用法
skills.zip调用 MCP 工具的 Agent Skills（SKILL.md），打包为一个 zip
pricing.json计划中的按次价格、免费额度和付费状态
mcp.jsonMCP 服务卡片：工具、认证和文档
server.jsonMCP Registry 条目
agent.json上述所有端点和文档的索引

智能体可以依靠什么

  • 每个数值都有来源：申报文件的编号、表格类型、提交日期、XBRL 标签，以及 sec.gov 上文件的链接。GET /proof/{id} 显示其背后的原始数据。
  • 时点：known.from 和 known.to 表示每个数值作为最新申报数字的时间段。as_of、original=true 和 history=true 可以无前视地读取过去，并显示重述。
  • 回答简短：报表调用只返回所请求的期间；MCP 工具结果先给出一行摘要，再给出结构化数据。
  • 股票代码、CIK 或名称：company=ticker:AAPL、company=cik:320193，或 GET /v1/companies?q=Apple。
  • 覆盖范围：目前为在美国交易所上市的 SEC 申报公司；标准化报表覆盖采用美国通用会计准则的公司。仅供参考，不构成投资建议。