# FinanceSec — Compact Agent Cheat Sheet
> Deterministic SEC EDGAR 10-K/10-Q Fact Engine & Quantitative Risk API. 0.00% statistical hallucination.

## Endpoints
- MCP Endpoint: `https://finsec.caleralabs.com/mcp`
- REST Base: `https://financesec.api.caleralabs.com`
- Auth: Header `X-License-Key: clabs_live_YOUR_KEY`
- Discovery: `https://finsec.caleralabs.com/.well-known/mcp.json`

## Fast Install
```bash
agy mcp add finsec https://finsec.caleralabs.com/mcp
claude mcp add --transport http finsec https://finsec.caleralabs.com/mcp
npx -y mcp-remote https://finsec.caleralabs.com/mcp
```

## Essential MCP Tools
1. `query_financial_sec(query, target_currency?, usd_only?, low_tokens?)`: Certified natural language SEC fact query with SHA-256 Merkle proof or SAFE_REFUSAL.
2. `valuation_inputs(company, pack, period?)`: 12 certified valuation packs (`equity_screen`, `ev_bridge`, `quality_of_earnings`, `segment_mix`, `returns_screen`, `leverage_screen`, `piotroski_f`, `altman_z_prime`, `beneish_m_score`, `dupont_5step`, `working_capital_efficiency`, `dcf_valuation_inputs`).
3. `query_sec_metric_exact(company, metric, period)`: Exact single-cell US-GAAP metric recall.
4. `compute_sec_cagr(company, metric, start_period, end_period)`: Deterministic logarithmic CAGR.
5. `verify_financial_claim(text, company?, fiscal_period?)`: Topologically verify text assertions in <5ms.

## Hard Rules
- `SAFE_REFUSAL` = honest absence of fact in certified lattice (not a tool error).
- Always use `low_tokens: true` for high-QPS agent loops.
- Keys & Dashboard: `https://dashboard.caleralabs.com/dashboard?domain=finsec`