Revelata deepKPI MCP Server

chính thức

Dữ liệu cơ bản chuyên sâu từ hồ sơ SEC, bao gồm các KPI hoạt động không có trên Bloomberg, được xây dựng cho các tác nhân AI tài chính của bạn.

GitHub
3

Tài liệu

Revelata deepKPI MCP Server — Tài liệu hướng dẫn

Dữ liệu cơ bản, bao gồm các KPI hoạt động, mà bạn thậm chí không thể tìm thấy trên Bloomberg — được cấu trúc sẵn, trích dẫn đầy đủ và sẵn sàng cho tác nhân.

Dữ liệu cơ bản chuyên sâu cho AI tài chính, được cung cấp qua MCP

Dữ liệu cơ bản thực sự thúc đẩy phân tích — doanh số so sánh, ARPU, số lượng đơn vị, tồn đọng, doanh thu theo phân khúc, hướng dẫn của ban quản lý, các phân tách non-GAAP — tồn tại trong văn bản, bảng biểu và biểu đồ của hồ sơ SEC. Revelata deepKPI trích xuất và cấu trúc sẵn chính xác thông tin đó thành chuỗi thời gian KPI, với trích dẫn ở cấp độ câu cho từng điểm dữ liệu, để bạn và tác nhân của mình có thể tin tưởng vào các con số.

Chúng tôi kết hợp điều này với ngữ cảnh văn bản và bình luận cơ bản, để các tác nhân AI của bạn trở thành những nhà phân tích mà cuối cùng bạn có thể tin cậy.

Những gì bạn nhận được:

  • 3,3 triệu chuỗi thời gian KPI dành riêng cho từng công ty trên các công ty đại chúng Hoa Kỳ (S&P 500, 400, 600), được cấu trúc dưới dạng chuỗi thời gian có thể truy vấn với hơn 10 năm lịch sử và cập nhật hàng ngày
  • Khám phá KPI bằng ngôn ngữ tự nhiên và tìm kiếm ngữ nghĩa — hỏi "lưu lượng khách Olive Garden" hoặc "hướng dẫn capex AI" và tìm đúng chỉ số mà không cần biết chính xác từ ngữ trong hồ sơ
  • Hồ sơ SEC (10-K, 10-Q, 8-K) được chuyển đổi sang markdown với bảng biểu, biểu đồ và cấu trúc được giữ nguyên — có thể truy xuất đầy đủ để tác nhân của bạn có thể trích dẫn nguyên văn ban quản lý
  • Khám phá công ty theo chủ đề — tìm kiếm ngữ nghĩa trên các bản tóm tắt từ 10-K để hiển thị các công ty theo những gì họ thực sự làm, không chỉ theo mã SIC
  • Tóm tắt công ty và phân tích phân khúc theo yêu cầu, được lấy từ 10-K mới nhất của mỗi công ty

Được xây dựng cho các tác nhân cần sự chính xác.

Chúng tôi cung cấp ngữ cảnh đáng tin cậy cho các tác nhân AI tài chính của bạn. Mỗi điểm dữ liệu KPI được trả về đều mang theo đơn vị, quy mô, kỳ hạn và liên kết đến câu nguồn chính xác. Mỗi lần truy xuất hồ sơ đều trả về markdown nguyên văn, để các tác nhân không diễn giải lại các sự kiện trọng yếu.

Kỹ năng tác nhân cũng có sẵn

Các kỹ năng tác nhân mã nguồn mở dạy tác nhân cách sử dụng các công cụ này cho các quy trình làm việc phổ biến — phân tích mùa vụ, suy luận chỉ số ngầm định, kiểm tra áp lực báo cáo phân tích, so sánh chuẩn, v.v. — có thể được tìm thấy tại GitHub.

Dùng thử miễn phí.

100 tín dụng miễn phí/tháng cho mỗi người dùng. Tra cứu và liệt kê hồ sơ luôn miễn phí; các lệnh gọi trích xuất và tìm kiếm được tính phí theo kết quả. Phạm vi quốc tế (Nhật Bản, Trung Quốc, Hồng Kông và Singapore) có sẵn cho khách hàng doanh nghiệp.

Hướng dẫn thiết lập

Trước tiên, tạo tài khoản Revelata miễn phí — Đăng ký.

Sau đó, làm theo hướng dẫn bên dưới để sử dụng máy chủ với Claude Desktop, Claude.ai và các máy khách tương tự.

Lưu ý: OpenClaw không sử dụng máy chủ MCP của chúng tôi; nó sử dụng REST API và DEEPKPI_API_KEY. Xem skills/_common/deepkpi-api.md. Tài liệu API được lưu trữ: deepkpi-api.revelata.com/docs.

Thiết lập cơ bản (Claude)

  1. Sao chép URL máy chủ MCP sau đây 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

Chi tiết: README.md.

Vẫn gặp khó khăn?