MCP Integration

What is the Outlit MCP Server?

Outlit’s MCP server lets AI agents query your customer data directly through the Model Context Protocol (MCP), an open standard for connecting AI tools to external data sources. Supported agents include Claude Code, Claude Desktop, Cursor, and any MCP-compatible client. Once connected, your AI agent can search customers, pull revenue metrics, inspect activity timelines, search customer context using natural language, and run SQL analytics — all from within your conversation.

Install Agent Skills

For the best experience, install Outlit agent skills to give your AI agent deeper context about query patterns, SDK integration, and best practices:

outlit setup skills

Skills are also installed automatically when running outlit setup. See Agent Skills for details.

How to Connect Your AI Tool

Get your API key

Go to Settings > MCP Integration in the Outlit dashboard. Click Generate API Key, give it a descriptive name, and copy it immediately — it won’t be shown again.

Connect your AI tool

Claude Code
Codex
Claude Desktop
Cursor

claude mcp add --transport http outlit https://mcp.outlit.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

codex mcp add outlit -- npx -y mcp-remote@latest https://mcp.outlit.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

Add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "outlit": {
      "url": "https://mcp.outlit.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving.

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "outlit": {
      "url": "https://mcp.outlit.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from Step 1.

Verify the connection

Ask your AI tool:

Show me the available Outlit analytics tables.

You should see a list of available analytics tables. If you get an authentication error, double-check your API key.

Treat your MCP API key like a password. It grants read access to your customer data. You can revoke keys at any time from the MCP Integration settings.

What Tools Are Available?

Tool	What it does	Example prompt
`outlit_list_customers`	Filter customers by billing status, activity recency, and revenue	”Show me paying customers with MRR above $100 who haven’t been active in 30 days”
`outlit_list_users`	Filter users by journey stage, activity, and customer	”Find all signed-up users at Acme Corp who went inactive this week”
`outlit_get_customer`	Get a complete customer profile with users, revenue, timeline, and metrics	”Get the full profile for acme.com including their users and revenue”
`outlit_get_timeline`	Get the activity timeline for a customer, filtered by channel and event type	”Show me Acme Corp’s email and Slack activity from the last 7 days”
`outlit_search_customer_context`	Search across customer facts and emails using natural language. Optionally scope to a single customer or search org-wide	”What pricing concerns does Acme have?”
`outlit_get_facts`	Retrieve structured customer facts with time filters and pagination	”Show me facts for acme.com from the last 30 days”
`outlit_query`	Run read-only SQL queries against your customer data	”Which channels lead to the most revenue?”
`outlit_schema`	Get table schemas to help write accurate SQL queries	”Show me the available analytics tables”

Getting Started

Concepts

Browser SDKs

Server SDKs

CLI

AI Integrations

Use Cases

What is the Outlit MCP Server?

Install Agent Skills

How to Connect Your AI Tool

What Tools Are Available?

Getting Started

Concepts

Browser SDKs

Server SDKs

CLI

AI Integrations

Use Cases

​What is the Outlit MCP Server?

​Install Agent Skills

​How to Connect Your AI Tool

​What Tools Are Available?

What is the Outlit MCP Server?

Install Agent Skills

How to Connect Your AI Tool

What Tools Are Available?