Skip to content
Reference

MCP tools

Every tool an AI agent can call through Kōlea's MCP server, by area, one line each.

Kōlea runs an MCP server so an agent such as Claude can work on your account: look things up, draft broadcasts, tag people, record sales. The server is at https://kolea.pro/mcp and takes an admin key as a bearer token. Every tool is also a REST endpoint under /api/v1, with the same arguments and the same rules. Every call, refused or not, is written to the audit log with its arguments and how long it took.

Tools marked sends put mail on the wire. An agent can call them only after you turn agent sending on with Let agents send mail under Settings > API & agents; it is off for every new account. Tools marked preflight hand back a single-use token, valid 10 minutes and void after any edit, that the matching send or activate call needs.

Audience

  • subscriber_search: find people by email or name, status, or tag.
  • subscriber_get: one person, with tags.
  • subscriber_timeline: what happened to one person, newest first.
  • subscriber_upsert: add or update someone by address. Never returns anyone who left.
  • subscriber_import_csv: start a CSV import. Imports never enroll or mail anyone.
  • subscriber_add_tags, subscriber_remove_tag: tag or untag one person.
  • subscriber_unsubscribe: take someone off broadcasts at their request.
  • subscriber_delete: erase a person and their history.
  • activity_list: the newest opens, clicks, bounces, unsubscribes, and signups.
  • list_health: growth, churn, bounces, and complaints over 30 days.

Tags and segments

  • tag_list, tag_create, tag_rename, tag_merge, tag_check, tag_delete: manage tags; tag_check says what a delete would touch.
  • tagrule_list, tagrule_create, tagrule_toggle, tagrule_delete: rules that tag on an open, a click, or a form signup.
  • segment_list, segment_get, segment_preview, segment_create, segment_update, segment_delete: saved audiences, with counts.

Broadcasts

  • broadcast_list, broadcast_get, broadcast_preview, broadcast_stats: read.
  • broadcast_create, broadcast_update, broadcast_delete: drafts.
  • broadcast_revise: fix a sent broadcast's subject and body. Never sends.
  • broadcast_preflight: the send confirmation. Preflight.
  • broadcast_send, broadcast_schedule: send now or later. Sends, needs the preflight token.
  • broadcast_send_test: a copy to the key's owner. Sends.
  • broadcast_cancel: stop a scheduled or sending broadcast.
  • broadcast_resume: finish a cancelled one; nobody gets it twice. Sends.

Sequences

  • sequence_list, sequence_get, sequence_stats, sequence_enrollments: read.
  • sequence_create, sequence_update, sequence_delete: sequences start paused.
  • step_add, step_update, step_delete, step_reorder: the mails.
  • sequence_exit_set, sequence_exit_remove: exits. An exit is never an opt-out.
  • sequence_preflight: what going live means. Preflight.
  • sequence_activate: go live. Sends, needs the preflight token.
  • sequence_deactivate: pause.
  • sequence_enroll: enroll one person by hand.
  • sequence_remove_person, sequence_rejoin_person: a person's own opt-out from one sequence, and undoing it.
  • sequence_tick: send every step due now. Sends.
  • sequence_template_list, sequence_template_get, sequence_template_create, sequence_template_update, sequence_template_delete, sequence_template_use: templates, and making a paused sequence from one.

Money

  • campaign_list, campaign_get, campaign_create, campaign_update, campaign_archive, campaign_delete, campaign_members, campaign_add, campaign_sales: campaigns and what belongs to them.
  • sale_list, sale_get, sale_record, sale_refund, sales_unattributed: sales. Amounts are minor units.
  • revenue_totals, revenue_by_campaign: net revenue.
  • purchase_template_list, purchase_template_upsert, purchase_mail_preview: thank-you mail.
  • purchase_mail_send: send a sale's thank-you. Sends.
  • stripe_status, stripe_sync_run, stripe_catalog_sync, stripe_catalog_list, stripe_events_list, sync_runs_list: your Stripe connection.
  • form_list, form_get, form_create, form_update, form_set_reply, form_delete: signup forms.

Site

  • post_list, post_get, post_publish, post_unpublish, post_update: posts.
  • topic_list, topic_update: topics.
  • site_get, site_update: site settings.
  • theme_list, theme_activate: themes.

Mail and account

  • message_list, message_get: what went, what was suppressed, and why.
  • consent_check: whether a broadcast, a sequence, and a receipt would reach an address now.
  • suppression_list, suppression_add, suppression_remove: the way to stop mailing someone.
  • outbox_list: mail held in the outbox instead of sent.
  • template_list, template_get, template_create, template_update, template_delete: transactional templates.
  • webhook_list, webhook_create, webhook_update, webhook_delete, webhook_deliveries: webhooks.
  • log_search, log_types: the event log, kept 90 days.
  • stats_overview, health: the account now, and whether sending works.
  • mcp_audit_list: the newest API and MCP calls.
  • apikey_list, apikey_revoke: keys, never their secrets.

Things to know

  • Agents also get four resources (kolea://conventions, kolea://merge-tags, kolea://schema, kolea://stats/overview) and four prompts (weekly-review, launch-campaign, reconcile-stripe, draft-broadcast).
  • A tool that fails returns an error the agent can read, and the audit log records it.
  • Revoking the key cuts the agent off at once.