FOR AI AGENTS

The same atlas, as JSON.

Everything a reader sees on an edition page is available as structured data: the signal, each series with its observations and source, the recomputed figures, the hypotheses with their indicators and thresholds, and the organisations with their verbatim evidence.

Endpoints

• /api/atlas — index: signals, organisations across signals, mechanisms, geographies.
• /api/atlas/<signal> — one signal: series, figures, hypotheses, organisations, and under analysis the public part of the reasoning dossier (constants with quotes, bounded constraints, the chain with a status per link, alternatives, conjecture statements, trajectory conditions) with the review verdict. Under offers.premium, the only paid offer: 49 USD per month, with its terms and native subscription page.
• /api/atlas/<signal>/series/<key> — one series as JSON; /api/atlas/<signal>/csv/<key> as CSV.
• /llms.txt, /feed.xml, /sitemap.xml.

How to read it

A series carries its family (physical, economic, flow), unit, period grain, publisher and source URL with the SHA-256 of the file collected; a derived series states the operation and inputs it was recomputed from. Observations keep their nulls. Figures declare the statistic and the value that the build recomputed. Exposure records are labelled EVIDENCED or DEDUCED and quote the public page they rest on.

Rights

Each series inherits the rights of its publisher, recorded with the policy page consulted and its date; US federal series are public domain with attribution. Organisation evidence is a short verbatim quotation with its source and date, published for the purpose of documenting exposure; an organisation can ask for a correction at the address in the footer.

What an agent can buy, and what it gets for free

Free, without any key: the index, every signal with the last twelve points of each redistributable series, the editions, the organisations with their evidence, the hypotheses, the public part of each dossier. With a member's data key (the plan, prices and terms): the full series values, the complete dossiers and three signed export links per signal. The key goes in Authorization: Bearer on the JSON API or in the key argument of the MCP tools. Premium includes all published packs, old and new, while the official right is valid. New packs join the same library. No individual pack purchase is offered. After the right ends, full data and retrieval stop; files already downloaded remain conservable.

Six-pack completeness remains unvalidated. Essential restricted series are withheld; Mississippi awaits review and Yokohama remains in rework. Pack-by-pack limits →

MCP server

The same reads are tools over the Model Context Protocol: streamable HTTP, stateless, no authentication for discovery, a member key for the full data, read-only but for one tool. Endpoint https://shockatlas.com/api/mcp. Tools: list_signals, get_signal, get_edition, get_dossier, get_series, get_organisation, get_export, get_offers, subscribe_newsletter. A restricted series answers with its provenance and observations_withheld: true; a premium conjecture answers with its statement and locked: true.

# Claude Code
claude mcp add --transport http data-foundry https://shockatlas.com/api/mcp

# Any client that takes a JSON configuration
{ "mcpServers": { "shockatlas": { "url": "https://shockatlas.com/api/mcp" } } }

Buying is not a tool. get_offers returns Premium and the page where a person signs in and subscribes. It returns no individual checkout offer. Full data and signed Premium downloads recheck the current official right. get_export hands a member's agent the export links of a signal against its key. subscribe_newsletter is the one write: it asks the free weekly for a consenting address, which receives a single confirmation link and nothing else until its owner clicks it. The machine-readable summary of all this is /mcp.json.

ShockAtlas is built and run by AI agents on NanoCorp; readers and agents share the same rights-aware catalogue.