Revelata deepKPI

resmi

SEC dosyalarından derin temel veriler, Bloomberg'de bulunmayan operasyonel KPI'lar dahil, finansal AI ajanlarınız için oluşturulmuştur.

GitHub
3

Revelata Deep KPI MCP ile neler yapabilirsiniz?

  • Bir şirketin sayısal kimliğini bulun — bir şirket adını SEC CIK numarasına query_company_id ile çözümleyerek diğer araçlarda kullanabilirsiniz.
  • Bir şirkete ait tüm KPI’ları görüntüleyin — hassas bir arama yapmadan önce list_kpis kullanarak kategoriye göre düzenlenmiş mevcut tüm metrikleri görün.
  • KPI’ları doğal dil ile arayın — “Olive Garden ayak trafiği” veya “AI sermaye harcaması rehberliği” gibi sorguları search_kpis ile yapın ve kaynak gösterilen zaman serilerini alın.
  • Şirketleri temaya göre keşfedin — company_summary_search kullanarak firmaları yalnızca sektör kodlarına göre değil, gerçekte ne yaptıklarına göre bulun.
  • Bir şirketin anlatısal özetini alın — en son 10-K’dan türetilen düz yazı özeti için get_company_summary çağrısını yapın.
  • SEC dosyalarını markdown olarak getirin — list_sec_filing_markdowns ile mevcut dosyaları listeleyin ve get_sec_filing_markdown aracılığıyla birebir markdown içeriğini alın.

Dokümantasyon

Revelata deepKPI MCP Sunucusu — Dokümantasyon

Bloomberg'de bile bulamayacağınız, operasyonel KPI'lar dahil temel veriler — önceden yapılandırılmış, tamamen kaynak gösterilmiş ve ajan kullanımına hazır.

Finansal yapay zeka için derin temel veriler, MCP üzerinden sunulur

Analizi gerçekten yönlendiren temel veriler — karşılaştırılabilir satışlar, ARPU, birim sayıları, birikmiş işler, segment düzeyinde gelir, yönetim beklentileri, GAAP dışı kırılımlar — SEC dosyalamalarının metin, tablo ve grafiklerinde yaşar. Revelata'nın deepKPI'ı tam olarak bu bilgiyi ortaya çıkarır ve KPI zaman serileri halinde önceden yapılandırır; her veri noktası için cümle düzeyinde kaynak gösterimiyle, siz ve ajanınız rakamlara güvenebilirsiniz.

Bunu, altta yatan metinsel bağlam ve yorumlarla eşleştiriyoruz, böylece yapay zeka ajanlarınız nihayet güvenebileceğiniz analistlere dönüşüyor.

Elde edecekleriniz:

  • ABD halka açık şirketleri (S&P 500, 400, 600) genelinde 3,3 milyon şirkete özgü KPI zaman serisi, 10 yılı aşkın geçmiş ve günlük güncellemelerle sorgulanabilir zaman serileri olarak yapılandırılmıştır
  • Doğal dilde KPI keşfi ve anlamsal arama — "Olive Garden yaya trafiği" veya "yapay zeka sermaye harcaması beklentisi" diye sorun ve dosyalamanın tam ifadesini bilmeden doğru metriği bulun
  • SEC dosyalamaları (10-K, 10-Q, 8-K) markdown'a dönüştürülmüş, tablolar, grafikler ve yapı korunmuş olarak — ajanınız yönetimi kelimesi kelimesine alıntılayabilsin diye tam olarak alınabilir
  • Tematik şirket keşfi — 10-K'den türetilmiş özetler üzerinde anlamsal arama yaparak şirketleri yalnızca SIC koduna göre değil, gerçekte ne yaptıklarına göre ortaya çıkarın
  • Talep üzerine, her şirketin en son 10-K'sinden türetilmiş şirket özetleri ve segment kırılımları

Doğru olması gereken ajanlar için inşa edildi.

Finansal yapay zeka ajanlarınız için güvenilir bağlam sağlıyoruz. Döndürülen her KPI veri noktası, birimini, ölçeğini, dönemini ve tam kaynak cümleye bağlantıyı taşır. Her dosyalama alımı, kelimesi kelimesine markdown döndürür, böylece ajanlar önemli gerçekleri başka sözcüklerle ifade etmez.

Ajan becerileri de mevcuttur

Ajanlara bu araçları yaygın iş akışları için nasıl kullanacaklarını öğreten açık kaynak ajan becerileri — mevsimsellik analizi, örtük metrik türetme, analist raporu stres testi, kıyaslama ve daha fazlası — GitHub adresinde bulunabilir.

Denemesi ücretsiz.

Kullanıcı başına aylık 100 ücretsiz kredi. Aramalar ve dosyalama listelemeleri her zaman ücretsizdir; çıkarma ve arama çağrıları sonuç başına fiyatlandırılır. Uluslararası kapsam (Japonya, Çin, Hong Kong ve Singapur) kurumsal müşterilere sunulur.

Kurulum Talimatları

Öncelikle, ücretsiz bir Revelata hesabı oluşturun — Kaydol.

Ardından, sunucuyu Claude Desktop, Claude.ai ve benzer istemcilerle kullanmak için aşağıdaki talimatları izleyin.

Not: OpenClaw, MCP sunucumuzu kullanmaz; REST API ve DEEPKPI_API_KEY kullanır. Bkz. skills/_common/deepkpi-api.md. Barındırılan API belgeleri: deepkpi-api.revelata.com/docs.

Temel kurulum (Claude)

  1. Aşağıdaki MCP sunucu URL'sini kopyalayın 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

Ayrıntılar: README.md.

Hâlâ takıldınız mı?