# Clous

> Entity-resolved, agent-native API for SEC / EDGAR filings. Every filing is resolved
> to one canonical entity (with domain + people), delivered through a hosted MCP server
> and one consistent JSON envelope, with confidence and freshness on every enriched field.
> All data is derived from public SEC EDGAR filings. Clous is independent of the SEC.

## Endpoints
- API base: https://api.clous.ai
- OpenAPI 3.1: https://api.clous.ai/openapi.json
- MCP server (HTTP/SSE): https://mcp.clous.ai
- Dashboard + API playground: https://app.clous.ai
- Sign up (100 free credits, verified companies only): https://app.clous.ai/signup
- Auth: `Authorization: Bearer clous_live_...` (REST and MCP)

## Conventions
- One response envelope for every endpoint/tool: { data[], page{ limit, next_cursor, has_more }, as_of, source, warnings }
- Every record carries: entity_id, source, source_url, filed_at, ingested_at, as_of
- Enriched (non-source) fields are { value, confidence, source, as_of } — never bare facts
- Cursor pagination (no offset, no 10,000-result ceiling); typed params (no query DSL)
- Errors are explicit: empty_result | entity_unresolved | not_found | invalid_param | rate_limited

## URL patterns (public, indexable)
- Company / entity:  https://clous.ai/company/{slug}
- Filing:            https://clous.ai/filing/{accession}
- Raise hubs:        https://clous.ai/raises , /raises/{sector} , /raises/{state}

## MCP tools (live or shipping) — with credit cost per call
- search_form_d(sector?, state?, min_amount?, exemption?, is_506c?, new_only?, repeat_only?, fund_or_company?, date_range?)  [5 credits]
- recent_raises(days?, sector?)  [5 credits]
- get_raise_signals(entity_id)  [3 credits]
- resolve_identifier(cik?, crd?, cusip?, ticker?, lei?, name?, domain?)  [2 credits]
- get_entity(entity_id)  [2 credits]
- search_entities(q, type?, state?)  [5 credits]
- search_advisers(...), get_manager_holdings(...)  [5 credits, shipping as ADV/13F land]
- entity_graph / full_profile  [20+ credits, Stage 5]

## Example queries
- "New 506(c) raises over $5M in fintech this month, with each issuer's domain and founders."
- "Resolve CIK 1967xxx to a canonical entity and list every filing it has made."
- "Recent private placements in California by repeat issuers."

## Coverage
- Live: Form D (private placements / exempt offerings)
- Rolling out: Form ADV, 13F, 13D/13G, Form C, Reg A, N-PORT/N-CEN, Forms 3/4/5, 8-K events,
  XBRL financials, full-text search, enforcement & litigation.

## Pricing (credits — paid-only, usage-metered)
- Everything is paid and metered in credits; each call debits credits by endpoint weight (see costs above).
- Free credits: 100, verified companies only (company domain + LinkedIn + website + phone verified), one-time — then buy a pack.
- One-time credit packs (bigger = cheaper per credit):
  - Starter $29 -> 30,000 credits
  - Builder $99 -> 120,000 credits
  - Scale   $399 -> 600,000 credits
  - Business $1,500 -> 3,000,000 credits
- Optional monthly plans bundle an included allotment + discounted overage.
- Enterprise: custom volumes, cross-source graph + full profiles, bulk export, redistribution license.
- Cost control: at 0 balance, calls return HTTP 402 Payment Required (hard stop — no surprise bills).
- Pricing page: https://clous.ai/pricing

## Docs
- API + MCP guide: https://clous.ai/docs
- Agent guide:     https://clous.ai/agents
- Playground:      https://app.clous.ai