Superlines MCP Server

Superlines

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

Log in to analytics.superlines.io
Go to Organization Settings → API Keys
Click "Create New API Key"
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

Quit completely: ⌘+Q on Mac, or right-click taskbar icon → Exit on Windows
Reopen Claude Desktop
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

Tool	Description
`list_brands`	List all brands you have access to
`get_brand_details`	Get brand configuration, competitors, and industry
`analyze_metrics`	Brand visibility, citation rate, mentions, share of voice
`get_weekly_performance`	Weekly performance trends
`get_period_comparison`	Compare current vs previous period
`get_analytics_summary`	High-level analytics overview

Citations

Tool	Description
`get_citation_data`	Domain and URL citation analysis
`get_top_cited_url_per_prompt`	Top cited URLs per query

Competitor Analysis

Tool	Description
`analyze_brand_mentions`	Competitor mentions with sentiment scores
`get_competitive_gap`	Find competitive opportunities
`get_competitor_insights`	Comprehensive competitor overview
`get_best_performing_prompt`	Best performing prompts

Content Strategy

Tool	Description
`get_query_data`	Query analysis with search volumes
`find_content_opportunities`	Topics with improvement potential
`get_fanout_query_insights`	LLM source query analysis
`analyze_sentiment`	Sentiment analysis of AI responses

Webpage Analysis

Tool	Description
`webpage_crawl`	Fetch and parse webpage content
`webpage_audit`	Full LLM-friendliness audit
`webpage_analyze_technical`	Technical SEO analysis
`webpage_analyze_content`	Content quality analysis
`schema_optimizer`	Optimize Schema.org markup
`analyze_competitor_url`	Deep-dive analysis of competitor URLs

Environment Variables

Variable	Required	Description
`SUPERLINES_API_KEY`	Yes	Your Superlines API key (starts with `sl_live_`)
`MCP_SERVER_URL`	No	Override the default server URL
`DEBUG`	No	Set to `true` for debug logging

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"

Restart Claude Desktop completely (⌘+Q on Mac, not just close window)
Check the script path — use the full absolute path, not ~

Validate your config is valid JSON:

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

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

Support

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

License

MIT © Superlines