Developers
Terradium for agents
Terradium's machine surface lives on https://api.terradium.io. This marketing site publishes docs, the OpenAPI document, and agent files. It is not the API host and it is not the MCP server. Live product version is v1.0.7. Confirm with GET https://api.terradium.io/healthz (no auth).
REST (content API)
Read-only published posts, API-key gated under /api/v1/public/content/{projectId} on the API host. Send X-API-Key: td_live_.... Single-post markdown is available with Accept: text/markdown. See the API reference and /openapi.json.
MCP
Endpoint: https://api.terradium.io/api/v1/mcp. Authenticate with a project-scoped token. Prefix: td_mcp_. Send Authorization: Bearer td_mcp_... or X-API-Key. Writes need that project token and an active subscription. A content td_live_ key cannot write. Create a token in the dashboard under Project settings, Agent (MCP). Guide: Agent access.
How an agent should proceed
- Read /llms.txt.
- Read /openapi.json.
- Call MCP at the API host above. Do not POST MCP to terradium.io.
CLI
The published CLI is the embed installer, not a second product API: npx terradium init. It scaffolds @terradium/embed on a customer site. There is no Homebrew or PyPI package.
Pricing lock
$29 is writer plus 50 prompts weekly, 2 to 3 engines, 1 run. $95 only after daily, country, and AIO answers are live. Do not treat $29 as daily 50 prompts times 4 engines times 3 runs.