# filing-intelligence

SEC filing intelligence for AI agents. Financials, filing analysis, screening, XBRL.

## Quick Start

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

# Browse available tools
npx -y @smithery/cli@latest tool list metricduck/filing-intelligence

# Get full schema for a tool
npx -y @smithery/cli@latest tool get metricduck/filing-intelligence search_companies

# Call a tool
npx -y @smithery/cli@latest tool call metricduck/filing-intelligence search_companies '{}'
```

## Direct MCP Connection

Endpoint: `https://filing-intelligence--metricduck.run.tools`

## Tools (9)

- `search_companies` — Search for companies by name or ticker with intelligent fuzzy matching.
- `get_company_overview` — Get comprehensive financial overview for a company in a single call.
- `get_financials` — Get multi-period financial statements: income statement, balance sheet, and cash flow in one call.
- `get_filing_intelligence` — Triage layer for SEC filings — ranked signals with drill-down pointers to specific sections.
- `compare_companies` — Compare a company against its peers with 70+ metrics, sector percentile rankings, and trends.
- `screen_companies` — Screen companies by financial criteria. Find stocks matching metric thresholds.
- `list_filings` — Browse a company's SEC filings and discover available sections before reading content.
- `get_filing_section` — Read a specific section from an SEC filing (10-K, 10-Q, or 8-K earnings).
- `get_xbrl_facts` — Search and extract raw XBRL facts from SEC filings.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get metricduck/filing-intelligence <tool-name>
```
