Superlines MCP Server

Model Context Protocol (MCP) server for Superlines AI visibility analytics.

Connect Claude Desktop, Cursor, or any MCP-compatible client to your Superlines data.

Quick Start • Available Tools • Troubleshooting

What is this?

Superlines tracks how your brand appears in AI-powered search engines like ChatGPT, Perplexity, Gemini, and Claude. This MCP server lets you query your Superlines analytics data directly from AI assistants.

Ask questions like:

• "What's my brand visibility this month vs last month?"
• "Which domains are getting cited most in AI responses?"
• "Show me my top competitors by share of voice"
• "Audit my website for LLM-friendliness"

Features

• 📊 Brand Analytics — Visibility metrics, citations, share of voice
• 🏆 Competitor Analysis — Benchmark against competitors with sentiment analysis
• 🔗 Citation Tracking — See which URLs are cited in AI responses
• 📈 Trend Analysis — Weekly and monthly performance trends
• 🔍 Webpage Auditing — LLM-friendliness analysis for any URL
• 🛠️ Schema Optimization — Generate optimized Schema.org markup

Prerequisites

• Node.js 18+ installed (Download)
• Superlines account with Enterprise plan (MCP access is Enterprise-only)
• API Key from your Superlines dashboard

Quick Start

Step 1: Get Your API Key

1. Log in to analytics.superlines.io
2. Go to Organization Settings → API Keys
3. Click "Create New API Key"
4. Copy the key (starts with sl_live_) — it's only shown once!

Step 2: Configure Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

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

Important: Replace sl_live_YOUR_API_KEY with your actual API key.

Step 3: Restart Claude Desktop

1. Quit completely: ⌘+Q on Mac, or right-click taskbar icon → Exit on Windows
2. Reopen Claude Desktop
3. Verify: Look for the hammer icon (🔨) indicating MCP tools are available

Step 4: Start Asking Questions!

What brands do I have access to in Superlines?

Show me my brand visibility for the last 30 days

Audit https://example.com for LLM-friendliness

Alternative: Local Proxy Script

If you prefer not to use npx, you can download and run the proxy script locally.

Download the Proxy Script

macOS / Linux:

mkdir -p ~/superlines-mcp
curl -o ~/superlines-mcp/mcp-proxy.js https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js
chmod +x ~/superlines-mcp/mcp-proxy.js

Windows (PowerShell):

mkdir $env:USERPROFILE\superlines-mcp
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Superlines/mcp-server/main/mcp-proxy.js" -OutFile "$env:USERPROFILE\superlines-mcp\mcp-proxy.js"

Configure Claude Desktop (Local Proxy)

macOS:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/superlines-mcp/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\superlines-mcp\\mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_USERNAME with your actual username. Find it by running echo $USER (macOS) or echo %USERNAME% (Windows).

Configuration for Other MCP Clients

Cursor

Add to .cursor/mcp.json in your project or globally:

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

VS Code with Continue

Add to your Continue configuration:

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

Global Installation (Alternative)

If you prefer to install globally instead of using npx:

npm install -g @superlines/mcp-server

Then use this configuration:

{
  "mcpServers": {
    "superlines": {
      "command": "superlines-mcp",
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

Available Tools

Brand Analytics

Citations

Competitor Analysis

Content Strategy

Webpage Analysis

Environment Variables

Example Queries

Performance Analysis

Show me brand visibility and citations for the last 30 days, grouped by LLM service

Competitor Intelligence

Who are my top 10 competitors by mentions? Show sentiment breakdown.

Citation Analysis

Which domains are cited most in AI responses about my industry?

Weekly Trends

Show me weekly performance for the last 8 weeks

Webpage Audit

Audit https://competitor.com for LLM-friendliness and show me what schemas they use

Content Opportunities

What content should I create to improve my AI search visibility?

Troubleshooting

"SUPERLINES_API_KEY environment variable not set"

Make sure your config includes the env section with your API key:

{
  "mcpServers": {
    "superlines": {
      "command": "node",
      "args": ["/path/to/mcp-proxy.js"],
      "env": {
        "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY"
      }
    }
  }
}

"401 Unauthorized"

• Your API key is invalid or expired
• Generate a new key at Organization Settings → API Keys

"403 Forbidden"

• API access requires an Enterprise plan
• Contact support@superlines.io to upgrade

Claude says "I don't have access to any tools"

1. Restart Claude Desktop completely (⌘+Q on Mac, not just close window)
2. Check the script path — use the full absolute path, not ~
3. Validate your config is valid JSON:

   cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
   

4. Test the proxy manually:

   export SUPERLINES_API_KEY="sl_live_your_key"
   echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node ~/superlines-mcp/mcp-proxy.js
   

   You should see a JSON response listing available tools.

Script not found

• Use the full absolute path in your config
• ✅ Good: /Users/john/superlines-mcp/mcp-proxy.js
• ❌ Bad: ~/superlines-mcp/mcp-proxy.js
• Windows: Use double backslashes: C:\\Users\\john\\...

Security

• 🔒 Never share your API key publicly
• 🔒 Don't commit claude_desktop_config.json to version control
• 🔒 Rotate keys regularly in Organization Settings
• 🔒 Revoke keys immediately if compromised

Secure your config file:

chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

Beta Notice

⚠️ The Superlines MCP server is currently in beta and may experience instability or contain bugs. Please report issues at github.com/Superlines/mcp-server/issues.

Resources

• Superlines Dashboard
• API Documentation
• MCP Protocol Specification
• Claude Desktop

Support

• Email: support@superlines.io
• Issues: github.com/Superlines/mcp-server/issues

License

MIT © Superlines