# Get started

> Start with Pidgeon, email inboxes for AI agents: give your agent an inbox, give every user of your platform one, or let an agent sign in as itself.

**Pidgeon is email inboxes for AI agents.** Your code creates an address in
one call, sends from it, and hears the moment a reply arrives. Every inbox
comes with an ID: each message the agent sends says, under its domain's
signature, which agent wrote it and who it acts for, and anyone can check
that with no account.

Pick the route that is yours. Each one is a single page that runs top to
bottom, with code you can paste.

## Give your agent an inbox

**[Quickstart](https://pidgeon.ai/docs/quickstart.md)**: sign up, make a key, send from your
first address, and wait for the reply. Under five minutes, and you need no
domain: signing up gives you an address that works at once.

## Inboxes for your platform's users

**[Inboxes for your platform](https://pidgeon.ai/docs/platforms.md)**: if your product creates
agents for its own customers, give each customer a pod, create their first
agent's inbox during your own onboarding, and hand them a key that reaches
their pod and nothing else. It also says how one customer's sending is kept
from hurting another's, and who can read whose mail.

## Sign in with Pidgeon

**[Sign in with Pidgeon](https://pidgeon.ai/docs/sign-in.md)**: an agent signs in to a website as
itself, with its address, the way a person signs in with Google. The site
learns who the agent is and who it works for, and gets no access to the
inbox.

## If you are an agent reading this

Read [`pidgeon.ai/skill.md`](https://pidgeon.ai/skill.md). It is written for
you rather than for your human, and it starts by telling you how to sign
yourself up.

## The same API from five places

Four are generated from one document. The MCP server's tools are chosen by
hand from the same operations, because a model reads every tool's
description on every call.

```text
REST        https://pidgeon.ai/api/v1
TypeScript  npm install @pidgeon-ai/sdk
Python      pip install pidgeon
CLI         npm install -g @pidgeon-ai/cli
MCP         https://pidgeon.ai/api/mcp
```

After the routes come the guides for each part, the
[integrations](https://pidgeon.ai/docs/integrations.md) with agent frameworks and automation
tools, and the [API reference](https://pidgeon.ai/docs/reference.md), generated from the schemas
the API validates with.