Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmaito.com/llms.txt

Use this file to discover all available pages before exploring further.

​
MCP Overview

Maito’s MCP server lets AI assistants work with Maito drafts, documents, and newsletters through the same backend/domain model used by the REST API and CLI.

​
Endpoint

https://mcp.getmaito.com/mcp

​
Implementation

  • Protocol: Model Context Protocol over Streamable HTTP
  • Auth: OAuth 2.1 through Clerk
  • Server surface: apps/mcp
  • Tool registration: apps/mcp/src/mcp/tools.ts
  • Domain logic: packages/backend
The MCP adapter should stay thin: validate MCP input, resolve auth/account context, call backend/domain services, and return MCP results.

​
Tool Scope

Tools are grouped by product model:
  • Draft tools for content creation, revision, scheduling, publishing, and unscheduling
  • Document tools for document retrieval, search, context assembly, and upsert
  • Newsletter settings tools
  • Newsletter issue tools
  • Newsletter subscriber and category tools
  • Newsletter analytics tools
See MCP tools for schemas and examples.

​
Capability Filtering

tools/list is capability-filtered. Clients should not assume that every registered tool is visible to every authenticated user.

​
Smoke Test

Use the smoke test script: 
MCP_ACCESS_TOKEN=... bun run mcp:smoke -- --base-url https://mcp.getmaito.com --tool draft.list --args '{"limit":1}'