MCP Setup Guide

Prerequisites

Before you begin, make sure you have:

A paid Superlines plan — the MCP server is included on every plan (Starter, Pro, Growth, Enterprise, and the Agency plans)
Either an API key (format: sl_live_...) or an OAuth sign-in:
- API keys are available on Growth and Enterprise (and Agency Growth and Agency Enterprise), from Organization Settings
- OAuth works on every plan, including Starter and Pro — use it with Claude.ai or any MCP client that supports OAuth sign-in, pointing it at https://mcpsse.superlines.io
An MCP-compatible client installed

On Starter and Pro, API keys are not available, so the API-key and npx methods below won’t work. Connect with OAuth instead.

Connection methods

Method	Protocol	Best for
OAuth	OAuth 2.0 + SSE	Claude.ai — no API key needed
SSE (URL-based)	Server-Sent Events	Claude Desktop, Cursor, ChatGPT, n8n, Windsurf, Lovable, most clients
Local npx	Standard I/O	Cursor, Claude Desktop, VS Code — runs locally on your machine
CLI	Varies	Claude Code — add servers from the terminal

SSE connection URL:

https://mcpsse.superlines.io?token=YOUR_API_KEY

Replace YOUR_API_KEY with your actual API key.

Choose your platform

Claude.ai

OAuth — no API key needed

Claude Desktop

SSE or local npx

Claude Code

CLI — one command setup

Cursor

SSE or local npx

Cursor Cloud

SSE — remote agents

Windsurf

SSE or local npx

Lovable

SSE via Settings UI

ChatGPT

Connector URL

n8n

MCP Client node

VS Code

SSE or local npx

Claude.ai

Method: OAuth — no API key needed. You authorize access with your Superlines account.

Open Claude.ai settings

Go to claude.ai → Settings → Connectors → Add custom connector.

Enter the server details

Name: Superlines
URL: https://mcpsse.superlines.io
Open Advanced settings and set OAuth Client ID to anthropic-claude
Leave OAuth Client Secret blank
Click Add

Authorize access

Claude will redirect you to the Superlines authorization page. Sign in with your Superlines account, review the requested permissions, select which brands to share, and click Authorize Access.

Start using Superlines

Back in Claude, start a new conversation and try: “List my Superlines brands”

OAuth connections are scoped to the brands you select during authorization. You can revoke access at any time from your Superlines account settings.

Claude Desktop

Method: SSE (recommended) or local npx. Both use the claude_desktop_config.json config file.

Open Claude Desktop settings

Go to Settings → Developer → Edit Config to open:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%\Claude\claude_desktop_config.json

Add the Superlines server

SSE (recommended)
Local npx

{
  "mcpServers": {
    "superlines": {
      "url": "https://mcpsse.superlines.io?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requires Node.js installed on your machine.

Restart Claude Desktop

Save the file and fully restart the app for changes to take effect.

Claude Code

Method: CLI — add the server directly from your terminal with one command.

Add the Superlines server

Run one of these commands in your terminal:

SSE (recommended)
Local npx

claude mcp add --transport sse superlines \
  "https://mcpsse.superlines.io?token=YOUR_API_KEY"

claude mcp add --transport stdio \
  --env SUPERLINES_API_KEY=YOUR_API_KEY \
  superlines -- npx -y @superlines/mcp-server

Requires Node.js installed on your machine.

Verify the connection

claude mcp list

You should see superlines in the list of connected servers.

Start using Superlines

In your Claude Code session, try: “List my Superlines brands”

Use the --scope flag to control where the configuration is stored:

--scope local (default) — private to you, this project only
--scope project — shared via .mcp.json, checked into git
--scope user — available across all your projects

Cursor

Method: SSE (recommended) or local npx via .cursor/mcp.json.

Open MCP settings

Go to Cursor Settings → Tools & MCP → Add new MCP server, or create/edit the .cursor/mcp.json file in your project root.

Add the Superlines server

SSE (recommended)
Local npx

{
  "mcpServers": {
    "superlines": {
      "url": "https://mcpsse.superlines.io?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requires Node.js installed on your machine.

Restart Cursor

Restart Cursor for the changes to take effect. You should see the Superlines server listed under Tools & MCP in settings.

Cursor Cloud

Method: SSE only — cloud agents run in remote VMs, so local npx is not available.

Since Cursor Cloud agents run in a remote environment, only the SSE (URL-based) connection method works.

Add the Superlines server

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

{
  "mcpServers": {
    "superlines": {
      "url": "https://mcpsse.superlines.io?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

Commit the config

Commit the .cursor/mcp.json file to your repository so it’s available in the cloud environment.

Verify in cloud session

When using a Cursor Cloud agent, the Superlines tools will be available automatically. Try asking: “List my Superlines brands”

Local npx transport does not work with Cursor Cloud agents. Always use the SSE method for cloud environments.

Windsurf

Method: SSE URL or local npx via mcp_config.json. You can also browse the built-in MCP Marketplace.

Open MCP configuration

In Windsurf, click the Plugins icon in the sidebar → Manage plugins → View raw config, or edit the file directly:

~/.codeium/windsurf/mcp_config.json

Add the Superlines server

SSE (recommended)
Local npx

{
  "mcpServers": {
    "superlines": {
      "serverUrl": "https://mcpsse.superlines.io?token=YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requires Node.js installed on your machine.

Refresh Windsurf

Save the file and restart Windsurf, or refresh the MCP plugins from the sidebar.

Windsurf supports environment variable interpolation in MCP configs. You can use ${env:SUPERLINES_API_KEY} in the serverUrl to reference environment variables instead of hardcoding your key.

Lovable

Method: SSE URL via Settings UI. Custom MCP servers are available on all paid Lovable plans.

Open connector settings

Go to Settings → Connectors → Personal connectors and click New MCP server.

Enter the server details

Server name: Superlines
Server URL: https://mcpsse.superlines.io?token=YOUR_API_KEY
Authentication: Select No authentication (the API key is included in the URL)

Add the server

Click Add. The Superlines server now appears in your list of personal connectors.

Use in your project

In any Lovable project, the Superlines tools are now available to the AI agent. Try prompting: “Use Superlines to show my brand visibility”

You can also use Bearer token authentication. Set the Server URL to https://mcpsse.superlines.io and enter your API key (format: sl_live_...) as the bearer token.

ChatGPT

Method: MCP Connector via Settings. Requires a ChatGPT Plus or Pro subscription with Developer Mode enabled.

Enable Developer Mode

In ChatGPT, go to your profile → Settings → Apps & Connectors → Advanced settings (at the bottom of the page) and toggle on Developer Mode.

Create a connector

Go to Settings → Apps & Connectors and click Create.

Enter the server details

Name: Superlines
Description: AI Search Intelligence — mentions, share of voice, citations and competitors
MCP Server URL: https://mcpsse.superlines.io?token=YOUR_API_KEY

Confirm and create

Check the confirmation box and click Create. You should see the available Superlines tools listed.

Start using Superlines

Open a new ChatGPT conversation, click the + button near the message composer, select More, then choose the Superlines connector. Try: “List my Superlines brands”

ChatGPT connectors require a remote HTTPS endpoint. Local npx servers do not work with ChatGPT. MCP support in ChatGPT is currently in beta and may evolve — check OpenAI’s documentation for the latest setup steps.

n8n

Method: MCP Client node over SSE. Use this when a marketing or agency workflow should pull Superlines data on a schedule — for example a Monday digest per brand or market into Slack, Teams or Sheets.

Add an MCP Client node

In an n8n workflow, add an MCP Client node. If an AI Agent should call Superlines as a tool, use MCP Client Tool instead and connect it to the agent.

Set the server

Server Transport: SSE
Endpoint: https://mcpsse.superlines.io
Authentication: Bearer Auth, with your Superlines API key (sl_live_...) as the token

You can also put the key in the URL and set authentication to None:

https://mcpsse.superlines.io?token=YOUR_API_KEY

Choose a tool and run it

n8n loads the Superlines tools from the server. Pick one — for example list brands or a metrics query — fill in the parameters, and execute the node.A typical agency or enterprise workflow is: schedule trigger → MCP Client (period comparison for each brand or market) → Slack, email or a spreadsheet.

Parameter names in n8n are Server Transport, Endpoint (shown as MCP Endpoint URL in current n8n docs) and Authentication. If SSE does not connect, try the HTTP transport against the same endpoint. API keys are available on Growth and Enterprise.

VS Code

Method: SSE or local npx. The config format depends on your MCP extension (e.g., GitHub Copilot, Continue, Cline).

Open your MCP configuration

Check your MCP extension’s documentation for the config file location. Common locations include .vscode/mcp.json in your project root or the extension’s global settings.

Add the Superlines server

SSE (recommended)
Local npx

{
  "mcpServers": {
    "superlines": {
      "url": "https://mcpsse.superlines.io?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

{
  "mcpServers": {
    "superlines": {
      "command": "npx",
      "args": ["-y", "@superlines/mcp-server"],
      "env": {
        "SUPERLINES_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requires Node.js installed on your machine.

Restart VS Code

Restart VS Code for the changes to take effect.

Other MCP clients

Any MCP-compatible client can connect to Superlines using the SSE endpoint:

https://mcpsse.superlines.io?token=YOUR_API_KEY

Add this URL as an SSE transport server in your client’s MCP configuration. Consult your client’s documentation for the specific config format. For clients that support local process-based connections, use the npm package:

npx -y @superlines/mcp-server

Set the SUPERLINES_API_KEY environment variable to your API key.

API key permissions

By default, API keys have read-only access — they can query analytics data but cannot modify your account. To use the Account Management tools (creating brands, adding prompts, etc.), you need to enable write permissions on your API key.

How to enable write permissions

Go to Organization Settings

Open Organization Settings → API Keys in the Superlines dashboard.

Edit your API key

Click on the API key you use for MCP and open its permissions settings.

Enable write permissions

Toggle on the permissions you need:

write:brands — allows creating new brands/domains
write:prompts — allows adding, pausing, unpausing prompts and managing labels

Save and reconnect

Save your changes. No client restart is needed — permissions take effect immediately.

Available permissions

Permission	Grants access to
`read`	All analytics and reporting tools (default, always included)
`write:brands`	`create_brand`, `get_brand_setup_status`
`write:prompts`	`add_prompts`, `pause_prompts`, `unpause_prompts`, `update_prompt_labels`

Write operations are rate-limited and audit-logged for security. Brand creation is limited to 5 per hour, and prompt operations to 100 per hour per organization. All write actions are recorded in your organization’s audit log.

Deletion is intentionally not supported via MCP to prevent accidental data loss. Use pause_prompts to temporarily disable prompts instead.

Verify the connection

After setting up your client:

Start a new conversation
Ask: “List my Superlines brands”
The AI should call the list_brands tool and show your brands

If it works, try:

“Show me my brand visibility for the last 30 days”
“Who are my top competitors?”
“Find content opportunities where I have low visibility”

Troubleshooting

Issue	Solution
”Tool not found”	Restart your MCP client after configuration changes
”Authentication failed”	Verify your API key is correct and starts with `sl_live_`
”No data returned”	Make sure you have at least one brand with tracked prompts
”Connection timeout”	Check your internet connection; the SSE endpoint is at `mcpsse.superlines.io`
”Plan not supported”	MCP requires an active paid plan (Starter, Pro, Growth, Enterprise, or an Agency plan)
Can’t generate an API key	API keys are available on Growth and Enterprise. On Starter and Pro, connect with OAuth
”Command not found” (npx)	Ensure Node.js is installed and `npx` is in your PATH
Server hangs on connection	Try the SSE method instead of npx — it’s more reliable for remote connections
ChatGPT connector not visible	Confirm Developer Mode is enabled and you have a Plus or Pro subscription
Lovable tools not available	Make sure your Lovable plan supports custom MCP servers (paid plans)
Windsurf server not loading	Check that `mcp_config.json` is valid JSON — trailing commas cause silent failures

Never share your API key publicly. If compromised, revoke it immediately in Organization Settings and generate a new one.

MCP Server

REST API

Integrations

Prerequisites

Connection methods

Choose your platform

Claude.ai

Claude Desktop

Claude Code

Cursor

Cursor Cloud

Windsurf

Lovable

ChatGPT

n8n

VS Code

Claude.ai

Claude Desktop

Claude Code

Cursor

Cursor Cloud

Windsurf

Lovable

ChatGPT

n8n

VS Code

Other MCP clients

API key permissions

How to enable write permissions

Available permissions

Verify the connection

Troubleshooting

Resources

​Prerequisites

​Connection methods

​Choose your platform

Claude.ai

Claude Desktop

Claude Code

Cursor

Cursor Cloud

Windsurf

Lovable

ChatGPT

n8n

VS Code

​Claude.ai

​Claude Desktop

​Claude Code

​Cursor

​Cursor Cloud

​Windsurf

​Lovable

​ChatGPT

​n8n

​VS Code

​Other MCP clients

​API key permissions

​How to enable write permissions

​Available permissions

​Verify the connection

​Troubleshooting

​Resources

Prerequisites

Connection methods

Choose your platform

Claude.ai

Claude Desktop

Claude Code

Cursor

Cursor Cloud

Windsurf

Lovable

ChatGPT

n8n

VS Code

Other MCP clients

API key permissions

How to enable write permissions

Available permissions

Verify the connection

Troubleshooting

Resources