跳至正文
FinancialMD
開啟終端

面向 AI 代理的 FinancialMD

FinancialMD 是面向代理的 AI 原生金融終端，提供根據 SEC 申報文件整理的財務報表。每個數值都帶有指向申報文件的證據，每次讀取都可指定過去的日期，因此代理可以引用來源，回測時也不會用到未來資料。

第 1 步：連接 MCP 伺服器

MCP 伺服器位於 https://mcp.financial.md/mcp（Streamable HTTP，無狀態），提供 50 個唯讀工具。登入為選用：不帶權杖時，會在免金鑰的每日限額內回應。

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 中，將同一個 URL 新增為自訂連接器。伺服器卡片見 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 核對從別處取得的數值。

第 2 步：發起免金鑰的 API 呼叫

HTTP API 無需帳號，也無需金鑰。以下呼叫會回傳 Apple 最近五個年度的現金流量表，其中包括自由現金流：

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，每個錯誤本文都列出解決方法。

第 3 步：按次付費

agent.financial.md 為透過 x402（Base 鏈上的 USDC）按次付費的智慧代理提供相同的路由，無需帳號。那裡的計價路由會回傳 402，價格列於 PAYMENT-REQUIRED 回應標頭中；簽署付款後，帶上 PAYMENT-SIGNATURE 請求標頭重新呼叫即可。402 的本文也會提供免金鑰主機，同一路由在該主機的每日限額內免費。

每個路由的價格見 pricing.json 和 OpenAPI 文件 中的 x-price 欄位。以 402 回應中的價格為準。失敗的呼叫不收費。

供智慧代理使用的檔案

檔案內容
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 申報公司；標準化報表涵蓋採用 US GAAP 的申報公司。僅供參考，不構成投資建議。