MailKite Programmable Email

Programmable email for developers and agents.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Mailkite Send: Send a message over a verified domain. Pass `templateId` (+ optional `templateData`) to send from a saved or base template. Requires an API key (mk_live_…).
  • Mailkite Upload Attachment: Upload a file to MailKite storage and get back a secure, time-limited URL. Reference the returned `url` as an attachment in send() (`{ filename, url }`) or link it inline i
  • Mailkite List Templates: List your saved email templates (light metadata only — no body). Use getTemplate for the full template. Requires a management session token.

What data it sees

Do you need an account

No: the server works without sign-in

Programmable email for developers and agents. Send and Receive email. Create Inboxes for your agents Manage email domain (add inboxes, accounts, teams) Read all emails

How to connect

How to connect MailKite Programmable Email to Claude

The server address to paste into Claude settings:

https://mailkite--bucabay.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect MailKite Programmable Email to ChatGPT

The server address to paste into ChatGPT settings:

https://mailkite--bucabay.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect MailKite Programmable Email to Cursor

The server address to paste into Cursor settings:

https://mailkite--bucabay.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (40)

Raw names from tools/list. Only developers need these.

mailkite_sendSend a message over a verified domain. Pass `templateId` (+ optional `templateData`) to send from a saved or base template. Requires an API key (mk_live_…).
mailkite_upload_attachmentUpload a file to MailKite storage and get back a secure, time-limited URL. Reference the returned `url` as an attachment in send() (`{ filename, url }`) or link it inline in your HTML — instead of base64-inlining large files on every send. Give the file ONE of four ways: a local `path` (read and streamed as raw bytes by the CLI/SDK/local MCP), a remote `url` (MailKite fetches and re-hosts it), base64 `content`, or — over raw HTTP — the file bytes as the POST body with `?filename=`. `retentionDays` (7/30/90/365, default 7) sets how long the file and URL live. Requires an API key (mk_live_…).
mailkite_list_templatesList your saved email templates (light metadata only — no body). Use getTemplate for the full template. Requires a management session token.
mailkite_list_base_templatesList the premade base templates (light metadata). Clone one with createTemplate({ baseId }) or send from it directly via send({ templateId }). Requires a management session token.
mailkite_get_templateGet one template (full: subject, html, text, theme). Works for your templates (tpl_…) and base templates (base_…). Requires a management session token.
mailkite_create_templateCreate a template. Pass `baseId` to clone a base template into your own, or provide name/subject/html/text/theme directly. Requires a management session token.
mailkite_list_domainsList your domains, each with its webhook URL. Requires a management session token.
mailkite_create_domainAdd a domain. Returns the domain + DNS records. Requires a management session token.
mailkite_get_domainGet one domain with DNS records + webhook. Requires a management session token.
mailkite_delete_domainRemove a domain. Requires a management session token.
mailkite_verify_domainCheck DNS and update status. Requires a management session token.
mailkite_set_webhookSet or replace the domain's catch-all webhook. Requires a management session token.
mailkite_delete_webhookRemove the domain's webhook. Requires a management session token.
mailkite_test_webhookSend a signed test event to the domain's webhook. Requires a management session token.
mailkite_check_domain_availabilityCheck whether a domain is available to register, and at what price. Read-only — no charge. Requires a management session token.
mailkite_register_domainRegister (buy) a domain on the customer's behalf; provisions mail DNS and adds it to the account in one call. Charges the registrar. Requires a management session token. Does NOT register automatically — returns a dashboard link for the user to review the price and confirm. An assistant can never purchase a domain on its own.
mailkite_list_routesList inbound routing rules. Requires a management session token.
mailkite_create_routeCreate a route (match, action, destination). Requires a management session token.
mailkite_delete_routeDelete an inbound routing rule by id. Pair with createRoute to register and tear down a webhook destination — e.g. an automation platform subscribing on enable and cleaning up on disable. Requires a management session token.
mailkite_agentSend a message to one of your inbox agents and get its reply. Defaults to the account's default agent; pass `routeId` or `address` to target a specific agent, or `model` to override the model. This is separate from inbound routing — it does not match or override routes. Requires an API key (mk_live_…).
mailkite_routeRoute a message to one of your registered routes (by `routeId` or `address`), running that route's action — agent, webhook, or forward. The route must already exist on your account; arbitrary destinations are not allowed. Requires an API key (mk_live_…).
mailkite_list_messagesList stored messages, newest first. Optionally filter with `search` (matches sender, recipient, or subject) and page with `before` (a `received_at` cursor) and `limit`; omit all for the default newest 100. Response is a bare array — paginate by passing the last row's `received_at` as the next `before`. Requires a management session token.
mailkite_get_messageGet a message with deliveries + attachments. Requires a management session token.
mailkite_retry_deliveryRe-deliver a stored message to its webhook. Requires a management session token.
mailkite_list_listsList your contact lists (static, curated broadcast audiences), each with its member count. Requires a management session token.
mailkite_create_listCreate a contact list. Returns the list with its id (lst_…); add contacts with addListContacts. Requires a management session token.
mailkite_get_listGet one contact list with its member count. Requires a management session token.
mailkite_update_listRename a contact list. Requires a management session token.
mailkite_delete_listDelete a contact list. The list is removed; the contacts themselves are kept. Requires a management session token.
mailkite_list_list_contactsList the contacts that are members of a list, newest first. Optionally page with `before` (a `last_seen_at`/`created_at` cursor) and `limit`. Response is a bare array — paginate by passing the last row's `last_seen_at` (or `created_at`) as the next `before`. Requires a management session token.
mailkite_add_list_contactsAdd contacts (by id, ctr_…) to a list. Returns how many were newly added; contacts already on the list are ignored. Requires a management session token.
mailkite_remove_list_contactRemove one contact from a list (the contact itself is kept). Requires a management session token.
mailkite_list_broadcastsList your broadcasts (one-to-many sends) with status and send stats. Requires a management session token.
mailkite_create_broadcastCreate a broadcast draft. `from` is required; set `audience` to { type: "all" } or { type: "list", id: "lst_…" }. Returns the broadcast with its id (bct_…). Send it with sendBroadcast. Requires a management session token.
mailkite_get_broadcastGet one broadcast with its status and recipient summary. Requires a management session token.
mailkite_update_broadcastEdit a draft broadcast (any of from/subject/audience/html/… ). Drafts only. Requires a management session token.
mailkite_delete_broadcastDelete a broadcast draft. Requires a management session token.
mailkite_send_broadcastSend a broadcast now, or pass an ISO 8601 `scheduledAt` to schedule it. A one-click unsubscribe is always added. Returns the status and resolved audience count. Requires a management session token. Does NOT register automatically — returns a dashboard link for the user to review the price and confirm. An assistant can never purchase a domain on its own.
mailkite_verify_webhookVerify the `x-mailkite-signature` header on an inbound webhook delivery. Runs entirely locally (HMAC-SHA256 over `${t}.${payload}`) — no network call. Returns true only when the signature matches and the event is within the freshness window. Runs locally (no API call) — no credentials needed.
mailkite_semantic_searchSemantic search over the MailKite documentation — returns the most relevant doc sections for a natural-language query (hybrid vector + keyword search over https://mailkite.dev/docs). Public; no authentication required. Requires an API key (mk_live_…).