# EmptyInbox

> Disposable email inbox API for AI agents and developers. Create temporary email addresses, receive messages, and read content — no browser required.

## API Access

- Base URL: https://emptyinbox.me/api
- Auth: `Authorization: Bearer <api_key>`
- Get your API key: https://emptyinbox.me/settings.html
- OpenAPI spec: https://emptyinbox.me/openapi.yaml

## MCP Server

Install for Claude, Claude Code, or any MCP-compatible agent:

```json
{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["emptyinbox-mcp"],
      "env": { "EMPTYINBOX_API_KEY": "your_api_key_here" }
    }
  }
}
```

npm package: `emptyinbox-mcp`

## REST API Endpoints

- `POST /api/inbox` — create a new disposable inbox, returns email address as plain text
- `GET /api/inboxes` — list all inboxes `[{inbox, created_at}]`
- `GET /api/messages` — list all messages `[{id, inbox, subject, text_body, html_body, sender, timestamp}]`
- `GET /api/message/{id}` — get full message content

## Typical Agent Workflow

1. `POST /api/inbox` → get a disposable address
2. Use that address in an external signup or verification flow
3. `GET /api/messages` → poll until the verification email appears
4. Read the code or link from `text_body` or `html_body`

The MCP `wait_for_message` tool handles the polling loop automatically.

## Pricing

- Free: 5 inboxes per account
- Paid: 1 USDT or equivalent BTC per 10 additional inboxes
- Payments via Blockonomics (USDT) — no credit card, no KYC

## Pages

- [Home](https://emptyinbox.me/): Overview and quickstart
- [API Docs](https://emptyinbox.me/docs.html): REST API documentation
- [Pricing](https://emptyinbox.me/pricing.html): Free and paid tiers
- [Login](https://emptyinbox.me/login.html): Get your API key
- [Blog](https://emptyinbox.me/blog/): Tutorials and guides
- [How to Give Your Claude Agent an Email Inbox](https://emptyinbox.me/blog/how-to-give-your-claude-agent-an-email-inbox.html): MCP and REST setup walkthrough

## Source & Contact

- GitHub: https://github.com/blockonomics/emptyinbox-me
- Maintained by [Blockonomics](https://www.blockonomics.co/merchants)