Stellar MCP Server

Last Updated: 2026-07-04

The Stellar MCP server lets you chat with your experiment data from any AI assistant that supports the Model Context Protocol — Claude, Cursor, ChatGPT and more. Ask questions like “How is my pricing page experiment doing?” or “Which variant is winning this month?” and your assistant pulls live, read-only data from every project you have access to.

Pro Feature: MCP access works on projects with a paid plan. Generate your personal key from Account → Stellar MCP.

Quick Setup

  1. Go to your Account page and generate a personal MCP key in the Stellar MCP section. Keys look like stlu_... and are shown only once.
  2. Add the Stellar MCP server to your AI client using the endpoint below, passing your key as a Bearer token.
  3. Ask your assistant to list your Stellar projects — you're ready to go.
Endpoint:       https://api.gostellar.app/mcp
Authentication: Authorization: Bearer stlu_YOUR_KEY

Keep your MCP key secret. It grants read access to the data of every project you belong to. You can revoke or regenerate it at any time from your Account page.

Client Configuration

Cursor

Add this to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):

{
  "mcpServers": {
    "stellar": {
      "url": "https://api.gostellar.app/mcp",
      "headers": {
        "Authorization": "Bearer stlu_YOUR_KEY"
      }
    }
  }
}

Claude Desktop

Claude Desktop connects to remote servers through the mcp-remote bridge. Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.gostellar.app/mcp",
        "--header",
        "Authorization: Bearer stlu_YOUR_KEY"
      ]
    }
  }
}

Other clients

Any MCP client that supports remote servers over Streamable HTTP works. If your client supports custom headers, point it at https://api.gostellar.app/mcp with the Authorization header above. If it only supports local (stdio) servers, use the mcp-remote bridge as in the Claude Desktop example.

Available Tools

All tools are read-only. Your assistant decides which to call based on your question.

ToolWhat it returns
list_projectsAll projects you have access to, with ids, domains and roles
get_projectProject summary: name, domain, experiment count
list_experimentsExperiments for a project, filterable by status
get_experimentFull experiment detail: variants, visitors, conversions, statistical significance
get_project_mtuMonthly tracked users for a project (last 6 months)
get_account_usageCurrent-month MTU total and per-project breakdown
list_funnels / get_funnel_statsFunnel definitions and step-by-step drop-off stats
list_heatmap_pages / get_heatmap_hotspotsClick activity by page and the most-clicked elements on a page
list_opportunity_runs / get_opportunity_runAI CRO audit results with detected opportunities and suggested tests

Example questions

  • “Which of my experiments reached significance?”
  • “Compare conversion rates for the homepage hero test over the last 30 days.”
  • “How close am I to my monthly MTU limit?”
  • “Where do visitors drop off in my checkout funnel, and what do they click instead?”
  • “Summarize the CRO opportunities Stellar found on my pricing page.”

Security & Guardrails

  • Read-only. The MCP server cannot create, modify, launch or delete anything.
  • Scoped to your projects. Every tool call re-verifies that you are a member of the requested project. Your key never exposes other customers' data.
  • No raw database access. Tools return the same curated metrics you see in the dashboard — your assistant does the reasoning, not our database.
  • Revocable. Regenerating or revoking your key from the Account page immediately invalidates the old one.

Rate Limits

The MCP endpoint is rate-limited to 120 requests per minute. If you exceed this you'll receive a 429 Too Many Requests response; your assistant will typically retry automatically.

Prefer raw REST? The same data is available through the Stellar Data API with a project-scoped API key.

Need help? If you run into issues setting up the MCP server, reach out to us at hello@gostellar.app.