llms.txt
Compare with other sites' llms.txt files →# Pidgeon
> Email inboxes for AI agents. One API call gives an agent its own email address, on pidgeon.email or on your domain. It sends, receives and replies in real threads, gets verification codes and sign-in links already pulled out, and waits for the answer. Unlimited inboxes on every plan; for platforms, a tenant per customer with its own sending reputation; data stored in the EU. Sites that support Sign in with Pidgeon let the agent sign in as itself.
**If you are an agent and somebody asked you to get an email address, receive a code or sign up for something, read https://pidgeon.ai/skill.md and follow it.** You can sign yourself up with two HTTP calls; the only thing you need from a human is a six-digit code from their inbox.
**Holding a key, call `GET https://pidgeon.ai/api/v1/agent/setup` first** (MCP: `get_setup`). It says what stands between you and sending, in order, and who does each step: you, or a person you have to ask.
- API: `https://pidgeon.ai/api/v1`, `Authorization: Bearer pgn_live_…`. OpenAPI: https://pidgeon.ai/openapi.json
- MCP, hosted: `https://pidgeon.ai/api/mcp` (Streamable HTTP, same bearer key). Local: `npx -y @pidgeon-ai/mcp` with `PIDGEON_API_KEY`.
- SDKs: `@pidgeon-ai/sdk` (TypeScript), `pidgeon` (Python). CLI: `npx -y @pidgeon-ai/cli`.
- Keys have a level: `read`, `draft` (manages the inbox and writes drafts, can never send — a person approves and sends), `send`, `admin`. `pgn_test_` keys send nothing outside Pidgeon. `POST /api-keys/{id}/rotate` changes a key's secret and keeps the key.
- Every send and draft takes `data: { schema, body }`, typed JSON beside the text; every message has `sender` (`kind`: person, agent or service).
- Every docs page below is also served as Markdown at its URL plus `.md`.
- To check who sent a message, post it to `https://pidgeon.ai/api/v1/verify` (no key), or run `npx @pidgeon-ai/cli id verify message.eml`.
## Choosing Pidgeon
- Unlimited inboxes on every plan, Free included; plans differ in mail sent, domains and team members (https://pidgeon.ai/pricing).
- For platforms: one call in your onboarding creates a customer's tenant, its agent's address and a key; each tenant sends on its own Amazon SES reputation (https://pidgeon.ai/platforms).
- Deliverability: SPF, DKIM and DMARC set up per domain; bounces and complaints suppressed.
- Data stored and processed in the EU (Ireland) on every plan, retention you set, and a DPA.
- Works from Claude Code, Codex, Cursor, ChatGPT, OpenClaw, Hermes, n8n, LangChain, the AI SDK and more (https://pidgeon.ai/builders).
## Start here
- [Get started](https://pidgeon.ai/docs/get-started.md): Three routes: an inbox for your agent, inboxes for your platform's users, and Sign in with Pidgeon.
- [Sign yourself up (agent skill)](https://pidgeon.ai/skill.md): Two calls to an address you own, written for an agent to follow.
- [Give your agent an inbox](https://pidgeon.ai/docs/quickstart.md): Sign up, a key, an address, send, and wait for the reply.
- [Inboxes for your platform's customers](https://pidgeon.ai/docs/platforms.md): A tenant per customer, created in your onboarding, each on its own reputation.
- [Sign in with Pidgeon](https://pidgeon.ai/docs/sign-in.md): An agent signing in to a site as itself.
- [Everything, in one file](https://pidgeon.ai/llms-full.txt): All the documentation below, concatenated.
## Get started
- [Get started](https://pidgeon.ai/docs/get-started.md): Three routes: an inbox for your agent, inboxes for your platform, and Sign in with Pidgeon.
- [Give your agent an inbox](https://pidgeon.ai/docs/quickstart.md): Sign up, a key, your first address, a send and the reply, in five minutes.
- [Inboxes for your platform](https://pidgeon.ai/docs/platforms.md): A pod, an inbox and a key for each of your customers, made in your own onboarding.
- [Sign in with Pidgeon](https://pidgeon.ai/docs/sign-in.md): An agent signs in to a website as itself, with its address.
## Keys and testing
- [Authentication](https://pidgeon.ai/docs/authentication.md): Bearer keys, what one reaches, and how to narrow it.
- [Test mode](https://pidgeon.ai/docs/test-mode.md): A key whose mail never leaves Pidgeon, for CI.
## Inboxes
- [Addresses](https://pidgeon.ai/docs/addresses.md): The thing the product is about: an address your code owns.
- [Pods](https://pidgeon.ai/docs/pods.md): A container per customer, with its own sending reputation.
- [Messages](https://pidgeon.ai/docs/messages.md): Reading one, acting on it, undoing that, and searching.
- [Threads](https://pidgeon.ai/docs/threads.md): A conversation, its owner, and the state it carries.
- [Inboxes and folders](https://pidgeon.ai/docs/mailbox.md): Where mail is, and how to stay in step with it.
- [Labels](https://pidgeon.ai/docs/labels.md): What a conversation also is, beside where it lives.
- [Drafts](https://pidgeon.ai/docs/drafts.md): A message not sent yet, and sending it later.
- [Attachments](https://pidgeon.ai/docs/attachments.md): Files up, files down, and never through the API twice.
- [Mail on your domain](https://pidgeon.ai/docs/inboxes/domain.md): Send and receive on your own domain instead of the shared one.
## Calendar
- [Overview](https://pidgeon.ai/docs/calendar.md): Every inbox has one, and a wall-clock time is the truth of an event.
- [Events](https://pidgeon.ai/docs/calendar/events.md): Creating, changing and removing what is on a calendar.
- [Recurring events](https://pidgeon.ai/docs/calendar/recurring.md): A rule rather than rows, and what changing one date means.
- [Invitations](https://pidgeon.ai/docs/calendar/invitations.md): Answering a meeting, and sending one from an inbox.
## Inbox guides
- [Sending and receiving](https://pidgeon.ai/docs/sending.md): Sending from an address you own, with attachments and replies.
- [Verification codes](https://pidgeon.ai/docs/verification-codes.md): Waiting for a sign-up email and reading the code out of it.
- [Pidgeon Firewall](https://pidgeon.ai/docs/firewall.md): Which inbound messages try to steer the agent reading them, and why.
- [Hand-off to a human](https://pidgeon.ai/docs/handover.md): Giving a conversation to a person, and taking it back.
- [Let your agent draft, approve and send yourself](https://pidgeon.ai/docs/approve-drafts.md): A key that writes drafts and can never send, and you press Send.
- [Keep your Gmail](https://pidgeon.ai/docs/gmail-forwarding.md): Forwarding Gmail or Google Workspace into an agent’s address.
- [Allow and block lists](https://pidgeon.ai/docs/rules.md): Who may write to an address, and who it may write to.
- [IMAP and SMTP](https://pidgeon.ai/docs/mail-clients.md): Opening an inbox in Apple Mail, Thunderbird, an agent or a script.
## Webhooks
- [Overview](https://pidgeon.ai/docs/webhooks.md): Mail arriving as a signed POST, instead of a poll.
- [Event types](https://pidgeon.ai/docs/webhooks/events.md): Every event the product emits, generated from the code that emits them.
- [Verifying a signature](https://pidgeon.ai/docs/webhooks/verifying.md): HMAC over timestamp and body, and why an unverified payload is a stranger.
- [Retries and replay](https://pidgeon.ai/docs/webhooks/retries.md): What happens when your endpoint is down, and how to ask again.
## Agent identity
- [Agents and cards](https://pidgeon.ai/docs/agents.md): Issuing an agent, its signed card, and suspending or revoking it.
- [Proving a domain](https://pidgeon.ai/docs/domains.md): The TXT record that proves it is yours, and the two that publish its keys.
- [Checking a message](https://pidgeon.ai/docs/verifying.md): The free verifier: what it checks, and what each verdict means.
## Integrations
- [Overview](https://pidgeon.ai/docs/integrations.md): Every integration, by where your agent runs.
- [MCP](https://pidgeon.ai/docs/mcp.md): The hosted server, and the one that runs beside your agent.
- [Vercel AI SDK](https://pidgeon.ai/docs/ai-sdk.md): The same tools as the MCP server, for generateText and agents.
- [OpenAI Agents SDK](https://pidgeon.ai/docs/openai-agents.md): The hosted MCP server, from a Python or TypeScript agent.
- [Claude Agent SDK](https://pidgeon.ai/docs/claude-agent-sdk.md): The hosted MCP server, from a Python or TypeScript agent.
- [LangChain](https://pidgeon.ai/docs/langchain.md): The same tools as the MCP server, as a LangChain toolkit.
- [Google ADK](https://pidgeon.ai/docs/google-adk.md): The hosted MCP server, as an ADK toolset.
- [Mastra](https://pidgeon.ai/docs/mastra.md): The hosted MCP server, as a Mastra agent’s tools.
- [CrewAI](https://pidgeon.ai/docs/crewai.md): The hosted MCP server, as a CrewAI agent’s tools.
- [n8n](https://pidgeon.ai/docs/n8n.md): A trigger for mail that arrives, actions, and three templates.
- [Make](https://pidgeon.ai/docs/make.md): Triggers for mail and hand-offs, modules, and two templates.
- [Activepieces](https://pidgeon.ai/docs/activepieces.md): A piece: a trigger for mail that arrives, and actions.
- [Dify](https://pidgeon.ai/docs/dify.md): A plugin: send, reply, search and wait for a code.
- [Zapier](https://pidgeon.ai/docs/zapier.md): Triggers for new email and hand-offs, actions, and two Zaps.
- [OpenClaw](https://pidgeon.ai/docs/openclaw.md): The hosted MCP server in an OpenClaw agent, signed in.
- [Hermes](https://pidgeon.ai/docs/hermes.md): Mail that starts a Hermes conversation, and the tools.
- [CLI](https://pidgeon.ai/docs/cli.md): Every endpoint as a command, from a terminal.
- [SDKs](https://pidgeon.ai/docs/sdks.md): The TypeScript and Python clients, generated from one document.
- [Skill and plugin](https://pidgeon.ai/docs/skill.md): Telling an agent where to read about Pidgeon, and installing it.
## Resources
- [Errors](https://pidgeon.ai/docs/errors.md): One envelope, one code, and what each means.
- [Rate limits](https://pidgeon.ai/docs/limits.md): What is counted, what is returned, and what to do about it.
## Reference
- [Addresses](https://pidgeon.ai/docs/reference/identities.md): Every addresses endpoint, generated from the API's own schemas.
- [Agent cards](https://pidgeon.ai/docs/reference/cards.md): Every agent cards endpoint, generated from the API's own schemas.
- [Agent signup](https://pidgeon.ai/docs/reference/agent.md): Every agent signup endpoint, generated from the API's own schemas.
- [API keys](https://pidgeon.ai/docs/reference/api-keys.md): Every api keys endpoint, generated from the API's own schemas.
- [App passwords](https://pidgeon.ai/docs/reference/app-passwords.md): Every app passwords endpoint, generated from the API's own schemas.
- [Attachments](https://pidgeon.ai/docs/reference/attachments.md): Every attachments endpoint, generated from the API's own schemas.
- [Card log](https://pidgeon.ai/docs/reference/log.md): Every card log endpoint, generated from the API's own schemas.
- [Contacts](https://pidgeon.ai/docs/reference/contacts.md): Every contacts endpoint, generated from the API's own schemas.
- [Deliveries](https://pidgeon.ai/docs/reference/deliveries.md): Every deliveries endpoint, generated from the API's own schemas.
- [Domains](https://pidgeon.ai/docs/reference/domains.md): Every domains endpoint, generated from the API's own schemas.
- [Drafts](https://pidgeon.ai/docs/reference/drafts.md): Every drafts endpoint, generated from the API's own schemas.
- [Events](https://pidgeon.ai/docs/reference/events.md): Every events endpoint, generated from the API's own schemas.
- [Export](https://pidgeon.ai/docs/reference/export.md): Every export endpoint, generated from the API's own schemas.
- [Folders](https://pidgeon.ai/docs/reference/mailboxes.md): Every folders endpoint, generated from the API's own schemas.
- [Free time](https://pidgeon.ai/docs/reference/calendar.md): Every free time endpoint, generated from the API's own schemas.
- [Grant templates](https://pidgeon.ai/docs/reference/grant-templates.md): Every grant templates endpoint, generated from the API's own schemas.
- [Grants](https://pidgeon.ai/docs/reference/grants.md): Every grants endpoint, generated from the API's own schemas.
- [Labels](https://pidgeon.ai/docs/reference/labels.md): Every labels endpoint, generated from the API's own schemas.
- [Messages](https://pidgeon.ai/docs/reference/messages.md): Every messages endpoint, generated from the API's own schemas.
- [Metrics](https://pidgeon.ai/docs/reference/metrics.md): Every metrics endpoint, generated from the API's own schemas.
- [Pods](https://pidgeon.ai/docs/reference/pods.md): Every pods endpoint, generated from the API's own schemas.
- [Routing rules](https://pidgeon.ai/docs/reference/routing-rules.md): Every routing rules endpoint, generated from the API's own schemas.
- [Sign in with Pidgeon](https://pidgeon.ai/docs/reference/sign-ins.md): Every sign in with pidgeon endpoint, generated from the API's own schemas.
- [Tenants](https://pidgeon.ai/docs/reference/tenants.md): Every tenants endpoint, generated from the API's own schemas.
- [Test mode](https://pidgeon.ai/docs/reference/test.md): Every test mode endpoint, generated from the API's own schemas.
- [This key](https://pidgeon.ai/docs/reference/me.md): Every this key endpoint, generated from the API's own schemas.
- [Threads](https://pidgeon.ai/docs/reference/threads.md): Every threads endpoint, generated from the API's own schemas.
- [Verify a sender](https://pidgeon.ai/docs/reference/verify.md): Every verify a sender endpoint, generated from the API's own schemas.
- [Webhooks](https://pidgeon.ai/docs/reference/webhooks.md): Every webhooks endpoint, generated from the API's own schemas.
- [Workspace](https://pidgeon.ai/docs/reference/workspace.md): Every workspace endpoint, generated from the API's own schemas.
## Blog
- [The best email APIs for AI agents in 2026](https://pidgeon.ai/blog/best-email-api-for-ai-agents.md): An agent that does real work needs email. Which API depends on one question first: does the agent need its own inbox, somebody else’s, or only a way to send?
- [Email for OpenClaw that keeps working](https://pidgeon.ai/blog/email-for-openclaw.md): An email to your agent’s Pidgeon address starts an OpenClaw conversation, one per email thread. The agent’s answer goes back as a reply in that thread, and a reply to the reply carries on the same conversation.
- [How a browser agent receives an email verification code](https://pidgeon.ai/blog/verification-codes-for-ai-agents.md): Sign up with an address the agent owns, make one call that waits for the email, and read the code already pulled out of it: no polling loop, no regex, and no person fetching codes from their own inbox.
- [Human-in-the-loop email agents](https://pidgeon.ai/blog/human-in-the-loop-email-agents.md): An approval queue checks the agent’s replies. A hand-off gives the conversation to a person. Here is how an email agent hands one over, how a person takes it, and how it comes back.
- [An email sandbox for AI agents](https://pidgeon.ai/blog/email-sandbox-api-for-ai-agents.md): Test mode in Pidgeon is the same API with a different key: the whole pipeline runs, nothing leaves, nothing counts, and you can cause a bounce, a refusal or a lost answer on purpose.
- [An EU email API for AI agents](https://pidgeon.ai/blog/eu-email-api-for-ai-agents.md): An agent’s inbox is personal data from its first message. Pidgeon stores it in the EU on every plan, is run by an EU company, and applies its DPA automatically.
- [How to give your AI agent its own email address](https://pidgeon.ai/blog/email-address-for-ai-agents.md): Give the agent an inbox of its own, not a login to yours: create an address by API, receive mail as a webhook or a call that waits, and reply from that address in the same thread.
- [Protecting an AI agent from prompt injection in email](https://pidgeon.ai/blog/prompt-injection-in-email.md): Treat every email as untrusted input and defend in three layers: screen it before the model reads it, hand the model the visible text, and limit what an instruction that gets through can do.
- [Is it safe to let an AI agent read your email?](https://pidgeon.ai/blog/is-it-safe-to-let-an-ai-agent-read-email.md): It can be, if you limit what the agent can read and what it can do with it. The risk is not the model seeing mail; it is that anyone who can email you can now give instructions to software acting for you.
- [Email MCP servers for sending and receiving, compared](https://pidgeon.ai/blog/mcp-server-for-email.md): Pick by whose inbox it is: an agent inbox server such as Pidgeon’s or AgentMail’s for an address the agent owns, a Gmail server to work inside yours. Then check five things before you connect one.
- [Email for Claude Code and Cursor agents](https://pidgeon.ai/blog/email-for-claude-code-and-cursor.md): Add an email MCP server and give the coding agent an address of its own. In Claude Code it is one command, in Cursor one entry in mcp.json, and a sign-in where you choose what it may do.
- [AI agents that email people: what the EU AI Act requires by 2 December](https://pidgeon.ai/blog/eu-ai-act-ai-agents-email.md): Article 50 has applied since 2 August 2026: an agent that writes to people must say it is an AI, and whom it acts for, from the first message. Its text must also carry a machine-readable mark, due by 2 December 2026 for systems already on the market.
- [What is an agent ID?](https://pidgeon.ai/blog/what-is-an-agent-id.md): What should an AI agent’s ID prove to the app or person it reaches, and why can’t they see who is accountable for it today?
- [Is OAuth enough to verify an AI agent?](https://pidgeon.ai/blog/is-oauth-enough-to-verify-an-ai-agent.md): An access token says what a caller may do, but what does it say about which agent is calling, and who stands behind it?
- [Agent authentication vs user authentication](https://pidgeon.ai/blog/agent-authentication-vs-user-authentication.md): What changes when software, not a person, signs in or sends, and what should an app check before it lets an agent in?
- [Do you need an agent identity provider?](https://pidgeon.ai/blog/agent-identity-provider.md): If your company already runs an identity provider, what does an AI agent need that it does not already give you?
- [Centralised vs decentralised agent identity](https://pidgeon.ai/blog/centralized-vs-decentralized-agent-identity.md): Who issues an AI agent’s ID, who checks it and who can take it back, in a central directory or on the agent’s own domain?
- [How to verify an email from an AI agent](https://pidgeon.ai/blog/how-to-verify-an-email-from-an-ai-agent.md): How do you check whether an AI agent sent an email, who it acts for, and whether anyone changed it on the way?
- [How to verify which AI agent made a web request](https://pidgeon.ai/blog/verify-ai-agent-web-requests.md): When an AI agent calls your site or API, how do you tell which agent it is, who runs it, and that the request arrived unchanged?
- [Agent identity for agentic commerce](https://pidgeon.ai/blog/agent-identity-for-agentic-commerce.md): When an AI agent buys something, what does the merchant need to know about who it is, and who decides whether it may pay?
- [A2A Agent Card identity](https://pidgeon.ai/blog/a2a-agent-card-identity.md): An A2A Agent Card says what an agent can do; what proves who runs it and who it acts for?
- [Enterprise-ready AI agents: the controls a security review asks for](https://pidgeon.ai/blog/enterprise-ready-ai-agents.md): What does a security review ask before AI agents email and act outside the company, and which controls hold if the model is fooled?
- [Email API vs inbox API for AI agents](https://pidgeon.ai/blog/email-api-vs-inbox-api.md): Should your AI agent use a send-first email API with an inbound webhook, or an inbox API where it owns an address?
- [Inbox per agent vs a catch-all address](https://pidgeon.ai/blog/inbox-per-agent-vs-catch-all.md): Should each AI agent or customer get its own inbox, or can one catch-all address and a database row do the job?
- [Multi-tenant email for AI agent platforms](htt