Setup Guide: Superlines MCP, Sanity MCP, and AEO Agent for Non-Technical Users

This guide walks you through three separate setups:

Part A — Connecting the Superlines MCP server to Cursor and Claude Desktop so your AI assistant can analyze your AI search visibility, find content opportunities, audit webpages, and more.
Part B — Connecting the Sanity MCP server to Cursor and Claude Desktop so your AI assistant can read, write, and manage your Sanity content directly.
Part C — Setting up the Superlines AEO Agent in your Cursor project so it can run a daily content intelligence pipeline.

You do not need any programming experience. Each step includes exactly what to type or click.

Want the deep technical guide instead? If you are a developer who wants to understand the architecture and build the agent from scratch, see Build an Agentic AEO Content Pipeline.

Part A: Set up the Superlines MCP server

The Superlines MCP server connects your AI assistant to your AI search analytics data. Once connected, you can ask Cursor or Claude Desktop to show your brand visibility trends, find content opportunities, audit webpages for AI search readiness, analyze competitors, and generate strategic action plans — all in natural language.

The server provides 32 specialized tools organized into categories:

Category	What you can do
Core Metrics	Brand visibility, citation rates, share of voice, weekly trends
Webpage Analysis	Audit any URL for AI search readiness, optimize Schema.org markup
Competitive Analysis	See who is winning AI citations, find competitive gaps
Content Strategy	Find content opportunities, keyword research, topic analysis
Strategic Actions	Get AI-generated action plans and next-step recommendations
Account Management	Create brands, add tracking prompts, manage labels

What you need before starting

A Superlines account on a paid plan (Starter, Growth, or Enterprise). Sign up at superlines.io.
An API key from your Superlines dashboard. The key starts with sl_live_.
Cursor and/or Claude Desktop installed on your computer.

How to get your Superlines API key

Go to analytics.superlines.io and log in.
Click the Settings icon (gear icon) in the bottom of the left sidebar.
Click Organization Settings.
Go to the API Keys tab.
If you do not have a key yet, click Create API Key. Give it a name like “Cursor MCP” or “Claude Desktop”.
Copy the key. It starts with sl_live_.

Write permissions (optional): By default, your API key is read-only — it can pull analytics data but cannot change anything. If you want your AI assistant to also create brands or add tracking prompts, you need to enable write permissions on the key. In the API Keys settings, click on your key and toggle on write:brands and/or write:prompts. See the setup guide for details.

Option 1: Set up Superlines MCP in Cursor

Open Cursor.
Open the Command Palette: press Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows).
Type “MCP” and select View: Open MCP Settings.
Click + New MCP Server. This opens a file called mcp.json.
Add the Superlines server. If the file is empty, paste this (replace YOUR_API_KEY with your actual key):

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

Save the file (Cmd + S on Mac, Ctrl + S on Windows).
Cursor should automatically detect and start the server. You can verify in the MCP Settings panel — “superlines” should show a green status.

If you already have other MCP servers configured (like Sanity), add the superlines entry inside the existing mcpServers object:

{
  "mcpServers": {
    "Sanity": { "type": "http", "url": "https://mcp.sanity.io" },
    "superlines": {
      "url": "https://mcpsse.superlines.io?token=YOUR_API_KEY",
      "transport": "sse"
    }
  }
}

Option 2: Set up Superlines MCP in Claude Desktop

Download and install Claude Desktop if you have not already. You need a Claude Pro subscription ($20/month) for MCP support.
Open Claude Desktop.
Go to Claude > Settings > Developer (on Mac) or File > Settings > Developer (on Windows).
Click Edit Config. This opens a file called claude_desktop_config.json.
Add the Superlines server (replace YOUR_API_KEY with your actual key):

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

Save the file and restart Claude Desktop completely (quit and reopen — not just close the window).
Start a new conversation. You should see a tools icon (small hammer) near the text input area, confirming MCP servers are loaded.

Test the Superlines connection

After setup, test the connection by asking:

List my Superlines brands

If you see your brand(s) listed, the connection is working. Try a few more:

Show me my brand visibility trends for the last 4 weeks

Find content opportunities where I have low AI visibility

Audit this page for AI search readiness: https://yoursite.com

Troubleshooting Superlines MCP

Problem	Solution
”Authentication failed”	Make sure your API key is correct and starts with `sl_live_`. Check for extra spaces.
”No data returned”	You need at least one brand with tracked prompts set up in your Superlines account.
”Tool not found”	Restart Cursor or Claude Desktop after configuration changes.
”Connection timeout”	Check your internet connection. The server is at `mcpsse.superlines.io`.
”Plan not supported”	MCP requires a paid Superlines plan (Starter, Growth, or Enterprise).
Tools load but no brand data	Make sure you include your brand name when asking questions, e.g., “Show metrics for YourBrand”.

For more details, see the full Superlines MCP setup guide and tools reference.

Part B: Set up the Sanity MCP server

The Sanity MCP server lets AI tools like Cursor and Claude Desktop interact with your Sanity content. Once connected, you can ask your AI assistant to query articles, create drafts, update documents, explore your schema, and more — all through natural language.

What you need before starting

A Sanity account — Sign up for free at sanity.io if you do not have one.
A Sanity project — You need at least one project with content. You can check your projects at sanity.io/manage.
Cursor and/or Claude Desktop installed on your computer.

Option 1: Set up Sanity MCP in Cursor

There are two ways to do this. The automatic method is recommended.

Automatic method (recommended)

Open your terminal (on Mac: search for “Terminal” in Spotlight, or press Cmd + Space and type Terminal).
Type the following command and press Enter:

npx sanity@latest mcp configure

The tool will detect Cursor on your computer and ask you to confirm. Press Enter or type y to continue.
It will use your existing Sanity login to set everything up automatically. If you are not logged in, it will ask you to log in first.
Open Cursor. To verify it worked, open the Command Palette by pressing Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows), then type “MCP” and select View: Open MCP Settings. You should see “Sanity” listed as a server.

That is it. Cursor can now talk to your Sanity project.

Manual method

If the automatic method does not work, you can configure it by hand:

Open Cursor.
Open the Command Palette: press Cmd + Shift + P (Mac) or Ctrl + Shift + P (Windows).
Type “MCP” and select View: Open MCP Settings.
Click + New MCP Server. This opens a file called mcp.json.
Replace the contents of that file with:

{
  "mcpServers": {
    "Sanity": {
      "type": "http",
      "url": "https://mcp.sanity.io"
    }
  }
}

Save the file (Cmd + S on Mac, Ctrl + S on Windows).
Cursor will detect the new server and open a browser window asking you to log in to Sanity. Log in with your Sanity account and click Authorize.
Go back to Cursor. The Sanity MCP server should now show as connected in the MCP Settings panel.

If you already have other MCP servers configured, do not replace the whole file. Instead, add the Sanity entry inside the existing mcpServers object:
{
  "mcpServers": {
    "your-existing-server": { ... },
    "Sanity": {
      "type": "http",
      "url": "https://mcp.sanity.io"
    }
  }
}

Option 2: Set up Sanity MCP in Claude Desktop

Download and install Claude Desktop if you have not already (MCP is not available in the web version of Claude).
Open your terminal and run:

npx sanity@latest mcp configure

When it asks which editor to configure, select Claude Desktop (or Claude Code if that is what you are using).
It will update your Claude Desktop configuration automatically.
Quit Claude Desktop completely (not just close the window — right-click the dock icon and choose Quit, or use Cmd + Q on Mac).
Reopen Claude Desktop. Start a new conversation and look for the tools icon (a small hammer icon) near the text input area. This confirms MCP servers are loaded.

Manual method for Claude Desktop

If the CLI method does not work, you can edit the config file directly:

Open Claude Desktop.
Go to Claude > Settings > Developer (on Mac) or File > Settings > Developer (on Windows).
Click Edit Config. This opens a file called claude_desktop_config.json.
Add the Sanity server to the mcpServers section:

{
  "mcpServers": {
    "Sanity": {
      "url": "https://mcp.sanity.io",
      "transport": "http"
    }
  }
}

Save the file and restart Claude Desktop completely (quit and reopen).
In a new conversation, Claude will prompt you to authenticate with Sanity via your browser the first time you use a Sanity tool.

Test the connection

After setting up either Cursor or Claude Desktop, test the connection by asking:

List all my Sanity projects

or:

Show me the schema for my Sanity project

If you see a list of your projects or schema types, the connection is working.

Troubleshooting Sanity MCP for Claude Desktop

Problem: Sanity MCP does not appear in Claude Desktop settings after setup

Quit Claude Desktop completely and reopen it. MCP servers only load on startup. Use Cmd + Q on Mac (not just closing the window), wait a few seconds, then reopen Claude Desktop. Start a new conversation — you should see a tools icon (small hammer) near the text input area confirming MCP servers are loaded.

Problem: Authentication errors (“Unauthorized” or “401”)

Your Sanity login token has expired. Run the configuration command again to refresh it:

npx sanity@latest mcp configure

When prompted, select Claude Desktop. This will generate a fresh auth token and update your configuration automatically.

Problem: Tools do not appear or “Tool not found” errors

Quit Claude Desktop completely (Cmd + Q on Mac).
Reopen it and start a new conversation.
If tools still do not appear, check that your Sanity account has correct permissions for the project and dataset you are accessing.
Verify the tools icon (hammer) appears near the text input — this confirms MCP servers loaded.

Problem: HTTP setup does not work (manual configuration)

If you manually configured Sanity MCP using the HTTP method and it is not connecting, try the alternative mcp-remote proxy approach in your claude_desktop_config.json:

{
  "mcpServers": {
    "Sanity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.sanity.io",
        "--transport",
        "http-only"
      ]
    }
  }
}

Save the file and restart Claude Desktop completely.

Problem: Debugging connection issues

Check Claude Desktop’s MCP logs for detailed error messages:

tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

This will show you real-time logs of what is happening when Claude Desktop tries to connect to Sanity. Look for error messages that indicate authentication failures, network timeouts, or configuration issues.

Troubleshooting Sanity MCP for Cursor

Problem	Solution
No tools appear	Open Command Palette > View: Open MCP Settings and check that Sanity shows a green status. If it shows red, click the restart button next to it.
OAuth login window does not appear	Clear MCP tokens in Cursor by running Cursor: Clear All MCP Tokens from the Command Palette, then restart.
”Unauthorized” or “401” error	Your login has expired. Run `npx sanity@latest mcp configure` again to refresh it.
”Tool not found” errors	Verify that your Sanity account has the correct permissions for the project you are accessing.

Part C: Set up the AEO Agent in Cursor

The Superlines AEO Agent is an AI-powered content pipeline that automatically analyzes your AI search visibility, audits your content, fact-checks claims, and creates optimized article drafts in your Sanity CMS. It runs a 7-phase daily pipeline using data from Superlines, Bright Data, and Sanity.

What you need before starting

You will need accounts and API keys from several services. Here is where to get each one:

Service	What it is for	Where to sign up	What you need
Superlines	AI search analytics (brand visibility, citations, competitors)	superlines.io	API key (starts with `sl_live_`)
Anthropic	The AI brain that powers the agent (Claude)	console.anthropic.com	API key (starts with `sk-ant-`)
OpenAI	Used for text embeddings (memory/search)	platform.openai.com	API key (starts with `sk-`)
Bright Data	Web scraping for competitor research	brightdata.com	API token
Sanity	Your content management system	sanity.io/manage	Project ID, dataset name, write token
Node.js (v22.13+)	Runs the agent on your computer	nodejs.org	Install the LTS version

Cost note: Running the agent daily costs roughly $0.50–$2 per run with Claude Sonnet, or $1–$4 with Claude Opus. Superlines, Bright Data (free tier), and Sanity (free tier) are included or free.

Step 1: Install Node.js

The agent requires Node.js version 22.13 or higher. If you are not sure whether you have it:

Open your terminal.
Type node --version and press Enter.
If you see a version number like v22.13.0 or higher, you are good. Skip to Step 2.
If you see an error or a lower version number, go to nodejs.org, download the LTS version, and install it. Then close and reopen your terminal.

Step 2: Download the agent

Open your terminal.
Navigate to the folder where you want to put the project. For example, to put it on your Desktop:

cd ~/Desktop

Download the agent:

git clone https://github.com/Superlines/aeo-agent.git

Go into the project folder:

cd aeo-agent

Install the dependencies:

npm install

This will download everything the agent needs. It may take a minute or two.

Step 3: Open the project in Cursor

Open Cursor.
Go to File > Open Folder (or Cmd + O on Mac).
Navigate to the aeo-agent folder you just downloaded and click Open.

You should see the project files in Cursor’s sidebar.

Step 4: Set up your API keys

The agent needs your API keys to connect to all the services. These are stored in a file called .env that stays on your computer and is never shared.

In Cursor’s sidebar, find the file called .env.example.
Right-click it and select Duplicate (or copy it). Rename the copy to .env (just .env, with no other name before the dot).

Alternatively, you can do this in the terminal:

cp .env.example .env

Open the .env file in Cursor. You will see a list of settings that look like this:

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
SUPERLINES_API_KEY=sl_live_...

Replace each placeholder value with your real API key. Here is where to find each one:

Anthropic API key

Go to console.anthropic.com.
Click API Keys in the sidebar.
Click Create Key, give it a name, and copy the key.
Paste it after ANTHROPIC_API_KEY=.

OpenAI API key

Go to platform.openai.com/api-keys.
Click Create new secret key, give it a name, and copy the key.
Paste it after OPENAI_API_KEY=.

Superlines API key

Go to your Superlines dashboard.
Click the Settings icon (gear icon) in the sidebar.
Go to API Keys.
Copy your API key (it starts with sl_live_).
Paste it after SUPERLINES_API_KEY=.

Bright Data API token

Go to brightdata.com and log in.
Go to your account settings and find your API token.
Paste it after BRIGHTDATA_API_TOKEN=.

Sanity credentials

Go to sanity.io/manage.
Click on your project.
Project ID: Shown at the top of the project page. Paste it after SANITY_PROJECT_ID=.
Dataset: Usually production. Paste it after SANITY_DATASET=.
Write token: Go to Settings > API > Tokens. Click Add API Token. Give it a name like “AEO Agent”, set permissions to Editor, and click Save. Copy the token and paste it after SANITY_WRITE_TOKEN=.

Pipeline configuration

At the bottom of the .env file, set these values:

SUPERLINES_BRAND_NAME= — Your brand name exactly as it appears in Superlines (e.g., Superlines).
SUPERLINES_DOMAIN_ID= — Your domain ID from Superlines. You can find this by asking in Cursor with the Superlines MCP: “List my Superlines brands and show me the domain IDs.”
SITE_DOMAIN= — Your website domain without https:// (e.g., superlines.io).

Optional settings

These are not required but useful:

VERCEL_DEPLOY_HOOK= — If your site is on Vercel, you can add a deploy hook URL so the agent triggers a rebuild after updating content. Find this in Vercel > Project Settings > Git > Deploy Hooks.
SLACK_WEBHOOK_URL= — If you want daily reports sent to Slack. Create a webhook at api.slack.com/messaging/webhooks.

Save the file (Cmd + S on Mac, Ctrl + S on Windows).

Important: The .env file contains sensitive API keys. Never share it, commit it to git, or post it online.

Step 5: Run the agent

Open the terminal in Cursor (press Ctrl + ` or go to Terminal > New Terminal).
Make sure you are in the aeo-agent folder. The terminal prompt should show something like ~/Desktop/aeo-agent.
Run the agent:

npm start

The agent will now run its 7-phase pipeline. This takes 5 to 15 minutes depending on how many articles you have.
You will see progress messages in the terminal as each phase completes. When it finishes, it creates a report in the data/reports/ folder.

What happens when the agent runs

The agent goes through 7 phases in order:

Phase	What it does
1. Intelligence Gathering	Reads your AI search data from Superlines — brand visibility, citations, competitive gaps
2. Competitive Deep Dive	Finds competitor URLs winning AI citations and scrapes their content for analysis
3. Content Health Audit	Scans your Sanity articles and flags outdated content
4. Fact Check	Extracts pricing, statistics, and feature claims from your articles and verifies them online
5. Industry Insights	Searches for trending topics, Reddit discussions, and industry reports
6. Data Storytelling	Finds interesting patterns in your analytics data for embedding in articles
7. Content Actions	Creates new article drafts, updates existing articles, and fixes incorrect facts in Sanity

All new articles are created as drafts in Sanity. The agent never publishes anything automatically — you always review and publish manually.

Troubleshooting the AEO Agent

Problem	Solution
`command not found: npm`	Node.js is not installed. Download it from nodejs.org and install the LTS version.
`command not found: git`	Git is not installed. On Mac, open Terminal and type `xcode-select --install`. On Windows, download from git-scm.com.
Error about Node.js version	You need version 22.13 or higher. Run `node --version` to check. Update at nodejs.org.
`Missing environment variable` error	Open your `.env` file and make sure all required keys are filled in. The error message will tell you which one is missing.
`Invalid API key` error	Double-check that you copied the full key with no extra spaces. Anthropic keys start with `sk-ant-`, Superlines keys start with `sl_live_`.
`SANITY_WRITE_TOKEN` error	Your token may not have write permissions. Go to Sanity > Settings > API > Tokens and create a new one with Editor role.
Agent seems stuck	Some phases take a few minutes. Wait at least 15 minutes before assuming something is wrong. If nothing happens for 5+ minutes, press `Ctrl + C` to stop and re-run `npm start`.
`npm install` fails	Try deleting the `node_modules` folder and running `npm install` again. If that does not work, check your Node.js version.

Summary

After completing this guide, you should have:

Superlines MCP connected to Cursor and/or Claude Desktop — Ask your AI assistant about your AI search visibility, content opportunities, competitive gaps, and more.
Sanity MCP connected to Cursor and/or Claude Desktop — Ask your AI assistant to query, create, or update your Sanity content using natural language.
The AEO Agent running locally — A daily pipeline that monitors your AI search visibility, audits your content, and creates optimized drafts in Sanity.

Setup Guide: Superlines MCP, Sanity MCP, and AEO Agent for Non-Technical Users

Part A: Set up the Superlines MCP server

What you need before starting

How to get your Superlines API key

Option 1: Set up Superlines MCP in Cursor

Option 2: Set up Superlines MCP in Claude Desktop

Test the Superlines connection

Troubleshooting Superlines MCP

Part B: Set up the Sanity MCP server

What you need before starting

Option 1: Set up Sanity MCP in Cursor

Automatic method (recommended)

Manual method

Option 2: Set up Sanity MCP in Claude Desktop

Manual method for Claude Desktop

Test the connection

Troubleshooting Sanity MCP for Claude Desktop

Troubleshooting Sanity MCP for Cursor

Part C: Set up the AEO Agent in Cursor

What you need before starting

Step 1: Install Node.js

Step 2: Download the agent

Step 3: Open the project in Cursor

Step 4: Set up your API keys

Anthropic API key

OpenAI API key

Superlines API key

Bright Data API token

Sanity credentials

Pipeline configuration

Optional settings

Step 5: Run the agent

What happens when the agent runs

Troubleshooting the AEO Agent

Summary

What to read next

Tags