mailnix / MCP overview

    MCP for AI agents

    MCP overview

    mailnix exposes a Model Context Protocol server at mcp.mailnix.ch. Full conformance to spec 2025-11-25 over Streamable HTTP.

    What MCP is

    Model Context Protocol is the open standard for connecting AI clients (Claude, ChatGPT, Cursor, Continue, Windsurf, VS Code, Zed) to a tool surface. mailnix's MCP server gives every connected assistant a verb-noun tool catalog covering provider setup, send, trace lookup, forms, suppression management, and the agent end-to-end build loop.

    Connect a client

    Point your client at https://mcp.mailnix.ch. Clients that follow the spec walk the OAuth dance themselves; you'll see a one-time browser tab to confirm the connection. The seeded mailnix-anonymous-bootstrap client mints a working sandbox bearer in one call when no user identity is available.

    Discovery

    # protected-resource metadata (RFC 9728)
    GET https://mcp.mailnix.ch/.well-known/oauth-protected-resource
    
    # authorization-server metadata (RFC 8414)
    GET https://app.mailnix.ch/.well-known/oauth-authorization-server

    Tool catalog

    104 verb-noun tools: form_create, form_submission_wait, email_send_test, email_trace_lookup, email_provider_connect, virtual_inbox_message_wait, publishable_key_create. See the full tool reference.

    Resources

    • project://current: your project + plan tier + quotas.
    • code://snippet/{lang}/{framework}/{use_case}: ready-to-paste integration code.
    • docs://guide/{topic}: focused doc snippets.

    Prompts (guided flows)

    • set_up_transactional_email: preset lookup, provider connect, domain verify, first traced send.
    • diagnose_missing_email: root-cause a missing message from a recipient and a time window.