MCP Server Setup

Connect AI assistants to your Outly account via the Model Context Protocol. All API endpoints are available as MCP tools.

What you can do

Once connected, your assistant manages your Outly account directly: campaigns, personas, contacts, conversations, messages, engagements, and analytics. For example:

Show analytics for my active campaigns
List unread conversations and draft replies
Import 50 product managers in Berlin into my SaaS campaign
Create a campaign targeting logistics founders in Canada

Authentication

The MCP server supports two authentication methods:

OAuth 2.1	Automatic: Claude.ai, ChatGPT, Claude Code, and Codex CLI all redirect you to Outly for authorization
API Key	Fallback for clients that cannot perform OAuth browser redirects (headless scripts, CI pipelines, custom integrations). Generate a key from Settings → Developers

Note: Claude Code and Codex CLI prefer OAuth when available. Do not pass an API key header alongside OAuth — the two methods conflict.

Server Details

URL	`https://mcp.useoutly.com`
Transport	StreamableHTTP (`POST`)
Auth	`Authorization: Bearer <token>`

 1. Claude
 Claude.ai (Web)
 Go to Settings → Connectors → Add custom connector and enter:
 https://mcp.useoutly.com
 Claude.ai supports OAuth — you'll be redirected to Outly to authorize access. No API key needed.
 Claude Desktop (App)
 Claude Desktop supports remote MCP servers via Settings → Connectors → Add custom connector, same OAuth flow as Claude.ai. Connectors added on Claude.ai sync to the desktop app.
 If OAuth is not an option (headless or restricted setups), use the mcp-remote bridge with an API key:
 {
  "mcpServers": {
    "outly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.useoutly.com",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
 2. ChatGPT
 Requires Developer Mode, available on Plus, Pro, Business, Enterprise, and Edu plans.
 In ChatGPT settings, enable Developer Mode, then add an MCP connection:
 https://mcp.useoutly.com
 ChatGPT supports OAuth — you'll be redirected to Outly to authorize access. No API key needed.
 3. Developer Tools
 Claude Code (CLI)
 Claude Code supports OAuth natively. Add the MCP server and authorize via browser:
 claude mcp add outly --transport http https://mcp.useoutly.com
 On first use, Claude Code will open the Outly OAuth flow in your browser. No API key needed.
 Codex CLI
 Codex CLI also supports OAuth. Add the server, then authenticate via browser:
 codex mcp add outly --url https://mcp.useoutly.com
codex mcp login outly
 Or declare it in ~/.codex/config.toml:
 [mcp_servers.outly]
url = "https://mcp.useoutly.com"
 No API key needed.
 Headless / CI (API Key)
 For environments without a browser (CI pipelines, headless scripts), use a user-owned API key:
 claude mcp add outly --transport http https://mcp.useoutly.com --header "Authorization: Bearer YOUR_API_KEY"