Revelata deepKPI MCP Server

公式

SEC提出書類からの深層基礎データ。Bloombergにはない業務KPIを含み、金融AIエージェント向けに構築されています。

ドキュメント

Revelata deepKPI MCP サーバー — ドキュメント

営業KPIを含むファンダメンタルデータは、Bloombergでも見つけられないほど深く、事前構造化され、完全な引用付きで、エージェントがすぐに利用できる形で提供されます。

金融AIのための深いファンダメンタルデータをMCPで提供

比較可能売上高、ARPU、店舗数、受注残高、セグメント別収益、経営陣のガイダンス、非GAAP内訳など、分析を実際に動かすファンダメンタルデータは、SEC提出書類のテキスト、表、グラフの中に存在します。RevelataのdeepKPIは、まさにその情報をKPI時系列として抽出・事前構造化し、すべてのデータポイントに文単位の引用を付与するため、あなたもエージェントもその数値を信頼できます。

これに加えて、基盤となるテキストの文脈や解説も提供するため、あなたのAIエージェントは、ついに信頼できるアナリストとなります。

得られるもの:

330万の企業固有KPI時系列 — 米国公開企業（S&P 500、400、600）を対象に、10年以上の履歴と日次更新を備えたクエリ可能な時系列として構造化
自然言語によるKPI発見とセマンティック検索 — 「Olive Gardenの来店客数」や「AI設備投資ガイダンス」と尋ねるだけで、提出書類の正確な文言を知らなくても適切な指標を見つけ出せます
SEC提出書類（10-K、10-Q、8-K）をMarkdownに変換 — 表、グラフ、構造を保持したまま全文取得可能なため、エージェントは経営陣の発言を逐語的に引用できます
テーマ別企業発見 — 10-K由来の要約に対するセマンティック検索により、SICコードだけでなく、企業が実際に行っていることに基づいて企業を抽出
オンデマンドの企業要約とセグメント内訳 — 各企業の最新10-Kから導出

正確さが求められるエージェントのために構築

金融AIエージェントに信頼できるコンテキストを提供します。返されるすべてのKPIデータポイントには、単位、スケール、期間、および正確なソース文へのリンクが付随します。すべての提出書類取得は逐語的なMarkdownを返すため、エージェントは重要な事実を言い換えたりしません。

エージェントスキルも利用可能

季節性分析、暗黙の指標導出、アナリストレポートのストレステスト、ベンチマーキングなど、一般的なワークフローでこれらのツールを使用する方法をエージェントに教えるオープンソースのエージェントスキルは、GitHubで見つけることができます。

無料でお試し

ユーザーあたり毎月100クレジット無料。検索と提出書類一覧は常に無料。抽出および検索呼び出しは結果ごとに課金されます。国際カバレッジ（日本、中国、香港、シンガポール）はエンタープライズクライアント向けに提供されます。

セットアップ手順

まず、無料のRevelataアカウントを作成してください — サインアップ。

その後、以下の手順に従って、Claude Desktop、Claude.ai、および類似のクライアントでサーバーを使用します。

注: OpenClawは当社のMCPサーバーを使用せず、REST APIと**DEEPKPI_API_KEY**を使用します。skills/_common/deepkpi-api.mdを参照してください。ホスト型APIドキュメント: deepkpi-api.revelata.com/docs。

基本セットアップ (Claude)

以下のMCPサーバーURLをコピーしてください https://deepkpi-mcp.revelata.com/mcp
Allow required capabilities — In Claude, enable Code execution and file creation by navigating to Settings → Capabilities on Claude.ai. For other clients, consult your documentation for connecting to MCP servers.
Add a custom connector —
Claude Desktop: Settings → Connectors → Add custom connector.
Claude.ai (web): Use Settings → Customize.
Configure the connector — Enter Revelata deepKPI under name and paste the server URL from step 3 exactly as copied. Click 'Add'.
Complete OAuth — Begin a chat or task. When prompted to authenticate, sign in with your Revelata account in the browser.
Begin using deepKPI data in your analyses!

MCP tools

The server exposes the following tools:

`query_company_id`

Looks up a company’s numeric identifier from a free-text name. Returns matches you can use as company_id in the other tools. For US companies this identifier is the SEC CIK.

Parameters: company_name (string), num_of_res (optional, default 5) — max number of matches to return.

Credits: None — free.

`list_kpis`

Lists all KPIs available for a given company, organized by category. Use this as the first step before searching: the returned KPI names help you write precise queries for search_kpis, which saves credits.

Parameters: company_id (string), source (optional) — omit to include all filing types, or set to 10-K, 10-Q, or 8-K to filter.

Credits: None — free.

`search_kpis`

Semantic search over KPIs for one company — finds items most relevant to your natural-language query. Each result costs one credit (cap 15 results per call; default 3 — increase only when needed). Best practice: run list_kpis first, then search using exact KPI names from that list when possible instead of requesting many broad results.

Parameters: company_id (string), query (string), num_of_res (optional, default 3), source (optional) — same filing-type filter as list_kpis; omit to search across all filing types.

Credits: Charged per result — check your balance or add credits at AI credits.

`company_summary_search`

Semantic search over all companies’ 10-K-derived summaries — returns the best-matching tickers/CIKs for a natural-language query (thematic discovery: “companies that …”, “who operates in …”). 1 credit per company returned (cap 15 via top_k_companies); empty results cost nothing.

Parameters: query (string), top_k_companies (optional, default 10, max 15).

Credits: 1 per company in the response — check your balance at AI credits.

Agent workflow: the company-summary skill — use for thematic lists; for a named company’s profile use get_company_summary / get_company_segments first (Workflow A in that skill).

`get_company_summary`

Returns a narrative company summary (derived from the company’s latest 10-K). Primary source for “what does this company do?” — not for pulling numeric KPI time series (use search_kpis for that). May follow company_summary_search when a thematic hit needs full prose.

Parameters: company_id (string) — for US companies, the SEC CIK (same as for list_kpis / search_kpis). If you only have a name, call query_company_id first.

Credits: 3 per successful call.

Agent workflow: the company-summary skill.

`get_company_segments`

Returns a structured segment breakdown (derived from the company’s latest 10-K). Use for high-level segment mix and narrative structure; for detailed segment metrics over time, prefer list_kpis + search_kpis.

Parameters: company_id (string) — SEC CIK for US companies; resolve with query_company_id if needed.

Credits: 3 per successful call.

Agent workflow: the company-summary skill.

`list_sec_filing_markdowns`

Lists SEC filings available as markdown for a given CIK. Use this to discover valid acc_no and seq_no values before fetching content. Agent workflow: the filing skill (tool-first, before web/SEC.gov).

Parameters: cik (int), form_type (optional string, e.g. 10-K), start_date (optional YYYY-MM-DD), end_date (optional YYYY-MM-DD).

Credits: None — free.

`get_sec_filing_markdown`

Fetches the markdown content for a specific SEC filing.

Parameters: cik (int), acc_no (string), seq_no (optional int, default 1).

Credits: 10 per successful call.

Critical quoting rule: When the user asks “what did they say”, “what comments were made”, “exact language”, or similar, you MUST return verbatim quotes/snippets from the markdown (with clear snippet boundaries). Do not paraphrase by default. Full rules: the filing skill.

Troubleshooting

Authentication issues

Symptom What to try

Redirect loop or “access denied” Confirm you’re signed into the expected Revelata account.

Connector works but search / summary / filing markdown calls fail You may be out of credits. list_kpis, query_company_id, and list_sec_filing_markdowns are free. search_kpis uses 1 credit per result; company_summary_search uses 1 credit per company returned; get_company_summary and get_company_segments each use 3 credits on success; get_sec_filing_markdown uses 10 credits on success. Check your balance at AI credits. Note that all accounts receive 100 free credits each month.

Symptom	What to try
Redirect loop or “access denied”	Confirm you’re signed into the expected Revelata account.
Connector works but search / summary / filing markdown calls fail	You may be out of credits. `list_kpis`, `query_company_id`, and `list_sec_filing_markdowns` are free. `search_kpis` uses 1 credit per result; `company_summary_search` uses 1 credit per company returned; `get_company_summary` and `get_company_segments` each use 3 credits on success; `get_sec_filing_markdown` uses 10 credits on success. Check your balance at AI credits. Note that all accounts receive 100 free credits each month.

Network and TLS

Use HTTPS only for the MCP endpoint.
Allow outbound HTTPS to your MCP host; some corporate networks interfere with long-lived streaming — try another network to test.
If auth hangs, try toggling VPN.

Tools don’t appear

Restart Claude after changing the connector.
Re-add the connector and complete OAuth again.
Confirm your client supports remote MCP with Streamable HTTP (not only legacy SSE docs).

OpenClaw vs MCP

Runtime	How you use deepKPI
Claude + MCP	Connector URL `…/mcp`, OAuth — tools `query_company_id`, `list_kpis`, `search_kpis`, `company_summary_search`, `get_company_summary`, `get_company_segments`, `list_sec_filing_markdowns`, `get_sec_filing_markdown`.
OpenClaw	Install `revelata-deepkpi`, set `DEEPKPI_API_KEY`, call REST per `skills/_common/deepkpi-api.md`.

Do not paste the MCP URL into OpenClaw as a substitute for the REST skill flow.

Get the Agentic Skills bundle, too

Agent instructions and OpenClaw install:

curl -fsSL https://raw.githubusercontent.com/revelata/deepkpi-agents/main/install.sh | bash

詳細: README.md。

まだお困りですか？

すぐに [email protected] までご連絡ください！