Revelata deepKPI

officiel

Données fondamentales approfondies issues des dépôts SEC, incluant des KPI opérationnels introuvables sur Bloomberg, conçues pour vos agents d'IA financière.

GitHub
3

Que pouvez-vous faire avec Revelata Deep KPI MCP ?

  • Trouver l’ID numérique d’une entreprise — résolvez un nom d’entreprise en son CIK SEC avec query_company_id afin de pouvoir l’utiliser dans d’autres outils.
  • Parcourir tous les KPI d’une entreprise — utilisez list_kpis pour voir chaque indicateur disponible organisé par catégorie avant d’effectuer une recherche précise.
  • Rechercher des KPI en langage naturel — demandez « fréquentation d’Olive Garden » ou « prévisions de dépenses en IA » avec search_kpis et obtenez des séries temporelles sourcées.
  • Découvrir des entreprises par thème — utilisez company_summary_search pour trouver des entreprises selon ce qu’elles font réellement, et non seulement leur code sectoriel.
  • Récupérer le résumé narratif d’une entreprise — appelez get_company_summary pour obtenir un aperçu en prose issu du dernier 10-K.
  • Récupérer les dépôts SEC au format markdown — listez les dépôts disponibles avec list_sec_filing_markdowns et récupérez le markdown textuel via get_sec_filing_markdown.

Documentation

Serveur MCP Revelata deepKPI — Documentation

Des données fondamentales, y compris des KPI opérationnels, que vous ne trouvez même pas sur Bloomberg — pré-structurées, entièrement sourcées et prêtes pour les agents.

Des données fondamentales approfondies pour l'IA financière, fournies via MCP

Les données fondamentales qui alimentent réellement l'analyse — ventes comparables, ARPU, nombre d'unités, carnet de commandes, chiffre d'affaires par segment, prévisions de la direction, ventilations non-GAAP — se trouvent dans le texte, les tableaux et les graphiques des documents déposés auprès de la SEC. Le deepKPI de Revelata extrait et pré-structure précisément ces informations en séries temporelles de KPI, avec des citations au niveau de la phrase pour chaque point de données, afin que vous et votre agent puissiez avoir confiance dans les chiffres.

Nous associons cela au contexte textuel et aux commentaires sous-jacents, pour que vos agents IA deviennent des analystes auxquels vous pouvez enfin vous fier.

Ce que vous obtenez :

  • 3,3 millions de séries temporelles de KPI spécifiques aux entreprises couvrant les sociétés cotées américaines (S&P 500, 400, 600), structurées en séries temporelles interrogeables avec plus de 10 ans d'historique et des mises à jour quotidiennes
  • Découverte de KPI en langage naturel et recherche sémantique — demandez « fréquentation d'Olive Garden » ou « prévisions de capex IA » et trouvez le bon indicateur sans connaître la formulation exacte du document
  • Documents SEC (10-K, 10-Q, 8-K) convertis en markdown avec tableaux, graphiques et structure préservés — récupérables en intégralité pour que votre agent puisse citer la direction textuellement
  • Découverte thématique d'entreprises — recherche sémantique dans les résumés issus des 10-K pour faire émerger les entreprises selon ce qu'elles font réellement, et pas seulement par code SIC
  • Résumés d'entreprise et ventilations par segment à la demande, issus du dernier 10-K de chaque entreprise

Conçu pour les agents qui doivent avoir raison.

Nous fournissons un contexte fiable pour vos agents IA financiers. Chaque point de données KPI renvoyé porte son unité, son échelle, sa période et un lien vers la phrase source exacte. Chaque récupération de document renvoie du markdown textuel, afin que les agents ne paraphrasent pas les faits significatifs.

Compétences d'agent également disponibles

Des compétences agentiques open source qui apprennent aux agents à utiliser ces outils pour des flux de travail courants — analyse de saisonnalité, dérivation d'indicateurs implicites, test de résistance des rapports d'analystes, analyse comparative, et plus encore — sont disponibles sur GitHub.

Essai gratuit.

100 crédits gratuits par mois et par utilisateur. Les recherches et les listes de documents sont toujours gratuites ; les appels d'extraction et de recherche sont facturés par résultat. La couverture internationale (Japon, Chine, Hong Kong et Singapour) est disponible pour les clients entreprise.

Instructions de configuration

Tout d'abord, créez un compte Revelata gratuit — S'inscrire.

Ensuite, suivez les instructions ci-dessous pour utiliser le serveur avec Claude Desktop, Claude.ai et les clients similaires.

Remarque : OpenClaw n'utilise pas notre serveur MCP ; il utilise l'API REST et DEEPKPI_API_KEY. Voir skills/_common/deepkpi-api.md. Documentation de l'API hébergée : deepkpi-api.revelata.com/docs.

Configuration de base (Claude)

  1. Copiez l'URL du serveur MCP suivante 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

Détails : README.md.

Encore bloqué ?