MCP for AI agents
MCP Tool reference
The full verb-noun tool catalog. Names read like the action they take, so a model picks the right one without guesswork.
Server: mcp.mailnix.ch · transport: Streamable HTTP · spec: 2025-11-25 · auth: Bearer · 104 tools, 3 resources, 2 prompts.
Forms
form_createCreate a form from a schema: fields, validation, conditional logic, theme, layout grid.tool
form_updateEdit a draft or create a new version of a published form.tool
form_getFetch one form definition + status.tool
form_listList the org's forms.tool
form_publishPublish; returns the hosted forms.mailnix.ch URL.tool
form_pauseStop accepting submissions without unpublishing.tool
form_archiveRetire a form.tool
form_embed_snippet_generateHosted / iframe / script / fetch embed snippets, server-rendered.tool
form_submission_listPaginated submissions inbox with status + spam score.tool
form_submission_getOne submission's full field values + files.tool
form_submission_set_statusMove a submission between new / replied / archived / spam.tool
form_submission_waitBLOCKING long-poll until a submission arrives (default 30s, max 120s). Use for end-to-end embed tests.tool
form_reply_draft_createDraft a reply for user review; nothing is sent.tool
form_reply_sendSend ONE reply or confirmation for ONE submission. Recipient is locked server-side to the submitter; every send is audited. There is no bulk variant, by design.tool
Setup
email_provider_list_presetsReturns the curated webhoster + cloud provider catalog (cyon, Hostpoint, IONOS, …). Use when a user says "I host email at X".tool
email_provider_connectConnect a real SMTP provider or webhoster mailbox to a project. Defaults the new destination to sandbox mode.tool
email_destinations_listList the caller's destinations with mode + health summary.tool
email_domain_verify_statusCheck DKIM/SPF/DMARC verification state for a domain.tool
email_domain_verify_recordsReturn the exact DNS records to publish for a domain + destination.tool
Domains & identities
sending_domain_addRegister a sending domain; returns the DNS records to publish.tool
sending_domain_listList domains with verification state.tool
sending_domain_recheckRe-run DNS verification now.tool
sending_domain_deleteRemove a domain (idempotent).tool
sender_identity_addAdd a From identity under a verified domain.tool
sender_identity_listList identities.tool
sender_identity_list_for_domainIdentities scoped to one domain.tool
sender_identity_set_display_nameChange the display name.tool
sender_identity_set_destinationPin an identity to a destination.tool
sender_identity_deleteRemove an identity (idempotent).tool
Send & debug
email_send_testOne tool covers the full send surface: single + multi-recipient (to_extra), CC/BCC/attachments (Pro), reply_to with verified-domain check, RFC3339 send_at for scheduled (Pro, max 3 days), template_id + template_vars, optional template_version pin, idempotency_key. Returns trace_id + outcome.tool
email_trace_lookupFetch the full event timeline for a message_id, or recipient + time_window.tool
email_trace_searchFilter traces by status, time, recipient domain, or outcome.tool
email_template_createMint a saved template (Sprig syntax). Slug is the stable handle. Free-tier cap: 3 templates per user.tool
email_template_listReturns slug, name, and current version per row.tool
email_template_versions_listVersion history for diffing or pinning.tool
email_template_render_previewDry-run render at the latest version without sending.tool
email_template_deleteRemoves the template and every version (CASCADE).tool
email_scheduled_listList queued/canceled scheduled sends.tool
email_scheduled_cancelCancel a queued send before its send_at. Idempotent.tool
email_bulk_replayRe-dispatch matched traces through an alternate destination. Pro.tool
email_bulk_replay_statusParent + per-item progress for a bulk replay.tool
email_destination_set_shadowMirror sends to a second destination for migration validation (shadow send). Pro.tool
email_unsubscribe_mode_setConfigure RFC 8058 one-click unsubscribe header injection. Pro.tool
email_analytics_costCost + usage summary across the project's billable axes.tool
Inbound & inspect
email_inspect_address_createMint a per-test inspect address. Send a real message to it and we score deliverability.tool
email_inspect_report_getThe 17-check deliverability report for an inspect test.tool
email_inbound_route_createRegister a recipient pattern + webhook URL for durable inbound mail.tool
email_inbound_routes_listList registered inbound routes.tool
email_inbound_messages_listList captured inbound messages for a route.tool
email_sandbox_inbox_messages_listList captures in a sandbox inbox.tool
Operate
email_failover_policy_setSet a primary destination + fallback chain + trigger conditions.tool
email_routing_rule_createAdd a routing rule (match → destination, with priority).tool
email_routing_rules_listList routing rules in evaluation order.tool
email_routing_rule_updateEdit a rule's match or target.tool
email_routing_rule_deleteRemove a rule (idempotent).tool
email_suppression_listOrg-scoped paginated suppression list.tool
email_suppression_addManual suppression add. Idempotent on (org, email).tool
email_suppression_getSingle entry detail.tool
email_suppression_removeRemove from the suppression list.tool
email_suppression_bulk_importBatch add (max 1000 rows per call).tool
bounce_source_createMint HMAC secret + webhook URL for a bounce source. Providers: stalwart, postfix, dovecot, arf, mailenable. Returns secret once.tool
bounce_source_listList the org's bounce-source configs (metadata only).tool
bounce_source_getSingle config detail.tool
bounce_source_revokeIdempotent revoke.tool
mailenable_postoffice_map_createMap a MailEnable postoffice to a mailnix org/project for multi-tenant Windows hosting.tool
mailenable_postoffice_map_listList the calling org's MailEnable mappings.tool
mailenable_postoffice_map_deleteRemove a mapping (idempotent).tool
smtp_credential_createMint a username + password for SMTP submission to smtp.mailnix.ch. Returns password once.tool
smtp_credential_listMetadata-only listing (password is never re-displayed).tool
smtp_credential_rotateAtomic rotate; old credential stops authenticating immediately.tool
smtp_credential_updatePartial update of settings + constraints (label, default_destination_id, allowed_from_domains, rate limits, tracking toggles).tool
smtp_credential_test_connectionDestination-forward preflight (not a real send).tool
smtp_credential_usage_getSend counts + rate-limit state for a credential.tool
smtp_credential_connections_listRecent SMTP connections for a credential.tool
smtp_credential_auth_sessions_listRecent AUTH sessions (success / failure).tool
smtp_credential_bounces_listBounces attributed to a credential's sends.tool
smtp_credential_revokeIdempotent revoke.tool
Sub-projects (multi-tenant SaaS)
project_sub_createMint a sub-project under the caller's parent. Each child gets its own destinations, traces, quotas. Team tier.tool
project_sub_listList children of the parent the caller owns.tool
project_sub_deleteHard-delete the sub and CASCADE its traces + sandbox messages.tool
project_sub_set_quotaPer-sub send-cap override; null reverts to org default.tool
Outbound event webhooks
webhook_endpoint_createSubscribe a URL to delivered / bounced / complained / failed events. Returns the HMAC signing secret once (Stripe-style).tool
webhook_endpoint_listMetadata-only listing.tool
webhook_endpoint_rotate_secretAtomic re-mint; old secret stops verifying immediately.tool
webhook_endpoint_deleteIdempotent. CASCADE drops every attempt row.tool
webhook_attempts_listPer-attempt audit ledger: pending / succeeded / failed / parked.tool
Virtual inboxes
virtual_inbox_createRegister a recipient pattern as a saved filter + optional webhook + optional forward.tool
virtual_inbox_listList the project's inboxes.tool
virtual_inbox_getFetch one by UUID or registered pattern.tool
virtual_inbox_updateMutate name / notify URL / retention.tool
virtual_inbox_deleteRemove the inbox. Captured messages remain in sandbox_messages.tool
virtual_inbox_messages_listList captures matching the inbox pattern.tool
virtual_inbox_message_getFetch one capture's full body.tool
virtual_inbox_message_waitBLOCKING long-poll (load-bearing for agent test loops). Default 30s, max 120s.tool
virtual_inbox_messages_clearClear an inbox's captured messages.tool
Account
account_claimConvert anonymous to claimed via magic link.tool
account_statusReturns {anonymous, plan, project_id, claim_progress}. Poll claim_progress.claimed to detect the magic-link click.tool
Destination mode
destination_set_modeSwitch a destination between "sandbox" (capture only) and "live" (relay).tool
destination_promote_to_liveIdempotent "go live" wrapper. Returns already_live=true on the no-op path.tool
Publishable keys (reveal-URL flow)
publishable_key_createReturns { reveal_url, reveal_expires_in_seconds, key_preview }. The bare mnxpub_ token never appears in the tool result.tool
publishable_key_listAll keys' previews + constraints.tool
publishable_key_rotateAtomic revoke + re-mint. Returns a fresh reveal_url.tool
publishable_key_revokeKills the key.tool
Snippet generator
email_html_snippet_generateConsumes a reveal_url server-side, embeds the bare token in HTML, returns the rendered HTML. Two variants: "minimal" (vanilla JS) and "tailwind" (Tailwind play CDN). The bare token never appears anywhere except the .html field.tool
Safety directive
When publishable_key_create or publishable_key_rotate returns a reveal_url, an agent MUST NOT transcribe the URL contents into chat text, echo the URL as raw text, or fetch the URL client-side (the URL is single-use). The agent MAY pass it directly to email_html_snippet_generate or surface it as a clickable link the user opens in a browser.