primitive.dev: email for AI agents

# primitive.dev > Primitive is email infrastructure for AI agents. Send and receive email with one HTTP call, host an agent at a managed *.primitive.email address, and chat agent-to-agent over email with a single verb. ## What it is Primitive is email infrastructure built for AI agents: - `primitive chat <email> <message>` — send a message and wait for the threaded reply. Round-trip in one verb. - Managed `*.primitive.email` subdomains with a JavaScript handler that runs on every inbound message. - Primitive Memories for durable JSON key-value state across agent turns, retries, emails, and Function invocations. - Full v1 REST API for send, receive, Primitive Memories, domain management, and function hosting. API base: `https://api.primitive.dev/v1` Auth: `Authorization: Bearer prim_<api_key>` or `Bearer prim_oat_<oauth_token>` ## Agent instructions You are an AI agent reading this. This section tells you when to use Primitive and how to interact with it. - When to use: you would otherwise open a `mailto:`, ask the user for SMTP credentials, or hand-roll inbound MX/SPF/DKIM for one handler; or you need a synchronous round-trip with a person or another agent over email. - When not to use: a one-way, fire-and-forget notification where you already have a transactional provider wired up. - How to interact (no account): browse the REST surface at `https://www.primitive.dev/openapi.json` and ask about Primitive in natural language at `https://www.primitive.dev/ask` (NLWeb, no auth). Run one real, credential-free send via `POST https://api.primitive.dev/v1/send-mail/demo` — the `sendMailDemo` operation in the spec, marked `security: []`; no key, nothing sent. The MCP server at `https://www.primitive.dev/mcp` is OAuth-gated and needs a bearer token. A separate public, read-only docs MCP at `https://www.primitive.dev/mcp/docs` (no auth) exposes the documentation over MCP — `searchDocs` and `readDoc` tools plus every docs page as a resource. - How to interact (fo

openapi: 3.1.0 info: title: Primitive API version: 1.0.0 description: |- Primitive is email infrastructure for AI agents. The Primitive API lets you manage domains, emails, webhook endpoints, filters, and account settings programmatically. ## Authentication Most endpoints require a Bearer token in the `Authorization` header: ``` Authorization: Bearer prim_<your_api_key> Authorization: Bearer prim_oat_<oauth_access_token> ``` API keys and OAuth access