Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Clous MCP server Search for Apple's latest 10-K filing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Public data intelligence for AI agents — over the Model Context Protocol.
Point Claude, Cursor, or any MCP client at Clous and search SEC/EDGAR filings, pull XBRL financials, insider trades, 13F holdings, Form D raises, and material events — all through one consistent, cited JSON envelope.
clous.ai · docs.clous.ai · hosted MCP · 49 tools
A thin, open-source MCP client. It forwards tool calls to
https://api.clous.aiusing your API key (theCLOUS_API_KEYenv var). No key or secret is bundled. All data derives from public SEC EDGAR filings; Clous is independent of the SEC. SEC/EDGAR is live today; Clous is expanding across public data.
Get a free key at clous.ai (100 credits, no card — looks like clous_live_...), then add Clous to your MCP client:
Claude Desktop — claude_desktop_config.json (Settings → Developer → Edit Config) · Cursor — .cursor/mcp.json:
{
"mcpServers": {
"clous": {
"command": "npx",
"args": ["-y", "@clousai/mcp"],
"env": { "CLOUS_API_KEY": "clous_live_..." }
}
}
}Restart the client and ask: "What material 8-Ks did NVIDIA file this week?" — Clous answers with each accession and EDGAR URL cited.
Clous runs a hosted MCP endpoint at https://mcp.clous.ai — no local Node, no npx. See docs.clous.ai for the remote config.
Related MCP server: mcp-edgar
49 tools spanning filings, full-text, financials, ownership, governance, enforcement, events, and monitors.
Entity-resolved — every record ties to a canonical company (CIK / ticker / name).
One JSON envelope — { data[], page, as_of, source, query_echo, warnings } with cursor pagination.
Token-efficient — fields= / output_schema= projection trims payloads before they hit your context window.
Cited by construction — every result carries its source filing and EDGAR URL.
Bring your own key — open-source, no secrets bundled; works locally via npx or hosted.
Tool | What it does |
| EDGAR filing index across all form types |
| Full-text search over filing bodies (2001+) |
| Look up companies by CIK / ticker / name |
| XBRL financial facts for a company |
| Form 3/4/5 insider trades |
| Full structured detail of one ownership filing |
| 13D/13G filings |
| 13F institutional holdings |
| Form ADV investment advisers |
| Form D private-placement raises |
| A named item (Risk Factors, MD&A, …) from a 10-K/10-Q/8-K |
| Classify an 8-K's reported items |
| Exhibit 21 subsidiaries from a 10-K |
| A filing's document manifest |
| 8-K Item 1.05 cybersecurity disclosures |
| Plan + remaining credits |
…and 33 more (13F managers, N-PORT fund holdings, enforcement, litigation, patents, monitors/webhooks, grounded Q&A). Full reference: docs.clous.ai · machine-readable llms.txt.
git clone https://github.com/ClousAI/Mcp.git clous-mcp
cd clous-mcp
npm install
npm run build
CLOUS_API_KEY=clous_live_... node dist/index.js # speaks MCP over stdioThen point your client's command at node with args ["/abs/path/clous-mcp/dist/index.js"]. For development, CLOUS_API_KEY=clous_live_... npm run dev runs via tsx with no build step.
Clous is public data intelligence for AI agents — entity-resolved signals from public records and the web, monitored in real time, delivered with citations. SEC/EDGAR is live today; expanding across public data.
Website | |
Docs | |
MCP server |
|
Claude Code plugin | |
Agent Skill | |
SDKs | |
Recipes | |
Framework tools |
|
PRs welcome. License: MIT.
Create a monitor: a standing watch on a ticker/CIK/company/form/event type that fires (and optionally webhooks) on matching events.
Inputs: name (required), target_type (required), target_value (required), signals, +2 more.
Register an https webhook endpoint to deliver monitor matches to.
Inputs: url (required), description.
Curated feed of SEC 8-K Item 1.05 material cybersecurity-incident disclosures.
Inputs: ciks, limit, cursor, date_to, +1 more.
Delete a monitor by id.
Inputs: monitor_id (required).
Extract a named item (e.g. Risk Factors, MD&A) from a 10-K/10-Q/8-K primary document.
Inputs: item (required), accession (required).
Full-text search across the body of every EDGAR filing since 2001.
Inputs: q (required), ciks, forms, limit, +3 more.
Classify the numbered items an 8-K reports (5.02 leadership, 4.01 auditor, 2.02 earnings) with excerpts.
Inputs: accession (required).
Plan and remaining credits for the configured API key.
Inputs: no named parameters.
Structured XBRL financial facts (every reported concept) for one company by CIK.
Inputs: cik (required), concept.
Structured Reg CF Form C crowdfunding offering — issuer, offering terms, and financial disclosures.
Inputs: accession (required).
Get a single event by id with full evidence.
Inputs: event_id (required).
Full structured detail of a single Form 3/4/5 ownership filing — owners, every trade, holdings, footnotes.
Inputs: accession (required).
Get a single monitor by id.
Inputs: monitor_id (required).
Structured N-PX fund proxy-voting records for a filing — per meeting: issuer/CUSIP, matter, shares voted, vote, recommendation.
Inputs: accession (required), limit, cursor.
Subsidiaries disclosed in a 10-K's Exhibit 21 (name + jurisdiction).
Inputs: accession (required).
Query the events feed — typed, evidence-backed SEC business-change events (executive changes, new filings, insider sells, …).
Inputs: cik, limit, cursor, ticker, +3 more.
List a filing's document manifest — every file, its type, size, and direct URL.
Inputs: accession (required).
List the monitors (standing watches) on your account.
Inputs: no named parameters.
Dataset catalog + freshness — every live Clous dataset, its endpoint, record count, and last sync (public).
Inputs: no named parameters.
List the webhook delivery log for your endpoints.
Inputs: limit, endpoint_id.
List your registered webhook endpoints.
Inputs: no named parameters.
Resolve and look up companies in the entity directory by CIK, ticker, or name.
Inputs: q, cik, sic, limit, +4 more.
Search 13F institutional holdings (manager → security positions).
Inputs: cusip, limit, cursor, issuer, +2 more.
Search 13F institutional investment managers by name, with minimum reported AUM.
Inputs: q, limit, cursor, aum_min.
Search Form ADV registered investment advisers.
Inputs: q, limit, state, cursor, +1 more.
Search 13D/13G beneficial-ownership filings.
Inputs: role, limit, cursor, issuer, +7 more.
Search extracted board members / directors across organizations.
Inputs: ein, role, limit, cursor, +5 more.
Search registered broker-dealers (Form BD) by CRD, name, status, and office location.
Inputs: name, limit, bd_crd, cursor, +5 more.
Search executive-compensation records extracted from proxy statements (salary, bonus, awards, total).
Inputs: limit, cursor, filer_cik, fiscal_year, +6 more.
Search SEC/agency enforcement actions by respondent, agency, action kind, date, and penalty.
Inputs: limit, agency, cursor, date_to, +5 more.
Search the EDGAR filing index across all form types, filterable by company CIK, form type, date range, and keyword.
Inputs: q, cik, sic, limit, +6 more.
Search XBRL company-facts financial concepts across companies (one row per reported fact).
Inputs: q, cik, form, unit, +10 more.
Search structured XBRL financial-statement facts (Financial Statement Data Sets) by company, tag, and period.
Inputs: cik, sic, tag, uom, +8 more.
Search Form 144 proposed-sale notices (insiders' intent to sell restricted/control stock).
Inputs: limit, cursor, issuer_cik, min_shares, +5 more.
Search Form CRS customer relationship summaries (firm services, fees, conflicts, disciplinary history).
Inputs: limit, cursor, firm_crd, filer_cik, +6 more.
Search Form D private-placement capital raises.
Inputs: q, limit, state, cursor, +2 more.
Search N-PORT registered-fund portfolio holdings (mutual funds / ETFs → security positions).
Inputs: isin, cusip, limit, cursor, +14 more.
Search N-CEN registered-fund service providers (custodians, advisers, administrators, etc.).
Inputs: role, limit, cursor, provider, +4 more.
Search IAPD/BrokerCheck individual investment-adviser representatives and brokers.
Inputs: name, limit, cursor, bc_scope, +9 more.
Search Form 3/4/5 insider transactions by issuer, owner, transaction code, date, and value.
Inputs: limit, owner, cursor, issuer, +9 more.
Search SEC litigation releases by defendant, title, action type, and date.
Inputs: limit, title, cursor, date_to, +4 more.
Search NT (Notification of Late Filing) records — companies that filed Form 12b-25 for a late 10-K/10-Q.
Inputs: limit, cursor, filer_cik, form_type, +4 more.
Search USPTO patent grants by assignee, title, classification, and grant date.
Inputs: limit, title, cursor, assignee, +9 more.
Search private-fund ownership/control relationships disclosed on Form ADV.
Inputs: crd, limit, cursor, firm_name, +3 more.
Search aggregate private-fund statistics from Form PF (per quarter, tab, and metric).
Inputs: limit, cursor, row_key, tab_name, +4 more.
Search executive officers and directors disclosed in proxy statements (DEF 14A).
Inputs: cik, name, limit, title, +5 more.
Search SEC trading-suspension orders by company name, release number, and date.
Inputs: limit, cursor, company, date_to, +2 more.
Search SEC whistleblower award orders by fiscal year, amount, and summary.
Inputs: limit, cursor, fiscal_year, award_order_no, +3 more.
Update a monitor — pause/resume (status), rename, or change signals/materiality/webhook.
Inputs: monitor_id (required), name, status, signals, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 49 tools
Most tools target distinct SEC datasets with clear names, but clusters like search_financials/search_financial_statements/get_company_financials and search_proxy_officers/search_board_members could confuse an agent. Overall, the purpose of each tool is identifiable, but some overlap exists.
The dominant pattern is verb_noun (search_*, get_*, list_*, create_*, update_*, delete_*), but a few tools deviate: 'full_text_search' reverses the order, 'cyber_incidents' is a bare noun, and 'resolve_entity' uses a non-standard verb. These are minor relative to the many consistent names.
With 49 tools, the server exceeds the 25-tool threshold that marks 'too many'. While the breadth reflects a comprehensive SEC data platform, the sheer number burdens an agent with selection overhead, and many search_* tools could be consolidated.
The tool surface covers a wide range of SEC datasets (filings, financials, insider activity, funds, governance, enforcement, patents) plus account management and monitoring. It provides thorough lifecycle coverage including create/update/delete for monitors and webhooks, leaving no obvious dead ends.
Access SEC filings, insider transactions, and financial data via the ShareSEER API.
SEC EDGAR company lookup, filings, XBRL financials and filing text. Pay per call in USDC via x402.
Search SEC EDGAR filings, financial statements, and company data.
SEC filings and financials with accession links, insider and congress trades, macro. OAuth or key.
