MCP（無料API）

EDINET開示データの無料APIをClaudeなどのAIアシスタントから使うためのMCP（Model Context Protocol）エンドポイントの接続方法と提供ツールです。

MCPとはPOST https://api.yuhodb.com/v1/edinet/mcp

Claude などのAIアシスタントから、このAPIのデータを直接利用するための MCP（Model Context Protocol）エンドポイントです。接続すると、アシスタントが「トヨタの直近5年のROEを調べて」といった依頼に対して自分でツールを呼び出し、データを取得して回答できるようになります。

トランスポート: Streamable HTTP（JSON-RPC 2.0をPOST）
認証: 不要（利用条件はRESTと共通で、無料・非商用です）
セッション管理: なし（各リクエストは独立して処理されます）

RESTエンドポイントの一覧・レスポンス形式は無料APIの概要を、GraphQLでの取得はGraphQLをご覧ください。

接続方法認証不要

Claude Code

claude mcp add --transport http edinet https://api.yuhodb.com/v1/edinet/mcp

Claude（Web / デスクトップ）

設定 → コネクタ → 「カスタムコネクタを追加」で、URLに https://api.yuhodb.com/v1/edinet/mcp を指定します。

その他のMCPクライアント

Streamable HTTP対応のクライアントはURLを直接指定できます。stdioのみ対応のクライアントは mcp-remote を経由してください。

{
  "mcpServers": {
    "edinet": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.yuhodb.com/v1/edinet/mcp"]
    }
  }
}

提供ツール8種

ツール	引数	内容
`search_companies`	q（必須）, limit	企業を名前・証券コード・EDINETコードで検索します。他のツールに渡すedinetCodeを得る入口です。
`get_company_profile`	code（必須）	企業の基本情報（名称・証券コード・業種・法人番号）と書類種別ごとの収録範囲です。
`get_company_metrics`	code（必須）, metric[], from, to	財務指標の年次時系列です（訂正反映後）。metric省略時は全指標。開示が無い・確定できない年度はvalueがnullです。
`get_company_documents`	code（必須）, type[], from, to	開示書類の一覧です（提出日の新しい順）。
`get_company_segments`	code（必須）	最新年度の事業セグメント別指標です。
`list_metric_keys`	—	利用できる指標キー（58種）の一覧と定義です。
`get_metric_ranking`	metric, year（必須）, limit, industry	指標×年度の全社ランキングです（最大1,000位）。
`get_metric_distribution`	metric, year（必須）	指標×年度の分布（全体・業種別パーセンタイル）です。

code はEDINETコード / 証券コードのどちらでも指定できます。ツールの実行エラー（存在しない企業など）は isError: true のcontentとして返り、RESTと同じエラーコードとメッセージが含まれます。

プロトコルの流れ対応バージョン: 2025-06-18 / 2025-03-26 / 2024-11-05

MCPクライアントは次の順でメッセージを送ります。

1 — `initialize`

{ "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2025-06-18", "capabilities": {},
              "clientInfo": { "name": "my-client", "version": "1.0" } } }

2 — `notifications/initialized`

サーバは 202（本文なし）を返します。

3 — `tools/list` でツール定義を取得し、`tools/call` で実行します

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "get_company_metrics",
              "arguments": { "code": "7203", "metric": ["roe"], "from": 2022 } } }

結果はテキストcontent（JSON文字列）として返ります。

{ "jsonrpc": "2.0", "id": 3, "result": {
    "content": [ { "type": "text", "text": "{\"edinetCode\":\"E02144\", …}" } ],
    "isError": false } }

curlから直接試す

# 企業を検索する（tools/call）
curl "https://api.yuhodb.com/v1/edinet/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_companies","arguments":{"q":"トヨタ自動車","limit":1}}}'

利用条件・免責

無料でご利用いただけますが、非商用利用に限ります（商用利用不可）。利用条件はRESTと共通です。
出典はEDINET（金融庁）です。同システムのデータを加工して作成しています。
データは無保証です。正確性・完全性を保証するものではありません。
投資判断は、必ず原典（EDINETの開示書類）をご確認のうえ、ご自身の判断で行ってください。本APIは投資勧誘を目的としたものではありません。

本サイトの運営情報・免責事項はサイトについてをご覧ください。