> ## Documentation Index
> Fetch the complete documentation index at: https://docs.migma.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Connect AI agents to Migma with MCP, skills, setup workflows, and scoped agent auth.

Agents can work with Migma from coding tools, MCP clients, chat agents, and app builders. Use them to prepare emails, review output, manage contacts, create campaigns, export to ESPs, and wire safe backend sends.

Migma supports:

* **MCP Server** for Cursor, Claude, ChatGPT, Copilot, Codex CLI, Windsurf, Antigravity, Raycast, VS Code, and other MCP clients
* **Skills** for agents that install workflow instructions
* **Setup workflow** for adding Migma to an existing app
* **Agent handoff** from Create, Publish, API setup, and canvas export surfaces
* **Agent registration** so agents can request scoped access without key copy-paste
* **API, SDK, and CLI** when direct integration is better than agent tooling

## Where to start

* Open **Create** and click **Set up Migma with agent** to copy the `/setup` handoff prompt.
* Open **My Brands**, choose a brand, then open **Tools** for MCP and agent setup.
* Open **Settings → Developers → API Keys** for app and agent keys.
* Open **Settings → Developers → Webhooks** for event delivery.

## Developer tools

<CardGroup cols={2}>
  <Card title="MCP Server" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/mcp-server.svg?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=f5f7603fbb9a215d6bfd3b6390062008" href="/mcp-server" width="24" height="24" data-path="images/logos/mcp-server.svg">
    Connect an MCP client to create, validate, send, export, and manage email work.
  </Card>

  <Card title="Skills" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/skill.svg?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=16eaf6658a39a735ef9f2afd040eba19" href="/skills" width="24" height="24" data-path="images/logos/skill.svg">
    Install Migma workflows into Claude Code, Cursor, Codex, and other skill-aware agents.
  </Card>

  <Card title="Setup Workflow" icon="plug" href="/setup">
    Ask an agent to audit an app and wire Migma emails into backend send paths.
  </Card>

  <Card title="Agent Handoff" icon="copy" href="/agents/agent-handoff">
    Copy the right prompt from Migma into Claude Code, Codex, Cursor, or an app-builder agent.
  </Card>

  <Card title="Agent Registration" icon="key" href="/agent-registration">
    Let agents request scoped access with a user-approved code.
  </Card>
</CardGroup>

## MCP clients

<CardGroup cols={2}>
  <Card title="Cursor" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/cursor.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=1bc8ebb9727a9e7b6671d0c5a7dae482" href="/agents/mcp-cursor" width="120" height="120" data-path="images/logos/cursor.png">
    Add Migma MCP to Cursor project or global settings.
  </Card>

  <Card title="Claude" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/claude-code.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=21dc5dcc66f09660a16fbea3297333b4" href="/agents/mcp-claude" width="120" height="120" data-path="images/logos/claude-code.png">
    Connect Claude Desktop or Claude Code.
  </Card>

  <Card title="ChatGPT" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/chatgpt.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=f88137fa5b3adadac975427b68304728" href="/agents/mcp-chatgpt" width="120" height="120" data-path="images/logos/chatgpt.png">
    Add Migma MCP as a custom ChatGPT connector.
  </Card>

  <Card title="Copilot" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/copilot.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=a1ae89d7f530a9604e469be973f465d4" href="/agents/mcp-copilot" width="120" height="120" data-path="images/logos/copilot.png">
    Connect GitHub Copilot in VS Code or Copilot CLI.
  </Card>

  <Card title="Codex CLI" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/codex.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=a4b7a9b1b86045262a76ff6dd3067637" href="/agents/mcp-codex" width="120" height="120" data-path="images/logos/codex.png">
    Add Migma MCP to Codex CLI config.
  </Card>

  <Card title="Windsurf" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/windsurf.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=ebbece28d09dcab4e8a49b58e80e243c" href="/agents/mcp-windsurf" width="120" height="120" data-path="images/logos/windsurf.png">
    Connect Migma MCP to Windsurf Cascade.
  </Card>

  <Card title="Antigravity" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/antigravity.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=db40bf15f23a3195738b84f99c1b2148" href="/agents/mcp-antigravity" width="120" height="120" data-path="images/logos/antigravity.png">
    Add Migma MCP to Google Antigravity.
  </Card>

  <Card title="Raycast" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/raycast.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=0517327673bc3a44f7e48532e8fc00f0" href="/agents/mcp-raycast" width="120" height="120" data-path="images/logos/raycast.png">
    Use Migma MCP from Raycast AI.
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/vscode.svg?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=a33b2611b16ff0ff7f6a02f6d54c07b8" href="/agents/mcp-vscode" width="100" height="100" data-path="images/logos/vscode.svg">
    Connect Migma MCP to VS Code.
  </Card>
</CardGroup>

## AI app builders

Use Migma with app builders when you need real email sending, contact management, campaign sending, or webhooks behind an AI-built app.

<CardGroup cols={2}>
  <Card title="Lovable" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/lovable.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=20f45e55be5abfd91b95783e7afb197e" href="/agents/app-builder-lovable" width="120" height="120" data-path="images/logos/lovable.png">
    Wire Migma into Lovable backend sends.
  </Card>

  <Card title="Bolt" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/bolt.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=9ac9f2cac4dd8d9ee15cf14a66419d6a" href="/agents/app-builder-bolt" width="120" height="120" data-path="images/logos/bolt.png">
    Add Migma email sending to Bolt apps.
  </Card>

  <Card title="v0" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/v0.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=74822a0a928a8a979d846c29a9d3c418" href="/agents/app-builder-v0" width="120" height="120" data-path="images/logos/v0.png">
    Use Migma from generated app routes.
  </Card>

  <Card title="Replit" icon="https://mintcdn.com/migmaai/kT6TJgF40rDP8_qB/images/logos/replit.png?fit=max&auto=format&n=kT6TJgF40rDP8_qB&q=85&s=152058a6cf2a2ce13566c147cca9eade" href="/agents/app-builder-replit" width="120" height="120" data-path="images/logos/replit.png">
    Use Migma from Replit apps, agents, and jobs.
  </Card>

  <Card title="OpenClaw" icon="chat-bubble-left-right" href="/openclaw">
    Use Migma from WhatsApp, Telegram, Discord, and Slack.
  </Card>
</CardGroup>

## Best practices

**Start with the right surface.** Use Agent Handoff or `/setup` for app integration, MCP for interactive agent work, skills for repeatable workflows, and REST or SDK for production app code.

**Keep secrets server-side.** API keys belong in environment variables or secret stores, never browser code or chat transcripts.

**Ask before sending.** Keep human approval enabled before sending campaigns, exporting to ESPs, or changing audience data.

**Use scoped access.** Create the smallest key or agent scope needed for the task.

**Call capabilities first.** MCP agents should call `migma_get_capabilities` before choosing tools.