get_filings — the disclosures of an issuer in a date range, with the receipt.
get_filings · on the record
read at render: list_nodes at https://mcp.getissuer.ai/mcp and the gate's receipt counter
get_filings is the disclosures of an issuer in a date range: an issuer by ticker, ISIN or LEI plus a date range returns every filing and release on the record for that issuer in that range, each with its type, its date, its source page and its read date — signed by the node of the issuer's market and receipted. Served from the record as read; nothing new is collected and nothing is inferred.
1 What it answers
- 1.1
- Input: issuer (ticker, ISIN or LEI) · from (ISO date) · to (ISO date, default today) · market (optional; the owning node resolves it if absent).
- 1.2
- Output: every disclosure line on the record for the issuer dated in the range, oldest first — date, type, category, title, source page, read date, reference — each line signed as served; the answer signed by the node and its RCO receipt (id, hash).
- 1.3
- Types: the record's own (results, agm_egm, directors_dealings, auditor_change, listing, delisting, name_change and the rest of the market's classes); a market whose record does not carry a type says so.
2 Who it is for
Compliance, research and surveillance agents that need what an issuer disclosed, and when, before they act or cite it.
3 What it is not
Not a news feed. Not a document archive: each line links to the source. Not a summary. Not a restated history.
4 The tool
| typed error | when |
|---|---|
unknown_issuer | no issuer on the register for this identifier |
ambiguous | more than one listing matches; the candidates are named |
not_on_record | the market's record does not carry this field; the market and the record's reason are named |
invalid_request | a required argument is missing or not a date |
- 4.1
- One call:
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_filings","arguments":{"issuer":"NASDAQ:AAPL","from":"2026-01-01","to":"2026-06-30"}}}athttps://mcp.getfilings.ai/mcp. - 4.2
- Every answer is signed by the node of the issuer's market (EdDSA, kid allooloo-cmr-2026-10, keyring allooloo.ai/.well-known/jwks.json) and receipted at
https://mcp.rco-records.ai/mcpwith the node as writer; verify_receipt is public. - 4.3
- Paying for a read: every read is free unless the agent asks for the offer (header
x402-pay: 1); the door then answers HTTP 402 with a signed offer and the same call carries the payment and the receipt — data-paygo.ai.
5 Access
{
"mcpServers": {
"getfilings": {
"type": "http",
"url": "https://mcp.getfilings.ai/mcp"
}
}
}claude mcp add --transport http getfilings https://mcp.getfilings.ai/mcp
- 5.1
- Door:
https://mcp.getfilings.ai/mcp— the same router ashttps://mcp.getissuer.ai/mcp: index only; read-only, no authentication, no account. The call is routed to the node of the issuer's listing; the node reads the record, signs and receipts. - 5.2
- Agent Card (A2A):
https://agent.getfilings.ai/.well-known/agent-card.json. - 5.3
- Every node door answers get_filings for its own market (
mcp.<market>-cm-kg.ai/mcp). - 5.4
- Registry entry:
registry.modelcontextprotocol.io · io.github.allooloo/getfilings.
6 Machine kit
- 6.1
/llms.txt·/index.md·/facts.json·/.well-known/agent-card.json·/.well-known/mcp.json·/.well-known/x402.json·/.well-known/security.txt·/sitemap.xml·/robots.txt·/mcp.json- 6.2
- Forwards here (301, whole zone): getfilings.io.