Superlines MCP Server

README.md•11 kB

# Superlines MCP Server <img src="https://superlines.io/logos/superlines_logo.svg" alt="Superlines" width="200" /> Model Context Protocol (MCP) server for Superlines AI visibility analytics. Connect Claude Desktop, Cursor, or any MCP-compatible client to your Superlines data. <a href="https://www.npmjs.com/package/@superlines/mcp-server"><img src="https://img.shields.io/npm/v/@superlines/mcp-server.svg" alt="npm version"></a> <a href="https://www.npmjs.com/package/@superlines/mcp-server"><img src="https://img.shields.io/npm/dm/@superlines/mcp-server.svg" alt="npm downloads"></a> <a href="https://github.com/Superlines/mcp-server/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@superlines/mcp-server.svg" alt="license"></a> <a href="#quick-start">Quick Start</a> • <a href="#available-tools">Available Tools</a> • <a href="#troubleshooting">Troubleshooting</a> --- ## 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](https://nodejs.org/)) - **Superlines account** with **Enterprise plan** (MCP access is Enterprise-only) - **API Key** from your [Superlines dashboard](https://analytics.superlines.io/settings/api-keys) --- ## Quick Start ### Step 1: Get Your API Key 1. Log in to [analytics.superlines.io](https://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: ```json { "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:** ```bash 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):** ```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:** ```json { "mcpServers": { "superlines": { "command": "node", "args": ["/Users/YOUR_USERNAME/superlines-mcp/mcp-proxy.js"], "env": { "SUPERLINES_API_KEY": "sl_live_YOUR_API_KEY" } } } } ``` **Windows:** ```json { "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: ```json { "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: ```json { "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: ```bash npm install -g @superlines/mcp-server ``` Then use this configuration: ```json { "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: ```json { "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](https://analytics.superlines.io/settings/api-keys) ### "403 Forbidden" - API access requires an Enterprise plan - Contact [support@superlines.io](mailto: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: ```bash cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool ``` 4. **Test the proxy manually:** ```bash 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: ```bash 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](https://github.com/Superlines/mcp-server/issues). --- ## Resources - [Superlines Dashboard](https://analytics.superlines.io) - [API Documentation](https://superlines.io/docs/api) - [MCP Protocol Specification](https://modelcontextprotocol.io) - [Claude Desktop](https://claude.ai/download) ## Support - **Email:** [support@superlines.io](mailto:support@superlines.io) - **Issues:** [github.com/Superlines/mcp-server/issues](https://github.com/Superlines/mcp-server/issues) --- ## License MIT © [Superlines](https://superlines.io)

Loading blob content...

Latest Blog Posts

How to Test MCP Streamable HTTP Endpoints Using cURL
By punkpeye on January 2, 2026.
tutorial
bash
What is Streamable HTTP in MCP?
By punkpeye on January 2, 2026.
Streamable HTTP
What Is Context Bloat in MCP?
By Om-Shree-0709 on December 16, 2025.
mcp
Context Bloat

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Superlines/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

README.md•11 kB