Lutains MCP Server Reference

# Connect your editor to real customer language

The Lutains MCP Server connects Claude Code or Cursor to validated prospect intelligence — pain points mined from Reddit, psychological agent profiles, and a CRO expert that critiques your landing page copy.

No prompt engineering. No context switching. Just install, authenticate, and write.

# Connecting

The server uses OAuth 2.0 (authorization code flow) and the standard MCP protocol over Streamable HTTP.

Setting	Value
Transport	Streamable HTTP (`POST /mcp`)
Auth	OAuth 2.0 with Clerk identity provider
Client registration	`POST /oauth/register`
Authorize URL	`GET /authorize`
Token endpoint	`POST /oauth/token`

Prerequisite: You need a Lutains account with at least one project created at app.lutains.com. The server resolves your identity from your login session.

# Tools

# `chat_with_client_agent`

Chat with a client persona — an AI agent built from your market's Reddit conversations. It reacts to your copy the way a real prospect would: skeptical, short-attention-spanned, using their actual vernacular.

Parameter	Type	Required	Description
`id`	string	Yes	ID of the client agent (persona)
`projectId`	string	Yes	ID of your project
`message`	string	Yes	Your message (paste copy, ask for reactions, etc.)

Returns: Plain text — the agent's raw reaction, 2-4 short paragraphs.

Use when: You want an unfiltered prospect perspective on a headline, a section, or a full page.

# `chat_with_tim`

Chat with Tim — the system CRO expert. Tim channels your client persona's perspective through 10 years of conversion copywriting experience. He critiques, diagnoses, and gives you specific actions.

Parameter	Type	Required	Description
`projectId`	string	Yes	ID of your project
`message`	string	Yes	Your message (a page URL, copy to review, a question)

Returns: Plain text — structured feedback through Tim's 3-phase workflow:

Persona Gateway — Tim asks you to consult the persona first for a raw reaction

7-Point Debrief — Structured diagnostic: scroll depth, hero clarity, the real blocker, price/value ratio, benefits vs features, what works, the #1 change

3 Doors — Three specific paths to follow (rewrite the hero, before/after proof, price & proof of life)

Use when: You want expert CRO analysis that's grounded in your actual prospect's perspective, not generic advice.

# `get_agents`

List all agents available for your account.

Parameter	Type	Required	Description
(none)

Returns: JSON with two arrays:

projectsWithAgents — Your projects and their persona agents (with assigned pain points)

systemAgents — System-level agents (Tim, the CRO copywriter)

Use when: You need to discover agent IDs before calling chat_with_client_agent.

# `update_agent`

Select which pain point a persona focuses on during conversations.

Parameter	Type	Required	Description
`id`	string	Yes	ID of the agent to update
`painPointId`	string	No	ID of the pain point to activate (omit to de-select all)

Returns: Confirmation.

Use when: You want to steer the agent's perspective — focus it on frustration, anxiety, or a specific objection your market has.

# Setup in Claude Code

Add this to your claude_desktop_config.json or .mcp.json:

  {
  "mcpServers": {
    "lutains": {
      "type": "http",
      "url": "https://agents.lutains.com/mcp",
      "auth": "oauth"
    }
  }
}

When you first use a Lutains tool, Claude Code will open a browser for OAuth. Log in with your Lutains account and the connection is persisted.

# Setup in Cursor

Add to your Cursor MCP configuration:

  {
  "mcpServers": {
    "lutains": {
      "transport": "sse",
      "url": "https://agents.lutains.com/mcp",
      "auth": {
        "type": "oauth"
      }
    }
  }
}

Cursor will handle the OAuth flow automatically on first use.

# Quick start

Create your project at app.lutains.com

Add the MCP server config to your editor (see above)

Call get_agents to discover your project and agent IDs

Start chatting: chat_with_tim for a CRO audit, or chat_with_client_agent for a raw prospect reaction