MailKatana exposes two developer-facing interfaces:
  • The REST API for direct application integrations.
  • The MCP server for AI agents that need a tool-based interface.

​
What this site covers

This first docs-site slice is intentionally narrow.
  • REST API guides focus on developer-facing Bearer API workflows plus webhook setup.
  • The generated REST API reference also includes session-authenticated workspace routes, public browser endpoints, provider webhooks, and internal bridge routes mounted on the same public binary.
  • MCP docs cover the stable implemented tool surface only.
  • Direct requests to the protected MCP SSE endpoints return 401 until you send Authorization: Bearer YOUR_API_KEY.

​
Start here

  1. Read the quickstart to make your first request.
  2. Use the REST API overview if you are integrating from your own backend.
  3. Use the MCP overview if you are connecting an AI client.

​
Source of truth

  • REST API reference pages are generated from the OpenAPI file at /openapi/public-api.openapi.yaml.
  • MCP pages are written against the live implementation in the internal/mcp package.