Datavidence Financials

Datavidence Financials — MCP サーバー

すべての SEC XBRL 提出企業について、正規化された US-GAAP 財務諸表を、当初報告されたとおりの時点データとして、AI エージェント向けの MCP ツール（または通常の REST API）で提供します。

言語モデルは財務諸表の推論は得意ですが、それを取得するのは苦手です。SEC EDGAR にはデータがありますが、その XBRL は一貫性のないタグ、名称が変更された概念、提出企業ごとの独自仕様が入り組んでいます。そのため、エージェントは数値を幻覚したり、正規化レイヤーの構築に何週間も費やしたりすることになります。このレイヤーを使えば、エージェントが企業の財務情報を要求するだけで、クリーンで一貫した回答を得られます。Model Context Protocol 経由でも、通常の REST API 経由でも利用できます。

⭐ 役に立った場合は、ぜひリポジトリにスターを付けてください。 個人で開発している初期段階のプロジェクトです。スターが付くことで、ほかの開発者にも見つけてもらいやすくなります。

これは、Datavidence Financials API 用のオープンソースで AI ネイティブなレイヤーです。HTTPS 経由で REST API に転送するスタンドアロンの stdio サーバーで、API キーはご自身で用意します。コネクターは MIT ライセンスですが、基盤となる API は商用サービスです。

30 秒で試す（サインアップ不要）

uv を使えば、リポジトリをクローンせずに実行できます。一時的な環境にインストールされます。

FL_API_KEY=sandbox_demo_key uvx datavidence-financials

sandbox_demo_key を使うと、サインアップ不要でサンプルデータが返されるため、最初の動作確認に適しています。実際の SEC データを利用するには、FL_API_KEY に実際のキーを設定してください。サーバーは stdio 経由で MCP を使用するため、MCP クライアント（以下の Claude Desktop など）が起動します。

または、pipx を使って常設のツールとしてインストールできます。

pipx install datavidence-financials
FL_API_KEY=sandbox_demo_key datavidence-financials

URL で接続（インストール不要）

リモート MCP サーバー（ストリーミング可能な HTTP）に対応しているクライアントなら、何もインストールせずに接続できます。

URL	キー	データ
https://mcp.financials.datavidence.ai/mcp	なし	サンプル（AAPL FY2023）
https://mcp.financials.datavidence.ai/rapidapi/mcp	RapidAPI キーを X-API-Key または Authorization: Bearer として指定	RapidAPI のプランに応じて従量課金される実際の SEC データ

Claude Code：

claude mcp add --transport http datavidence-financials \
  https://mcp.financials.datavidence.ai/rapidapi/mcp \
  --header "X-API-Key: YOUR_RAPIDAPI_KEY"

サンプルデータを使う場合は、/mcp の URL を使用し、ヘッダーは指定しないでください。

claude.ai：サインインなしで、https://mcp.financials.datavidence.ai/mcp をカスタムコネクターとして追加します。claude.ai は、ほとんどのアカウントでまだ API キーを送信できないため、現時点ではサンプルデータが返されます。

異なる点

• 報告当時の時点情報です。 as_of 日付を渡すと、その時点での数値を取得できます。後日の修正再表示による先読みバイアスはありません。バックテストで気付かないうちに痛手を受ける原因を取り除きます。
• 単一のスキーマに正規化します。 EDGAR の XBRL タグは、提出者によって異なり、年を追って変更されます。扱いにくいケース（非支配持分、メザニン／一時的資本、暦年と異なる会計年度）も含め、米国 GAAP の単一の損益計算書、貸借対照表、キャッシュフロー計算書にマッピングするため、提出書類を解析する必要はありません。
• SEC の XBRL 提出者をすべてカバーします。 SEC の XBRL 全体（約 2009 年から現在まで）を対象とし、オンデマンドで取得・正規化します。厳選された一部ではなく、XBRL の事実データがあるすべての CIK が対象です。
• ソースへのリンクも付けられます。 プロベナンスを有効にすると、各数値に SEC の accession、提出日、EDGAR への直接 URL が付くため、モデルは数値を捏造せず、提出書類を引用できます。

対応範囲は正直にお伝えします。米国 GAAP のみです（IFRS 提出者には誤った数値ではなく、明確な「未対応」シグナルを返します）。対象となる履歴は XBRL 時代（約 2009 年以降）です。また、企業が新しい持株会社の下で再編されると、SEC のティッカーマップが示すのは後継 CIK のみです。過去年分は前身企業の CIK に残るため、エラーでその旨を通知し、cik= を直接指定できます。

ツール

• get_financials — SEC EDGAR XBRL から取得した、1 社・1 会計年度分の正規化済み損益計算書、貸借対照表、キャッシュフロー計算書 as_of（報告当時の時点情報）、include_provenance（値ごとの SEC accession、提出日、EDGAR ソースへの直接 URL）、include_ratios （利益率、ROA／ROE、レバレッジ）に対応しています。
• get_financials_batch — 最大 25 社分を 1 回の呼び出しで取得できます （ティッカー／CIK をカンマ区切りで指定）。銘柄ごとに結果を返します。1 件のクォータ単位として数えられるため、無効な銘柄があってもバッチ全体が失敗することはありません。
• list_filings — EDGAR の提出書類インデックスから、企業の最近の SEC 提出書類を新しい順に表示します。フォーム（例：10-K）で絞り込めます。get_financials を呼び出す前に、利用可能な会計年度の確認に使えます。
• get_revisions — 提出書類をまたいだ会計年度の数値の変更を表示します。提出されたすべての数値と、提出日、フォーム、SEC accession、EDGAR リンクに加え、修正再表示の有無と変更額も確認できます。Pfizer の FY2019 の売上高は、2020 年に 517.5 億ドルとして提出され、2022 年までに 409 億ドルに修正再表示されました。このツールでその経緯を確認できます。
• search_companies — ティッカーまたは企業名からティッカーと CIK を検索します。「Berkshire」は分かっていて BRK-B が必要な場合などに使います。上記のツールはすべて識別子を必要とするため、利用前にこのツールを使ってください。
• get_usage — キーの月間クォータ（ティア、使用量、残量、リセット時期）を表示します。無料で呼び出せ、クォータを消費しません。

エラーには API の recovery_action ヒントが表示されるため、エージェントは自動で修正できます。

Claude Desktop

claude_desktop_config.json に追加し、Claude Desktop を完全に終了（Cmd+Q）してから再起動すると、ツールが表示されます。

{
  "mcpServers": {
    "datavidence-financials": {
      "command": "uvx",
      "args": ["datavidence-financials"],
      "env": { "FL_API_KEY": "sandbox_demo_key" }
    }
  }
}

次のように尋ねてください。「AAPL の FY2023 の損益計算書、貸借対照表、キャッシュフロー計算書を、比率付きで取得してください。」 ライブデータを使う場合は、ご自身のキーに置き換えてください。

Codex

~/.codex/config.toml に追加し、codex を起動すると、ツールが表示されます。

[mcp_servers.datavidence-financials]
command = "uvx"
args = ["datavidence-financials"]
env = { FL_API_KEY = "sandbox_demo_key" }
# uvx downloads the package on first run; allow more than Codex's 10 s default.
startup_timeout_sec = 30

ライブデータを使う場合は、ご自身のキーに置き換えてください。

または、代わりに URL で接続することもできます（インストール不要です。DATAVIDENCE_API_KEY に RapidAPI キーを設定してください）。

[mcp_servers.datavidence-financials]
url = "https://mcp.financials.datavidence.ai/rapidapi/mcp"
bearer_token_env_var = "DATAVIDENCE_API_KEY"

bearer_token_env_var を省略し、サンプルデータには https://mcp.financials.datavidence.ai/mcp を使用してください。

設定（環境変数）

変数	デフォルト	備考
FL_API_KEY	(none)	API キーです。sandbox_demo_key = サインアップ不要のトライアル（サンプルデータ）。
FL_API_BASE_URL	https://api.financials.datavidence.ai	従量課金制の BYOK アクセスを利用する場合は、マーケットプレイスのゲートウェイを指定します。
FL_API_KEY_HEADER	X-API-Key	キーを送信するヘッダーです（例：RapidAPI ゲートウェイでは X-RapidAPI-Key）。
FL_API_TIMEOUT	30	リクエストごとのタイムアウト時間（秒）。

ライブデータを取得する

デモキーではサンプルデータが返されます。ライブデータを取得するには、RapidAPIでキーを取得してください：Free（月1,500回）、Pro（$29／5万回）、Business（$99／30万回）。すべてのプランで機能は同じです。異なるのは月間の呼び出し回数のみです。

RapidAPI キーを使用するには、次の3つの変数を設定します（Claude Desktop の設定の env ブロック、または Codex の config.toml にある env テーブル）：

FL_API_BASE_URL=https://datavidence-financials-api.p.rapidapi.com
FL_API_KEY_HEADER=X-RapidAPI-Key
FL_API_KEY=<your RapidAPI key>

キーは RapidAPI のアプリの Authorization ページ、または API のページにあるコードスニペットで確認できます。呼び出しは RapidAPI によってプランに応じて課金対象として計測されます。RapidAPI キーを使うと、get_usage に RapidAPI のプランと月間上限が表示されます。呼び出し回数は RapidAPI によって計測されるため、RapidAPI ダッシュボードで使用回数を確認してください。

ソースから実行する

pip install -e .
FL_API_KEY=sandbox_demo_key python -m mcp_server.server   # stdio transport

テスト

pip install -e ".[dev]"
pytest

テストは29件で、ネットワーク接続も API キーも必要ありません。HTTP レイヤーをスタブ化した状態で MCP SDK を通じてすべてのツールを呼び出し、API エラーが復旧のヒントとともにモデルに届くことを確認します。また、各ツールで4つの動作ヒント（読み取り専用、非破壊、冪等、オープンワールド）がすべて宣言されていることも確認します。

プライバシーポリシー

コネクターはお使いのマシン上で動作し、テレメトリーはなく、データも保存しません。ツールを呼び出すと、Datavidence Financials API に次の2つが送信されます。ツールの引数（ティッカー、CIK、会計年度、会社名検索など）と、リクエストヘッダーに含まれる API キーです。ファイルや会話のほかの部分を見ることはありません。

• 送信先： デフォルトでは https://api.financials.datavidence.ai です。FL_API_BASE_URL に RapidAPI ゲートウェイを設定すると、リクエストは RapidAPI のプライバシーポリシーに従って RapidAPI 経由で送信されます。
• API が記録する情報： 各リクエストについて、エンドポイント、HTTP ステータス、応答時間、タイムスタンプ、IP アドレスが記録され、API キー自体ではなく、そのハッシュにひも付けられます。
• 保持期間： 利用ログは12か月間保持されます。
• 共有： 販売されることはありません。契約したマーケットプレイスのゲートウェイと、サービスをホストするインフラプロバイダーとのみ共有されます。
• お問い合わせ先： [email protected]

ポリシー全文：https://financials.datavidence.ai/privacy

フィードバック

数値が正しく返されない会社を見つけた場合や、必要なフィールド／ツールがある場合は、issue を作成してください。正規化に関するエッジケースのフィードバックが、改善に役立ちます。すべての報告に目を通しています。

リンク

• サイトとドキュメント： https://financials.datavidence.ai
• MCP クイックスタート： https://financials.datavidence.ai/mcp
• MCP レジストリ： ai.datavidence/datavidence-financials
• PyPI： https://pypi.org/project/datavidence-financials/
• キーを取得（RapidAPI）： https://rapidapi.com/datavidence-ykNLbvGmT/api/datavidence-financials-api
• プライバシーポリシー： https://financials.datavidence.ai/privacy
• 利用規約： https://financials.datavidence.ai/terms
• セキュリティ： 脆弱性を非公開で報告するには、SECURITY.mdをご覧ください。

ライセンス

MIT © 2026 Datavidence LLC — LICENSEをご覧ください。コネクターはオープンソースです。基盤となる Datavidence Financials API は商用サービスです。