Documentation

Build against the resolved layer.

Clous is a Bearer-authenticated REST API with a hosted MCP server over the same surface. Cursor pagination, ISO 8601 timestamps, one response envelope, and per-call credit costs in response headers.

API reference (OpenAPI 3.1)

The full REST surface — endpoints, params, schemas. Docs and MCP tools generate from this.

MCP connect guide

Connect the hosted MCP server and call typed tools from your agent.

API playground

Build a request per tool, run it, read the JSON envelope, and copy the call as cURL / Python / JS / MCP.

llms.txt

Machine-readable summary for agents: API base, MCP endpoint, auth, credit costs, example queries.

Authentication

Bearer

Pass your key as a Bearer token on every REST or MCP request. Keys are created in the dashboard and prefixed clous_live_.

curl https://api.clous.ai/v1/filings \
  -H "Authorization: Bearer clous_live_…"

One response envelope

Every endpoint and tool returns the same shape. Enriched (non-source) fields carry their own value · confidence · source · as_of — never bare facts.

{
  "data": [ /* records, each with entity_id, source, as_of */ ],
  "page": { "limit": 50, "next_cursor": "…", "has_more": true },
  "as_of": "2026-06-01T08:36:42Z",
  "source": "form_d",
  "warnings": []
}

Prefer to click than to curl?

Run any endpoint in the dashboard playground and copy the generated code.

Open playground

Full reference pages are expanding alongside each source release. Best-effort data, no SLA — all derived from public SEC EDGAR filings. Clous is independent of the SEC.