# Revelata deepKPI

Fundamental data, including operating KPIs, you can't even find on Bloomberg — pre-structured, fully cited, and agent-ready.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add revelata/deepkpi-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list revelata/deepkpi-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get revelata/deepkpi-mcp search_kpis

# Call a tool
npx -y @smithery/cli@latest tool call revelata/deepkpi-mcp search_kpis '{}'
```

## Direct MCP Connection

Endpoint: `https://deepkpi-mcp--revelata.run.tools`

## Tools (10)

- `search_kpis` — Search for KPIs of a company by semantic similarity. Each result costs 1 credit (max 15). Default is 3 — start small an…
- `list_kpis` — List all available KPIs for a company, organized by category. This is free and the recommended first step before callin…
- `query_company_id` — Look up a company's identifier by name. For US companies, this is the SEC CIK value.
- `get_company_summary` — Fetch a narrative company summary derived from the company's latest 10-K. Costs 3 credits per successful call. For US c…
- `get_company_segments` — Fetch a structured breakdown of business segments derived from the company's latest 10-K. Costs 3 credits per successfu…
- `company_summary_search` — Find companies by semantic similarity to their 10-K-derived company summary. Costs 1 credit per company returned (max 1…
- `list_sec_filing_markdowns` — List SEC filings available as markdown for a given CIK. Free (no credits). Use this to discover valid `acc_no` and `seq…
- `get_sec_filing_markdown` — Fetch the markdown content for a specific SEC filing (`acc_no`) and sequence (`seq_no`, default 1). Costs 10 credits pe…
- `list_sec_markdowns` — DEPRECATED alias. Use `list_sec_filing_markdowns`.
- `get_sec_markdown` — DEPRECATED alias. Use `get_sec_filing_markdown`.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get revelata/deepkpi-mcp <tool-name>
```