Repository avatar
AI Tools
v1.0.0
active

runearc

io.github.runearc-labs/runearc

Email inboxes for AI agents: create an inbox, wait for the verification code, send and reply.

Documentation

Runearc MCP server: real email inboxes for AI agents. create_inbox, wait_for_email and send_email in Claude Code, Cursor or any MCP client.

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_email returns the message plus codes and links, so the agent does not have to parse HTML.
  • Real mail, real domains: every workspace gets a private runearc.email subdomain, 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

  1. Sign up at app.runearc.com and create an API key on the API keys page.
  2. Connect your client (below).
  3. 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):

SettingValue
TransportStreamable HTTP
URLhttps://mcp.runearc.com/mcp
HeaderAuthorization: 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

AreaTools
Inboxescreate_inbox, list_inboxes, get_inbox, delete_inbox
Maillist_messages, get_message, list_threads, get_thread, send_email, reply
Waitwait_for_email (returns codes and links)
Domains and webhooksadd_domain, verify_domain, list_domains, create_webhook
Trackingget_tracking_settings, update_tracking_settings, get_email_tracking
Contactsadd_contact, update_contact, list_contacts, unsubscribe_contact, tag_contacts, bulk_contacts, unsubscribe_contacts, list_suppressions
Lists and segmentscreate_list, list_lists, add_to_list, list_segments, create_segment, preview_segment, delete_segment
Importimport_contacts, get_import
Events and goalstrack_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 integrationslist_billing_integrations, connect_billing_integration, remove_billing_integration
Email designget_email_design, set_email_design, render_email_preview
Templateslist_templates, create_template, send_template
Campaignslist_campaigns, list_campaign_designs, create_campaign, update_campaign, send_campaign_test, send_campaign, pause_campaign, resume_campaign, cancel_campaign
Sequenceslist_sequences, get_sequence, create_sequence, set_sequence_steps, activate_sequence, pause_sequence, enroll_contact_in_sequence, install_starter_sequence
Forms and popupscreate_form, list_forms, list_form_submissions, create_popup, popup_stats
Landing pageslist_pages, create_page, get_page, update_page, publish_page, unpublish_page, delete_page
AIget_ai_context, generate_email, generate_sequence
Onboardingimport_site, draft_welcome_sequence, turn_on_welcome_sequence
Analyticsget_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_email for 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.

Remote