Revelata deepKPI MCP Server

공식

SEC 서류에서 추출한 심층 기본 데이터로, 블룸버그에서 찾을 수 없는 운영 KPI를 포함하며, 금융 AI 에이전트를 위해 구축되었습니다.

GitHub
3

문서

Revelata deepKPI MCP 서버 — 문서

블룸버그에서조차 찾을 수 없는 운영 KPI를 포함한 기초 데이터 — 사전 구조화되고, 완전한 인용이 제공되며, 에이전트가 바로 사용할 수 있습니다.

금융 AI를 위한 심층 기초 데이터, MCP를 통해 제공

비교 가능한 매출, ARPU, 점포 수, 수주 잔고, 세그먼트별 매출, 경영진 가이던스, 비일반회계기준 항목 등 실제 분석을 이끄는 기초 데이터는 SEC 제출 서류의 텍스트, 표, 차트 속에 존재합니다. Revelata의 deepKPI는 바로 그 정보를 KPI 시계열로 추출하고 사전 구조화하며, 모든 데이터 포인트에 대해 문장 수준의 인용을 제공하므로 여러분과 여러분의 에이전트가 그 숫자를 신뢰할 수 있습니다.

여기에 기초가 되는 텍스트 맥락과 해설을 함께 제공하므로, 여러분의 AI 에이전트는 마침내 신뢰할 수 있는 분석가가 됩니다.

제공 내용:

  • 330만 개의 기업별 KPI 시계열 — 미국 공개 기업(S&P 500, 400, 600) 전반에 걸쳐, 10년 이상의 이력과 일일 업데이트를 갖춘 조회 가능한 시계열로 구조화
  • 자연어 KPI 검색 및 시맨틱 검색 — "올리브 가든 고객 방문 수" 또는 "AI 자본 지출 가이던스"와 같이 질문하여 제출 서류의 정확한 표현을 몰라도 올바른 지표를 찾을 수 있음
  • SEC 제출 서류(10-K, 10-Q, 8-K)를 마크다운으로 변환 — 표, 차트, 구조가 보존된 형태로 제공되며, 전체를 조회할 수 있어 에이전트가 경영진의 말을 그대로 인용 가능
  • 주제별 기업 검색 — 10-K 기반 요약에 대한 시맨틱 검색을 통해 SIC 코드만이 아닌 실제 사업 내용을 기준으로 기업을 찾아냄
  • 기업 요약 및 세그먼트 분석 — 각 기업의 최신 10-K에서 도출된 정보를 필요할 때 바로 제공

정확성이 요구되는 에이전트를 위해 구축되었습니다.

금융 AI 에이전트를 위한 신뢰할 수 있는 맥락을 제공합니다. 반환되는 모든 KPI 데이터 포인트는 단위, 규모, 기간, 그리고 정확한 출처 문장으로 연결되는 링크를 포함합니다. 모든 제출 서류 조회는 원문 그대로의 마크다운을 반환하므로, 에이전트가 중요한 사실을 의역하지 않습니다.

에이전트 스킬도 제공

계절성 분석, 내재 지표 도출, 애널리스트 보고서 스트레스 테스트, 벤치마킹 등 일반적인 워크플로우에 이러한 도구를 사용하는 방법을 에이전트에게 가르치는 오픈 소스 에이전트 스킬은 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)

  1. 다음 MCP 서버 URL을 복사하세요 https://deepkpi-mcp.revelata.com/mcp

  2. 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.

  3. Add a custom connector —
    Claude Desktop: Settings → Connectors → Add custom connector.
    Claude.ai (web): Use Settings → Customize.

  4. Configure the connector — Enter Revelata deepKPI under name and paste the server URL from step 3 exactly as copied. Click 'Add'.

  5. Complete OAuth — Begin a chat or task. When prompted to authenticate, sign in with your Revelata account in the browser.

  6. 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

SymptomWhat to try
Redirect loop or “access denied”Confirm you’re signed into the expected Revelata account.
Connector works but search / summary / filing markdown calls failYou 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

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

OpenClaw vs MCP

RuntimeHow you use deepKPI
Claude + MCPConnector 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.
OpenClawInstall 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.

여전히 막히셨나요?