# Meet Inboundr

> Email was built for people. Inboundr rebuilds the receiving half for software — and for the agents you put in front of it.

Every email API can **send**. Almost none help you with the hard part —
*receiving* and understanding mail without hand-parsing MIME or babysitting a
mailbox.

**Inboundr is the inbox side of email, built to be operated by code.** Point a
domain at Inboundr and every address on it becomes a parsed, threaded inbox your
software can read — over a webhook, a REST call, or a native
[MCP](/integrations/mcp) tool your AI agent drives directly.

<Note>
  **Agent-native, not agent-compatible.** Reading a thread isn't an afterthought
  bolted onto a receive-only API — it's a first-class
  [MCP tool](/integrations/mcp), same as filtering with [Shield](/concepts/shield).
  An agent can run its inbox without a line of glue code.
</Note>

## One inbox, three ways in

Inboundr sits between your code and everyone who mails it. Mail from any number
of senders funnels into one parsed, threaded inbox, which your software reads
over whichever of the three surfaces suits it — mix and match freely, since a
store-only inbox is always readable even while it also fires webhooks.

<img
  className="block dark:hidden"
  src="/images/flow-receive-light.svg"
  alt="Three senders — customer, vendor, alerts — funnelling through Inboundr, then out to a webhook, the REST API, and an MCP agent"
/>
<img
  className="hidden dark:block"
  src="/images/flow-receive-dark.svg"
  alt="Three senders — customer, vendor, alerts — funnelling through Inboundr, then out to a webhook, the REST API, and an MCP agent"
/>

Every address on your domain accepts mail without being created first, and each
message arrives parsed, threaded, and attributed to a conversation — see
[Receiving email](/guides/receiving-email).

<CardGroup cols={3}>
  <Card title="Webhooks" icon="bolt">
    A signed `email.received` event, the moment mail lands. Best for servers and
    automations.
  </Card>
  <Card title="REST API" icon="code">
    Poll and search a small, predictable JSON API. Best for scripts and
    backends.
  </Card>
  <Card title="MCP" icon="robot">
    List, read, and thread as tools, plus filter with Shield. Best for agents
    that act on demand.
  </Card>
</CardGroup>

## What you get that raw email doesn't

<CardGroup cols={2}>
  <Card title="Parsed, not raw" icon="wand-magic-sparkles">
    Clean JSON — text and HTML bodies, attachment metadata, and SPF/DKIM/spam
    verdicts — instead of a MIME blob you have to decode yourself.
  </Card>
  <Card title="Conversations, not messages" icon="comments">
    Inboundr threads inbound mail automatically using standard headers, so you
    read a whole exchange in one call instead of stitching messages together.
  </Card>
  <Card title="Your domain, your addresses" icon="globe">
    Bring your own domain and keep full ownership. Catch-all means every address
    works without pre-creating it.
  </Card>
  <Card title="Delivery you can trust" icon="shield-check">
    Signed webhooks, exponential-backoff retries, and every attempt recorded in
    the console.
  </Card>
</CardGroup>

## The shape of an integration

Most Inboundr projects come down to the same loop — the **agent inbox loop**:

<Steps>
  <Step title="Mail arrives">
    Someone emails an address on your verified domain. Inboundr parses it and
    stores it on a thread.
  </Step>
  <Step title="Your code reads it">
    A webhook fires, or your agent calls `list_emails` / `get_thread`.
  </Step>
  <Step title="Your code acts on it">
    Route it, file it, alert on it — or filter it before it ever lands with a
    [Shield](/concepts/shield) rule.
  </Step>
</Steps>

Everything else in these docs is a detail of that loop.

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Domain to first parsed email in a few minutes.
  </Card>
  <Card title="How Inboundr works" icon="diagram-project" href="/concepts/model">
    The mental model behind domains, routing, and inboxes.
  </Card>
  <Card title="Build an email agent" icon="robot" href="/guides/build-an-agent">
    Wire an agent to its own inbox over MCP.
  </Card>
  <Card title="API reference" icon="terminal" href="/api-reference/introduction">
    Every endpoint, parameter, and response.
  </Card>
</CardGroup>
