Docs:AI assistants and MCP

Connect

AI assistants and MCP

Use Mailiy with AI assistants: connect the remote MCP server, see which tools it offers, or read the OpenAPI spec and llms.txt.

Mailiy has an MCP server. AI assistants such as Claude, ChatGPT or Cursor use it to work with your account directly: create websites and forms, fetch the snippet, search submissions, release spam and set up integrations.

Remote MCP server

Address: https://mailiy.com/mcp (Streamable HTTP). Every request needs the header Authorization: Bearer mk_… with an API key. Many clients accept a configuration in this shape. Check your client's guide for the exact field names.

{
  "mcpServers": {
    "mailiy": {
      "type": "http",
      "url": "https://mailiy.com/mcp",
      "headers": { "Authorization": "Bearer mk_…" }
    }
  }
}

The assistant can do whatever the key allows. If it should only read, give it a read-only key. If you limit the key to one website, the assistant only sees that website's forms and submissions. Your account, recipient addresses and plan cannot be changed through MCP.

Tools

The server offers these tools:

  • list_websites
  • create_website
  • create_form
  • list_forms
  • get_snippet
  • get_submissions
  • search_website_submissions
  • search_submissions
  • get_stats
  • get_status
  • list_website_files
  • delete_file
  • mark_not_spam
  • send_test
  • preview_email
  • duplicate_form
  • rotate_access_key
  • list_integrations
  • create_integration
  • update_integration
  • delete_integration
  • test_integration
  • list_deliveries
  • retry_delivery

OpenAPI and llms.txt

For your own agents and scripts, the OpenAPI spec describes every route of the REST API. The file llms.txt sums up Mailiy for language models: endpoint, fields, error codes, plans. When you ask an assistant to build a form with Mailiy, it can look things up there.