# Runearc Labs Runearc MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.runearc-labs%2Frunearc
Registry id: `mcp-registry/io.github.runearc-labs/runearc`
Status: live (checked 2026-11-22T19:15:57.209Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 725
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "runearc-labs-runearc-mcp-server": {
      "type": "http",
      "url": "https://mcp.runearc.com/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http runearc-labs-runearc-mcp-server https://mcp.runearc.com/mcp
```

## Tools (90)

- `activate_sequence`: Activate a draft or paused sequence so triggers enrol contacts and due steps run. Returns the sequence with status "active". Errors: sequence_empty, from_requir
- `add_contact`: Add ONE new contact (a person to email) to the workspace's audience; tags and list_ids given here are applied at once (missing tags are created). Use update_con
- `add_domain`: Add a custom domain to send and receive mail on, such as acme.com. Returns {id, name, status, provider, can_auto_configure, records: [{type, name, value, priori
- `add_to_list`: Add contacts to a list. Returns {added: n} for newly added contacts. Errors: not_found (list or contact). Next: list_contacts with list_id to see members.
- `bulk_contacts`: Tag, add to a list, unsubscribe or delete many contacts at once. Give exactly one of contact_ids, emails or all_matching. Returns the operation {id, status, tot
- `cancel_campaign`: Cancel a campaign that has not finished. Pending recipients are dropped; mail already sent is not recalled. Errors: campaign_not_cancelable. Next: list_campaign
- `connect_billing_integration`: Connect a billing provider so purchases, renewals, cancellations and refunds become events and contact revenue. Returns webhook_path (prefix with the API origin
- `create_campaign`: Create a draft campaign, blank, from a design, or as a copy of another campaign. Returns the campaign {id, status:"draft", ...}. Errors: invalid_name, unknown_d
- `create_event_definition`: Document a custom event so teammates know what it means. Returns the definition. Errors: event_definition_exists, invalid_event_name, reserved_event_name. Next:
- `create_form`: Create an embeddable signup form from a template (newsletter, waitlist or product-updates). Returns the form with its id. Errors: unknown_template, invalid_form
- `create_goal`: Create a conversion goal. Each matching event records a conversion credited to the last email sent or clicked within window_days. Returns the goal. Errors: goal
- `create_inbox`: Create a new email inbox that can receive (and send) mail right away. Returns {id, address, display_name, created_at}. Errors: inbox_limit_reached (plan limit; 
- `create_list`: Create an empty, named contact list (a static group you add people to by hand; for rule-based groups use create_segment). Names are unique per workspace. Return
- `create_page`: Create a draft landing page from a template (blank, waitlist, product-launch, newsletter). Returns the page with its blocks. Errors: page_slug_taken, unknown_pa
- `create_popup`: Create a popup that shows a form on a trigger (time, scroll or exit_intent), optionally only on some paths. Errors: invalid_popup_config, not_found (form), inva
- `create_segment`: Save a segment (a named audience filter over contacts). Returns the segment. Errors: invalid_filter (read the fix), segment_name_taken, segment_limit. Next: pre
- `create_sequence`: Create an empty draft sequence. Nothing sends until it has steps, a From address and is activated. Returns the sequence. Errors: invalid_name, invalid_trigger (
- `create_sync_rule`: Create a sync rule: when event_name happens and all conditions match, apply the action to the contact. Returns the rule. Errors: invalid_argument, invalid_event
- `create_template`: Create a transactional template from one of 18 starters (password-reset, magic-link, email-verification, verification-code, welcome, receipt, invoice, order-con
- `create_webhook`: Register a webhook: Runearc POSTs signed JSON events (Standard Webhooks) to the URL, retrying on failure. Returns {id, url, event_types, inbox_id, secret, creat
- `delete_inbox`: Delete an inbox and all of its messages. Mail to its address is rejected afterwards. This cannot be undone. Returns {deleted: true, id}. Errors: not_found, insu
- `delete_page`: Delete a landing page with its view counts and lead links (the contacts stay). Errors: not_found. Next: list_pages.
- `delete_segment`: Permanently delete a saved segment (the saved filter only; the contacts in it are not touched). Built-in quick filters cannot be deleted. Returns {deleted: true
- `delete_sync_rule`: Delete a sync rule so future events no longer trigger it. Changes it already made to contacts (tags, fields, lists) stay. Returns {deleted: id}. Errors: not_fou
- `draft_welcome_sequence`: Draft a 4 email welcome sequence (immediately, day 1, day 3, day 5) from an imported site. It is saved as a DRAFT: nothing is sent and nobody is enrolled. Retur
- `enroll_contact_in_sequence`: Enrol one contact in an active sequence now. Returns the enrolment {id, status, current_position, next_run_at}. Errors: sequence_not_active, contact_not_found, 
- `generate_email`: Draft one email with AI from a prompt and the workspace AI context. Returns {subject, preview_text, document} where document is an email design document (versio
- `generate_sequence`: Draft an automated email sequence with AI. Returns {name, steps:[{delay_days, subject, preview_text, document}]}; the first step has delay_days 0. Same errors a
- `get_ai_context`: Read the workspace AI context: product name and url, category, founder voice, tone, company context, extra instructions, and enabled languages. Returns {product
- `get_analytics`: Email analytics for the workspace: sent, delivered, bounced, complained, opened, clicked, unsubscribed, conversions and revenue_cents as a zero filled time seri
- `get_email_design`: Get the workspace email design: brand color, font, alignment, logo, header, footer and postal address. Returns {brand, design_md}; design_md is a markdown file 
- `get_email_tracking`: Counted opens, unique opens, clicks, unique clickers and unsubscribes of one email, plus how many opens and clicks the bot filter flagged. Returns {opens, uniqu
- `get_import`: Progress of a contact import. Returns {import: {status, total_rows, processed_rows, created_count, updated_count, skipped_count, error_count}, errors: [{row_num
- `get_inbox`: Get one inbox by id. Returns {id, address, display_name, created_at}. Errors: not_found. Next: list_messages or wait_for_email.
- `get_message`: Get one message with its text body and the one time codes and links found in it. Returns {id, inbox_id, thread_id, direction, status, from, to, cc, subject, tex
- `get_page`: Read one landing page: draft blocks, status, form and public url. Errors: not_found. Next: update_page to edit it, or publish_page.
- `get_sequence`: Get one sequence with its trigger, goal, From address, ordered steps and enrolment counts. Returns the sequence. Errors: sequence_not_found. Next: set_sequence_
- `get_thread`: Get a conversation with all of its messages, oldest first, each with text, codes and links. Returns {id, inbox_id, subject, message_count, last_message_at, mess
- `get_tracking_settings`: Show the workspace's tracking settings: opens, clicks, unsubscribe, strict bot filter and the per-address frequency cap. Returns {track_opens, track_clicks, uns
- `goal_stats`: Read-only results of one goal over the last `days` (default 30, 1 to 365): conversions, unique contacts, how many were credited to an email, revenue_cents and t
- `import_contacts`: Import contacts from CSV text and start the import. Detects the email, first name and last name columns from the header. Returns {import, mapping_used}; the imp
- `import_site`: Read a website and save its name, logo, brand colour and description as the workspace's brand and company context. Fetches only public web pages (private and in
- `install_starter_sequence`: Create a draft sequence from a ready made one: welcome, onboarding, trial-ending, win-back, churn-save or review-request, with real email copy. Returns the sequ
- `list_billing_integrations`: List connected billing providers (Stripe, Paddle, Lemon Squeezy, Polar, ...). Returns {integrations: [...]} with each webhook_path (prefix with the API origin) 
- `list_campaign_designs`: List the 8 starting designs for a campaign (slug, name, subject, document). Next: create_campaign with design set to a slug.
- `list_campaigns`: List broadcast campaigns, newest first, optionally only one status (draft, scheduled, sending, paused, sent, canceled). Each has counters: recipients_total, sen
- `list_contact_events`: List a contact's events, newest first. Returns {data: [...], next_cursor}. Errors: not_found (contact). Next: track_event to add one, or pass next_cursor back a
- `list_contacts`: Find contacts, newest first. Filter by q, status, tag or list_id. Returns {contacts: [...], next_cursor}. Pass next_cursor back as cursor for the next page. Nex
- `list_domains`: List the org's custom domains with their status and DNS records. Returns {domains: [...]}. Next: verify_domain for any that are not verified, or add_domain.
- `list_event_definitions`: List the custom event names this workspace has documented (name, description, property hints), so you use the same names in track_event and create_sync_rule. Re
- `list_form_submissions`: Recent submissions of a form, newest first: {submissions:[{email,status,origin,page_url,created_at}]}. Status is accepted, pending_confirmation, confirmed, supp
- `list_forms`: List the workspace's signup forms. Returns {forms:[{id,name,status,config,...}]}. Errors: insufficient_scope (needs a full access key). Next: list_form_submissi
- `list_goals`: List conversion goals (an event plus conditions that counts as a win). Returns {goals: [...]}. Next: goal_stats for results, or create_goal.
- `list_inboxes`: List the inboxes this API key can use. Returns {inboxes: [{id, address, display_name, created_at}]}. Next: list_messages or wait_for_email with an inbox id, or 
- `list_lists`: List every contact list in the workspace (static lists, not segments) with member counts. Read-only. Returns {lists: [{id, name, description, member_count}]}. N
- `list_messages`: List messages in an inbox, newest first, received and sent. Returns {messages: [{id, thread_id, direction, from, to, subject, preview, attachments, created_at}]
- `list_pages`: List the workspace's landing pages with status, views, leads and conversion per view. Returns {pages: [...]}. Errors: insufficient_scope (needs a full access ke
- `list_segments`: List segments: six built-in quick filters (builtin_*) then saved ones, each with a filter and a cached last_count. Next: preview_segment for a live count, creat
- `list_sequences`: List sequences (lifecycle automations), newest first. Returns {sequences: [{id, name, status, trigger, steps, enrolled, active, completed, ...}]}. Next: get_seq
- `list_suppressions`: List addresses that will not be emailed: hard bounces, complaints, manual blocks and unsubscribed contacts. Returns {suppressions: [{address, reason, created_at
- `list_sync_rules`: List sync rules: when an event matches, tag the contact, set a field or add it to a list. Returns {rules: [...]}. Next: create_sync_rule or delete_sync_rule.
- `list_templates`: List this workspace's transactional templates. Returns {data:[{id, slug, name, published_version_id}]}. Next: send_template, or create_template to add one.
- `list_threads`: List conversations (threads) in an inbox, most recently active first, up to 100. Returns {threads: [{id, inbox_id, subject, message_count, last_message_at}]}. E
- `pause_campaign`: Pause a sending campaign; pending recipients stay queued. Errors: campaign_not_pausable. Next: resume_campaign or cancel_campaign.
- `pause_sequence`: Pause an active sequence: no new contacts enter and no step runs; enrolments keep their place and catch up on resume. Returns the sequence with status "paused".
- `popup_stats`: Read-only performance of one popup made with create_popup: impressions, dismissals, conversions and conversion_rate (conversions / impressions, 0 when there are
- `preview_segment`: Live count and a sample of contacts for a segment id or a draft filter, without saving. Returns {count, sample:[{id,email,first_name,last_name,status}]}. Engage
- `publish_page`: Publish a landing page: freezes the draft as the live snapshot at /p/<workspace>/<slug>. Errors: page_needs_form (a signup block needs a form_id). Next: share t
- `remove_billing_integration`: Disconnect a billing provider; its webhook URL stops working. Returns {deleted}. Errors: not_found. Next: list_billing_integrations to confirm.
- `render_email_preview`: Render an email document with the workspace brand, without sending. Returns {subject, html, text}. Errors: invalid_document, unknown_variable (add a fallback li
- `reply`: Reply to a message in the same thread (sets In-Reply-To, References and a "Re:" subject). Replying to a message you sent follows up with its recipients. Returns
- `resume_campaign`: Resume a paused campaign; sending continues with the pending recipients. Errors: campaign_not_resumable. Next: list_campaigns to watch the counters.
- `send_campaign`: Send a draft campaign now, or schedule it with scheduled_at (RFC 3339, within 30 days). Runearc sends one personalised email per active contact, skipping unsubs
- `send_campaign_test`: Send a campaign test to 1 to 5 addresses (subject prefixed [Test], no tracking, no recipient rows). Errors: campaign_incomplete (read the fix), invalid_test_rec
- `send_email`: Send a new email from an inbox. Starts a new thread. Returns {id, thread_id, status, from, to, cc, subject, created_at}; status is "queued" until delivery. Erro
- `send_template`: Send an email from a published transactional template. Returns {id}. Errors: template_not_found, template_not_published, missing_variable (names the variable), 
- `set_email_design`: Replace the workspace email design from a design.md file. Returns {brand}. Errors: invalid_design_md, invalid_brand (each has a fix), forbidden (needs a full sc
- `set_sequence_steps`: Replace all steps of a draft or paused sequence. Returns the sequence. Errors: sequence_active (pause it first), invalid_steps (the steps JSON does not parse), 
- `tag_contacts`: Attach a tag to contacts (the tag is created if missing). Returns {tagged: n} for newly tagged contacts. Errors: not_found (contact), invalid_tag. Next: list_co
- `track_event`: Record that a contact did something, such as plan_upgraded. Runearc then applies sync rules (tags, fields, lists) and goals. Returns the event with duplicate=tr
- `turn_on_welcome_sequence`: Turn on the welcome sequence: from now on contacts matching its audience are enrolled and emailed. Ask the user first, this is the step that sends mail. Returns
- `unpublish_page`: Take a landing page offline; the address answers not found. Counts and leads are kept. Errors: not_found. Next: publish_page to bring it back.
- `unsubscribe_contact`: Unsubscribe a contact so broadcasts skip them. Returns the contact with status unsubscribed. Errors: not_found. Next: list_contacts with status unsubscribed to 
- `unsubscribe_contacts`: Unsubscribe addresses from marketing mail. Unknown addresses become unsubscribed contacts, so a later import cannot resubscribe them. Transactional mail still s
- `update_campaign`: Edit a draft campaign: name, subject, preheader, from_address (a verified sender), reply_to, document (email design JSON) and audience ({kind:list,id} | {kind:s
- `update_contact`: Change a contact's names, source or revenue. Pass an empty string to clear a name. Returns the contact. Errors: not_found, invalid_revenue. Next: list_contacts 
- `update_page`: Change a landing page draft: name, slug, SEO title, description, signup form_id (null clears it) or the whole blocks array. A published page keeps serving its s
- `update_tracking_settings`: Change tracking settings; only the fields you pass change. Marketing mail is mail tagged category=marketing: only it gets unsubscribe links and the frequency ca
- `verify_domain`: Check a domain's DNS records now and update its status. Returns the domain with status "verified", "pending" or "failing", and per record status ok, missing or 
- `wait_for_email`: Wait until an email arrives in an inbox, then return it with the one time codes and links extracted, so a sign up is two calls: create_inbox, then this. Blocks 

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
