ko-mcp

30 秒で開始

AI エージェントで使用（MCP） — すぐに使えます。キーは不要です。

claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp

続けて、「NVDAを買っているのは誰？」「先月、議会は何を取引した？」「現物BTC ETFを保有している機関は？」などと質問してください。エージェントが実際のツールを呼び出し、実際の提出書類を引用します。

REST 経由 — キー不要のデモモード：

curl "https://api.ko.io/api/v1/institutions?search=berkshire&demo=true"

Python で使用：

pip install ko-edgar

from ko_edgar import KoClient

ko = KoClient()  # demo mode; KoClient(api_key="ko_live_...") for your quota
for h in ko.stocks.holders("NVDA"):
    print(h["name"], h["holding_value"], h["action"])

TypeScript で使用：

npm install @ko-io/sdk

import { KoClient } from "@ko-io/sdk";

const ko = new KoClient(); // or { apiKey: "ko_live_..." }
const { rows } = await ko.congress.trades({ sort: "recent" });

無料キーでは、クレジットカード不要で、いつまでも 1 日 200 回呼び出せます → ko.io/console。

このリポジトリの内容

セットアップガイド、パッケージのドキュメント、コントリビューター向けワークフローについては、ドキュメント一覧をご覧ください。

ディレクトリ	内容
server/	ホスト型 MCP サーバー（mcp.ko.io）— Cloudflare Worker、32 個のツール。このリポジトリからデプロイされます
docs/clients/	あらゆる MCP クライアント向けの検証済みセットアップガイド
python/	ko-edgar — 公式 Python SDK（同期・非同期、型付き）
typescript/sdk/	@ko-io/sdk — 公式 TypeScript SDK（Node 18 以降、ブラウザー、エッジ）
typescript/mcp-proxy/	@ko-io/mcp-sec-data — リモート HTTP MCP に対応していないクライアント向けの stdio ブリッジ
cookbook/	実際の投資に関する質問への、実行可能な回答 10 件
llms.txt	すべてのツールとエンドポイントの機械可読な一覧

server/ の MCP サーバーは、https://mcp.ko.io/mcp で稼働しているものとまったく同じコードです。server/ に変更を加えた main へのプッシュはすべて、サーバーをデプロイします。また、ご自身の Cloudflare アカウントでセルフホストすることもできます（cd server を実行し、wrangler.toml の routes ブロックを削除してください。これは ko.io ゾーンに固定されています。その後、npx wrangler deploy を実行します）。サーバーはご自身の API キーを使って api.ko.io にプロキシするため、利用枠とプランはそのまま引き継がれます。API の背後にあるデータパイプラインはマネージドサービスとして稼働します（二重リージョン、3 レプリカの ClickHouse、各ソースの公開スケジュールに合わせて更新される 27 個のパイプライン）。

注: 3 つのクライアントパッケージはすべて公開済みです。PyPI の ko-edgar と、npm の @ko-io/sdk および @ko-io/mcp-sec-data です。ホスト型 MCP エンドポイントと REST API は現在利用できます。

クライアントを接続する

クライアント	ガイド	ワンライナー
Claude Code	ガイド	claude mcp add ko-sec-data --transport http https://mcp.ko.io/mcp
Claude Desktop	ガイド	リモート HTTP 設定、または npx -y @ko-io/mcp-sec-data
Cursor	ガイド	~/.cursor/mcp.json
Windsurf	ガイド	Cascade → MCP
Zed	ガイド	設定の context_servers
OpenAI Codex	ガイド	codex mcp add ko-sec-data --url https://mcp.ko.io/mcp
ChatGPT / Gemini / Grok	ガイド	REST API / カスタム GPT アクション

任意のクライアントでご自身の利用枠を使うには、サーバー URL に ?api_key=YOUR_KEY を追加するか、Authorization: Bearer YOUR_KEY を送信してください。

データ

データセット	対象範囲	無料枠
13F機関投資家保有銘柄	8,800万行以上、2013年から現在まで、ファミリー単位で統合	✅
インサイダー取引（Form 3/4/5）	1,100万件以上の取引、公開市場取引に分類	✅
議会議員の取引	STOCK Actに基づく開示、上下両院	✅
暗号資産ETFエクスポージャー	13Fに基づく機関投資家の現物BTC ETF保有状況	✅
Form 144	インサイダーによる売却予定（将来予測）	✅
フェイルズ・トゥ・デリバー + Reg SHO	空売り側のストレス状況を示す足跡	✅
株価・財務情報	日次OHLCV + 10-K/10-QからXBRLで抽出した財務諸表。現金、設備投資、フリーキャッシュフロー、自社株買い、配当を含む	✅
SEC提出書類ゲートウェイ	あらゆる提出書類、署名付き共有可能リンク	一覧／索引 ✅ · 書類はPro
マクロ（財務省、FRB、CPI、OFRストレス）	日次の連邦政府ソース	Pro
欧州の開示（SE、NL、DK、UK）	インサイダー取引（PDMR）、大口保有、ネット空売りポジション（UKを除く）、年次報告書。行ごとに出典を明記。稼働中：2026-10-17以降、4地域すべて（UKには空売りポジションなし）— 稼働状況は get_eu_markets で確認できます	✅（直近期間）

すべてのデータはパイプライン全体で出典を追跡でき、提出書類ゲートウェイから基となるSEC書類を取得できます。そのため、エージェントは数値を捏造せず、実際の提出書類を引用できます。

32種類のMCPツール

機関投資家: get_institution_holdings · list_institutions · 株式: get_stock_profile · get_stock_holders · get_stock_activity · get_stock_price · get_stock_financials · インサイダー: get_insider_trades · list_insider_traders · 議会: get_congress_trades · get_congress_member · 政府契約: get_gov_contracts · search_gov_contracts · 暗号資産: get_crypto_exposure · get_crypto_holders · get_crypto_holder · 提出書類: sec_list_filings · sec_get_filing_index · sec_get_filing_document · 空売りデータ: get_ftd_data · 検索: search · Form 144: get_form144_notices · マクロ（Pro）: get_treasury_yields · get_fed_rates · get_economic_indicators · get_financial_stress · 欧州: get_eu_markets · get_eu_insider_dealings · get_eu_major_holdings · get_eu_short_positions · get_eu_annual_reports · get_eu_issuer

パラメーターの完全なリファレンス：llms.txt · ko.io/docs

企業財務情報

get_stock_financials は、10-K/10-Qの財務諸表の値を返します。売上高、純利益、EPS、利益率、営業キャッシュフロー、 cash_and_equivalents、total_assets、total_liabilities、capex、free_cash_flow、stock_repurchase（自社株買い）、 dividends_paid、investing_cashflow、financing_cashflow、負債が含まれます。 設備投資、自社株買い、配当はいずれも通常、正の現金支出（USD）です。負の値は、提出書類に記載された値または導出された値をそのまま返します。capex が負の場合、free_cash_flow はnullになります。 free_cash_flow = operating_cashflow - capex となるのは、両方の値が報告され、かつ capex >= 0 の場合のみです。それ以外はnullです（欠損値が0として扱われることはありません）。 cash_and_equivalents に短期投資は含まれません。long_term_debt はus-gaapの LongTermDebt で、流動部分を含みます。 例：「MSFTの直近4四半期の自社株買い」 -> get_stock_financials(ticker="MSFT", period_type="quarterly", limit=4)。 無料かつキー不要の呼び出しで取得できるのは最新四半期のみです。それ以前の四半期と年次財務諸表にはProが必要です。

政府契約

get_gov_contracts は、2015会計年度以降の米国連邦政府の元請契約債務を発行者単位で返します。 アクション行を取得するには include=actions を、1件の契約に紐づくアクションを取得するには award_id を指定します。 search_gov_contracts は、企業横断でアクションを検索するか、view=companies で企業をランキング表示します。 金額は正確な10進数文字列のままです。総額は債務が正、債務削減が負で、その合計が純額です。 無料アクセスで利用できるのは直近92日分です。過去データの利用にはProが必要です。 期間は period、fiscal_year、または from／to のいずれか1つを選択してください。 自動的な完全一致の対象は、現在上場している企業と、根拠を記録した審査済みの関連付けです。 関連付けられたアクションがないことは、契約がないことの証明にはなりません。直近数か月分は暫定値で、国防総省の報告には約90日の遅れがあります。 方法論をご覧ください。

EDGARを直接スクレイピングしない理由

SEC EDGARから生の提出書類を取得する優れたオープンソースツールがあります （例：sec-edgar-mcp。ローカルプロセスで1社の生の書類が必要なら、十分に適した選択肢です）。 ko.ioが解決するのは別の問題です。生のEDGARでは答えられない、次のような質問です。

	生のEDGARアクセス	ko.io
「AAPLの最新の10-Kを取得する」	✅	✅（提出書類ゲートウェイ）
「すべての機関投資家を通じてNVDAを買っているのは誰か？」	❌ すべての13Fを解析する必要あり	✅ 122ms
「Berkshireの52四半期前までのポートフォリオ」	❌ 50件以上の提出書類をリアルタイムで解析	✅ 事前計算済み
「Vanguardの7つの提出法人を1つの運用会社として表示」	❌	✅ ファミリー単位で統合
議会の取引、FTD、マクロ、暗号資産エクスポージャー	❌ EDGARに含まれない	✅
ウェブベースのAI（claude.ai、ChatGPT）で動作	❌ ローカルプロセス	✅ ホスト型MCP
セットアップ	Python環境＋インストール	1つのコマンド、インストール不要

プラン

	Demo（キー不要）	Free	Pro	Builder
呼び出し数／日	制限あり	200	20,000	200,000
リクエストあたりの行数	500	500	5,000	50,000
SECのコアデータ	✅	✅	✅	✅
履歴の範囲	最新分	最新分	全期間	全期間
マクロ（Treasury／Fed／CPI／ストレス）	—	—	✅	✅
一括エクスポート	—	—	—	✅

クォータは00:00 UTCにリセットされます。MCPとRESTは同じクォータを共有します。料金：https://ko.io/pricing/

コントリビューション

IssueとPRを歓迎します。CONTRIBUTING.mdをご覧ください。 セキュリティに関する報告：SECURITY.md。

MIT © ko.io