
runearc
io.github.runearc-labs/runearc
Email inboxes for AI agents: create an inbox, wait for the verification code, send and reply.
Documentation
MCP docs · Claude Code · Cursor · Agent mail · Pricing · Status
Runearc MCP server: email inboxes for AI agents
Runearc's MCP server gives your AI agent its own email address. It can create an inbox, sign up for a service, wait for the verification email and read the one time code, then send and reply like a person would. It also manages your own sending domain, webhooks, contacts, templates and campaigns, so one connection covers both an agent's mailbox and your product's email.
- Hosted, nothing to install:
https://mcp.runearc.com/mcp(streamable HTTP). - 90 tools, each with a description that lists its errors and the next tool to call.
- Codes and links already pulled out:
wait_for_emailreturns the message pluscodesandlinks, so the agent does not have to parse HTML. - Real mail, real domains: every workspace gets a private
runearc.emailsubdomain, and you can add your own domain with SPF, DKIM and DMARC checked for you. - Free plan, no card: 3 inboxes, 3,000 emails a month and 3 custom domains.
Quick start
- Sign up at app.runearc.com and create an API key on the API keys page.
- Connect your client (below).
- Ask your agent: "Create an inbox, sign up for the newsletter on example.com with it, and tell me the confirmation code."
Claude Code
export RUNEARC_API_KEY=mb_live_...
claude mcp add --transport http runearc https://mcp.runearc.com/mcp \
--header "Authorization: Bearer $RUNEARC_API_KEY"
Full walkthrough: runearc.com/integrations/claude-code.
Cursor
~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor reads ${env:...}, which keeps the key out of git:
{
"mcpServers": {
"runearc": {
"url": "https://mcp.runearc.com/mcp",
"headers": { "Authorization": "Bearer ${env:RUNEARC_API_KEY}" }
}
}
}
Full walkthrough: runearc.com/integrations/cursor.
Any other MCP client
Any client that supports remote servers with custom headers (VS Code, Windsurf, Cline, Zed, your own agent built on an MCP SDK):
| Setting | Value |
|---|---|
| Transport | Streamable HTTP |
| URL | https://mcp.runearc.com/mcp |
| Header | Authorization: Bearer <your Runearc API key> |
The key's scope (full, sending or one inbox) decides which tools it can call. A missing key returns 401 missing_api_key with the fix.
What an agent can do
Sign up and verify, in two calls
create_inbox {"name": "signup-bot"}
-> {"id": "ibx_...", "address": "signup-bot@<your-subdomain>.runearc.email", ...}
wait_for_email {"inbox_id": "ibx_...", "subject_contains": "code", "timeout_seconds": 90}
-> {"subject": "...", "codes": ["..."], "links": ["https://..."], ...}
wait_for_email only matches mail that arrives after the call starts (or after after), so it never returns an old code. It waits up to 120 seconds per call.
Read, send and reply: list_messages, get_message, list_threads, get_thread, send_email, reply.
Run your product's email: add and verify a domain, create webhooks, send templates, manage contacts and lists, run campaigns and sequences, and read analytics.
Tools
| Area | Tools |
|---|---|
| Inboxes | create_inbox, list_inboxes, get_inbox, delete_inbox |
list_messages, get_message, list_threads, get_thread, send_email, reply | |
| Wait | wait_for_email (returns codes and links) |
| Domains and webhooks | add_domain, verify_domain, list_domains, create_webhook |
| Tracking | get_tracking_settings, update_tracking_settings, get_email_tracking |
| Contacts | add_contact, update_contact, list_contacts, unsubscribe_contact, tag_contacts, bulk_contacts, unsubscribe_contacts, list_suppressions |
| Lists and segments | create_list, list_lists, add_to_list, list_segments, create_segment, preview_segment, delete_segment |
| Import | import_contacts, get_import |
| Events and goals | track_event, list_contact_events, list_event_definitions, create_event_definition, list_sync_rules, create_sync_rule, delete_sync_rule, list_goals, create_goal, goal_stats |
| Billing integrations | list_billing_integrations, connect_billing_integration, remove_billing_integration |
| Email design | get_email_design, set_email_design, render_email_preview |
| Templates | list_templates, create_template, send_template |
| Campaigns | list_campaigns, list_campaign_designs, create_campaign, update_campaign, send_campaign_test, send_campaign, pause_campaign, resume_campaign, cancel_campaign |
| Sequences | list_sequences, get_sequence, create_sequence, set_sequence_steps, activate_sequence, pause_sequence, enroll_contact_in_sequence, install_starter_sequence |
| Forms and popups | create_form, list_forms, list_form_submissions, create_popup, popup_stats |
| Landing pages | list_pages, create_page, get_page, update_page, publish_page, unpublish_page, delete_page |
| AI | get_ai_context, generate_email, generate_sequence |
| Onboarding | import_site, draft_welcome_sequence, turn_on_welcome_sequence |
| Analytics | get_analytics |
Arguments for every tool: runearc.com/docs/mcp. tools/list on the server is the source of truth.
Errors your agent can act on
Errors come back as tool results with isError: true:
{ "error": { "code": "insufficient_scope", "message": "...", "fix": "..." } }
Every error carries a fix, written so the agent (or you) can recover without opening the docs.
Common uses
- Agents that sign up for things: an inbox per agent or per task, then
wait_for_emailfor the OTP or magic link. - End to end tests: a fresh address per test run for sign up, password reset and notification emails.
- Support and ops agents: read a shared inbox, reply in the same thread, forward when needed.
- Product email from your editor: add your domain, write a template and send a test without leaving Claude Code or Cursor.
Not using MCP?
The same features are in the REST API, the runearc CLI, SMTP and IMAP, and the official MIT licensed SDKs for Node.js, Python, Go, PHP and Ruby.
About this repository
This repository holds the public listing for Runearc's hosted MCP server: setup, the tool list and the server.json for the official MCP Registry. The server itself runs at mcp.runearc.com. Questions or a missing tool: open an issue, or write to arin@runearc.com.
runearc.com · MIT licence for the files in this repository.
No installation packages available.