Lumail exposes a live, organization-aware tool catalog for programmatic email marketing. Use **MCP** when your assistant should call Lumail tools directly, or choose **Skills + CLI** when you want visible terminal commands and reusable workflows. The automatic setup can configure either method—or both—in one guided command.

<DocCardWrapper>

<DocSection title="Use Lumail in Your AI App">
  <DocCardGrid>
    <DocCard
      href="/docs/ai-integration/mcp-claude"
      icon="Terminal"
      title="Claude Code"
      description="Install the Lumail plugin. One prompt, a browser sign-in, no API token."
    />
    <DocCard
      href="/docs/ai-integration/mcp-codex"
      icon="Terminal"
      title="Codex"
      description="Connect the Codex CLI and app over OAuth. No token in config.toml."
    />
    <DocCard
      href="/docs/ai-integration/chatgpt-plugin"
      icon="Bot"
      title="ChatGPT"
      description="Connect Lumail as an OAuth app without copying an API token."
    />
    <DocCard
      href="/docs/ai-integration/hermes"
      icon="Terminal"
      title="Hermes"
      description="Install the native Lumail skill and manage email from Hermes."
    />
    <DocCard
      href="/docs/ai-integration/openclaw"
      icon="Bot"
      title="OpenClaw"
      description="Install Lumail from ClawHub and use it through OpenClaw."
    />
  </DocCardGrid>
</DocSection>

<DocSection title="Developer Integrations">
  <DocCardGrid>
    <DocCard
      href="/docs/ai-integration/skills-cli"
      icon="Terminal"
      title="Skills (CLI)"
      description="Automatically install the Lumail skill and CLI for terminal-based AI workflows."
    />
    <DocCard
      href="/docs/ai-integration/mcp-cursor"
      icon="Bot"
      title="Cursor (MCP)"
      description="Add Lumail tools to Cursor for AI-assisted email marketing."
    />
    <DocCard
      href="/docs/ai-integration/sdk-agents"
      icon="Code2"
      title="TypeScript SDK"
      description="Integrate Lumail into web apps, backends, scripts, and product automations."
    />
  </DocCardGrid>
</DocSection>

<DocSection title="API & Tools">
  <DocCardGrid>
    <DocCard
      href="/docs/ai-integration/tools-api"
      icon="Settings"
      title="Tools API (v2)"
      description="Discover and call the current tool catalog through one REST endpoint."
    />
    <DocCard
      href="/docs/api-reference/cli"
      icon="FileText"
      title="CLI"
      description="Run tools from your terminal with the Lumail CLI."
    />
    <DocCard
      href="/docs/ai-integration/examples"
      icon="Sparkles"
      title="Examples & Recipes"
      description="Real-world assistant workflows and automation patterns."
    />
  </DocCardGrid>
</DocSection>

</DocCardWrapper>

## Which Method Should I Use?

| Method                              | Best For                                            | Setup Time |
| ----------------------------------- | --------------------------------------------------- | ---------- |
| **OAuth app (ChatGPT/Codex)**       | Safe interactive assistant workflows                | 2 minutes  |
| **MCP (Claude/Cursor)**             | API-token interactive assistant workflows           | 2 minutes  |
| **Skills (Hermes/OpenClaw/Claude)** | Agent-driven terminal workflows                     | 2 minutes  |
| **TypeScript SDK**                  | Web apps, SaaS backends, product automations, CI/CD | 5 minutes  |
| **Tools API (REST)**                | Any language, webhooks, serverless functions        | 5 minutes  |
| **CLI**                             | Terminal workflows, scripts, quick operations       | 1 minute   |

## Available Tools

The exact catalog depends on the client safety profile. Tools are discovered dynamically across these categories:

| Category        | Examples                                                            |
| --------------- | ------------------------------------------------------------------- |
| **Subscribers** | Create, query, count, unsubscribe, and manage tags                  |
| **Campaigns**   | Draft, edit, render, test, schedule, inspect history, and analyze   |
| **Emails**      | Send transactional email and inspect deliverability                 |
| **Tags**        | Create, list, delete, and resolve by name                           |
| **Workflows**   | Configure complete graphs, publish versions, manage runs and groups |
| **Segments**    | Create, list, inspect, update, duplicate, and delete                |
| **Analytics**   | Organization, campaign, and subscriber performance                  |
| **Settings**    | Writing style, senders, snippets, fields, and organization settings |
| **Domains**     | Create, verify, and inspect DNS records                             |
| **Assets**      | Upload, list, describe, import, and export                          |