Permite que los agentes de IA creen bandejas de entrada de correo desechables, lean mensajes y extraigan automáticamente códigos de verificación para flujos de registro.
También conocido como blockonomics/emptyinbox-me, emptyinbox-mcp
- Stars
- 4
- Herramientas
- 11
- Descargas, 30 días
- —
- Última versión
- 1.5.0
- Último commit
- 13 nov 2026
- Licencia
- —
¿Qué es EmptyInbox MCP?
Permite que los agentes de IA creen bandejas de entrada de correo desechables, lean mensajes y extraigan automáticamente códigos de verificación para flujos de registro. Expone 11 herramientas, como create_inbox, list_inboxes, list_messages.
Resumen generado a partir del README del proyecto
Acerca del MCP server de EmptyInbox
EmptyInbox ofrece una forma para que los agentes de IA gestionen direcciones de correo electrónico desechables para tareas automatizadas. Este MCP server permite a los agentes generar nuevas bandejas de entrada, leer mensajes entrantes y extraer datos específicos como códigos de verificación o enlaces de acción. Está diseñado para manejar flujos de registro y requisitos de contraseñas de un solo uso (OTP) sin intervención humana manual.
Los usuarios pueden configurarlo a través de Claude Code o añadiendo el comando npx a cualquier configuración estándar de un cliente MCP. El servidor gestiona el registro de la cuenta automáticamente durante la primera llamada a una herramienta, guardando las credenciales en un archivo JSON local. Los desarrolladores también pueden proporcionar su propia API key mediante variables de entorno. El sistema incluye herramientas para gestionar los créditos de la cuenta, como listar paquetes, comprar cuota mediante Bitcoin y consultar el estado del pago. Aunque las bandejas de entrada caducan después de 30 días por defecto, la herramienta keep_inbox permite a los usuarios hacer que una dirección sea permanente para necesidades a largo plazo, como restablecimientos de contraseña.
Qué puedes hacer con él
- 1Extraer códigos de verificación de correos electrónicosEl servidor puede analizar los mensajes entrantes para recuperar códigos OTP específicos o enlaces de acción.
- 2Gestionar créditos de servicio con BitcoinUn agente puede facilitar la compra de cuota generando una URL de pago y comprobando cuándo se confirma la transacción.
- 3Mantener direcciones de correo permanentesUn desarrollador puede asegurarse de que una bandeja de entrada no caduque para que pueda recibir futuros correos de restablecimiento de contraseña.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar EmptyInbox MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar EmptyInbox MCP en Claude Code
$ claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpInstalar EmptyInbox MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Instalar EmptyInbox MCP en VS Code
.vscode/mcp.json
{
"servers": {
"emptyinbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Instalar EmptyInbox MCP en VS Code CLI
$ code --add-mcp '{"name":"emptyinbox","type":"stdio","command":"npx","args":["-y","emptyinbox-mcp"],"env":{"EMPTYINBOX_API_KEY":"<YOUR_EMPTYINBOX_API_KEY>"}}'Instalar EmptyInbox MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Instalar EmptyInbox MCP en Codex
$ codex mcp add emptyinbox --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' -- npx -y emptyinbox-mcpInstalar EmptyInbox MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.emptyinbox] command = "npx" args = ["-y", "emptyinbox-mcp"] [mcp_servers.emptyinbox.env] EMPTYINBOX_API_KEY = "<YOUR_EMPTYINBOX_API_KEY>"
Instalar EmptyInbox MCP en Gemini CLI
$ gemini mcp add -s user -e 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox npx -- -y emptyinbox-mcpInstalar EmptyInbox MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Herramientas de EmptyInbox MCP 11
Detectado desde el READMEcreate_inboxlist_inboxeslist_messagesget_messagewait_for_messageget_quotalist_bundlesbuy_quotacheck_paymentkeep_inboxreport_issue
| create_inbox | — | |
| list_inboxes | — | |
| list_messages | — | |
| get_message | — | |
| wait_for_message | — | |
| get_quota | — | |
| list_bundles | — | |
| buy_quota | — | |
| check_payment | — | |
| keep_inbox | — | |
| report_issue | — |
Configuración
EMPTYINBOX_API_KEYSecretoExisting EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json.
| Nombre | Descripción | Tipo |
|---|---|---|
| EMPTYINBOX_API_KEY | Existing EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json. | Secreto |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubemptyinbox-mcp
MCP server for EmptyInbox — create disposable email inboxes and read messages from AI agents.
Listed in the official MCP Registry as io.github.cnohall/emptyinbox.
Setup
Claude Code:
claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest
Any other MCP client — add to its config:
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"]
}
}
}
No setup: the first tool call that needs an account registers one automatically and saves the key to ~/.emptyinbox.json for future sessions. Starting the server on its own (as MCP hosts do to list tools) creates nothing.
Bring your own account (optional — to reuse an existing key):
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"],
"env": {
"EMPTYINBOX_API_KEY": "your_api_key_here"
}
}
}
}
Get an API key at https://emptyinbox.me/settings.html
Tools
| Tool | Description |
|---|---|
create_inbox |
Create a new email address; it expires after 30 days unless kept |
list_inboxes |
List all inboxes on your account |
list_messages |
List received messages, each with its extracted code, action link and text preview |
get_message |
Get one message parsed (code, links, plain text), or format="text" for a flat rendering |
wait_for_message |
Block until an email arrives — perfect for signup/OTP flows; returns the extracted code with it |
get_quota |
Credits remaining on the account |
list_bundles |
List quota bundles and prices |
buy_quota |
Quote a Bitcoin payment; returns a pay_url for the user plus address, amount and BIP21 URI |
check_payment |
Check whether a payment landed and quota was credited |
keep_inbox |
Make an inbox permanent (30 credits) so it keeps receiving mail, e.g. password resets |
report_issue |
Send a bug, payment problem, docs gap or feature request to the team; never creates an account |
Example agent workflow
1. create_inbox → "clever.sunny.butterfly@emptyinbox.me"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="clever.sunny.butterfly@emptyinbox.me", timeout_seconds=60)
4. → returns the verification email with code/link
Payment
Every account starts with free inboxes. When they run out, create_inbox returns
the prices and the agent can close the purchase without leaving the session:
- the agent shows its user the bundles and the user picks one
buy_quotareturns apay_url— a page with a QR code, the exact amount and live status — plus the raw address, amount and BIP21 URI- the user pays from any Bitcoin wallet (or an agent with its own wallet pays the BIP21 URI)
check_paymentwithwait_secondsconfirms the credit, usually within seconds of broadcast
buy_quota takes either a bundle id from list_bundles or a custom whole-dollar
usd amount from $1 to $100, for an agent spending down whatever a wallet holds.
A custom amount is priced at the best bundle rate it qualifies for. The network
fee the payer adds on top is the same whatever the size of the payment, so it
eats a far larger share of a dollar-sized top-up.
Quota is granted as soon as the payment is seen on the network, so there is no waiting for confirmations. Humans can also buy at https://emptyinbox.me/inboxes.html
Preguntas sobre EmptyInbox MCP
¿Cómo agrego EmptyInbox MCP a Claude Code?
Ejecuta claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego EmptyInbox MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona EmptyInbox MCP?
Expone 11 herramientas, incluidas create_inbox, list_inboxes, list_messages, get_message, wait_for_message.
¿Cómo configuro EmptyInbox?
El servidor no requiere configuración manual; la primera llamada a una herramienta que necesite una cuenta registrará una automáticamente y guardará la clave localmente.
¿Cómo gestiona el agente los códigos de verificación?
La herramienta wait_for_message puede bloquearse hasta que llegue un correo, lo que la hace ideal para flujos de registro o de OTP al devolver el código extraído.
¿Cómo se gestionan los pagos para obtener más cuota?
Los agentes pueden solicitar un pago en Bitcoin mediante buy_quota, que proporciona una URL de pago y un URI BIP21 para que el usuario complete la transacción.