コンテンツへスキップ
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（指定日に判明していた財務三表と比率を1回の呼び出しで取得）または financials_standardized を使ってください。別の場所で見つけた数値を確認するには verify_value を使います。

ステップ2. キー不要のAPI呼び出しを行う

HTTP APIにはアカウントもキーも不要です。この呼び出しは、フリーキャッシュフローを含むAppleの直近5年分の年次キャッシュフロー計算書を返します。

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アドレスには1日あたり25回の計量対象呼び出し（ratios、screen、verify）、1,000回の提出書類レイヤーの読み取り、1,000回のメタデータの読み取りが割り当てられます。すべてのレスポンスに RateLimit-* ヘッダーが付き、429には Retry-After が付きます。また、すべてのエラー本文には対処方法が記載されます。

ステップ3. 呼び出しごとに支払う

agent.financial.md は、x402（Base上のUSDC）で呼び出しごとに支払うエージェントに、アカウント不要で同じルートを提供します。そこでの有料ルートは、PAYMENT-REQUIRED ヘッダーに料金を示した402を返します。支払いに署名し、PAYMENT-SIGNATURE ヘッダーを付けて再度呼び出してください。402の本文にはキー不要のホストも示されており、そのホストでは日次上限内で同じルートを無料で利用できます。

各ルートの料金は pricing.json と、OpenAPIドキュメントの x-price フィールドに記載されています。適用されるのは402レスポンスに示された料金です。失敗した呼び出しには課金されません。

エージェント向けファイル

ファイル内容
openapi.jsonOpenAPI 3.1。すべての操作に説明と実際のティッカーを使ったリクエスト例を掲載
llms.txt簡潔なガイド：ホスト、企業ID、値オブジェクト、時点指定（ポイントインタイム）の読み取り、上限
llms-full.txtすべてを1つのテキストファイルに収録：全ルート、比率の計算式、レシピ
skill.md1回の呼び出しで使えるレシピを備えたエージェントスキル
skills.zipMCPツールを呼び出すエージェントスキル（SKILL.md）を1つのzipに収録
pricing.json呼び出しごとの料金、無料利用の上限、支払い状況
mcp.jsonMCPサーバーカード：ツール、認証、ドキュメント
server.jsonMCPレジストリの登録情報
agent.json上記のすべてのエンドポイントとドキュメントをまとめた索引

エージェントが信頼できること

  • すべての数値に出典があります。提出書類のアクセッション番号、様式、提出日、XBRLタグ、sec.gov上の文書へのリンクです。GET /proof/{id}で、その数値の基となる生のファクトを確認できます。
  • 時点指定（ポイントインタイム）：known.fromとknown.toは、各値がいつ最新の提出済み数値だったかを示します。as_of、original=true、history=trueを使うと、将来の情報を参照せずに過去のデータを読み取り、修正再表示を確認できます。
  • 簡潔な回答：財務諸表の呼び出しでは、指定された期間のみを返します。MCPツールの結果は、構造化データの前に1行の要約を表示します。
  • ティッカー、CIK、または会社名：company=ticker:AAPL、company=cik:320193、またはGET /v1/companies?q=Apple。
  • 対象範囲：現在、米国の取引所に上場しているSEC提出企業。US GAAPに基づく提出企業については標準化された財務諸表を提供します。情報提供のみを目的とし、投資助言ではありません。