5-min setup

MCP Setup Guide

Connect your Alignment AI Visibility data to Claude Desktop, Cursor, or Windsurf — query your brand data with natural language.

Once connected, you can ask things like
›"Which AI platforms mentioned my brand recently?"
›"Did my AIGVR score change this week?"
›"Which AI platform is friendliest to my brand?"
›"What’s the trend in my brand’s AI visibility?"
1

Get your API Token

Log in to Alignment, go to Settings → MCP — AI Tools Integration, and create a token.

Token is shown only once — copy it immediately

Format: alg_xxxxxxxxxxxxxxxx...

Go to Settings to create a token

Token naming tips

Claude-Desktop-Mac
Cursor-Work-PC
Windsurf-Laptop
MyBrand-Production
Test-Local

Name by device or purpose so you can identify and revoke later

2

Install the MCP Server

Install the Alignment MCP Server on your computer (requires Python 3.11+):

Terminal
pip install git+https://github.com/Alignment-GEOAI/product-backend.git#subdirectory=mcp-server

After installation, the alignment-mcp command is available. Verify: alignment-mcp --help

Don't have Python?

Visit python.org/downloads to install Python 3.11+, then re-open your terminal and run the pip command again.

3

Configure your AI tool

Edit your AI tool's config file and paste the snippet below.

Mac~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "alignment": {
      "command": "alignment-mcp",
      "env": {
        "ALIGNMENT_API_URL": "https://api.alignmenttech.ai",
        "ALIGNMENT_API_TOKEN": "alg_your_token"
      }
    }
  }
}

Replace alg_your_token with the token from Step 1, then fully quit and restart Claude Desktop

4

Verify the connection

After restarting your AI tool, open a new chat and ask in natural language:

How is my brand performing on AI platforms?

Signs of a successful connection

  • · Claude Desktop: plug icon appears at the bottom-left
  • · Cursor / Windsurf: MCP tool selector appears in chat
  • · AI replies include your actual brand data

Available tools (invoked automatically)

Your AI will choose the right tool based on your question

alignment_my_statsPersonal GEO overview — brand count, total mentions, average AIGVR score
alignment_my_brandsList all your brands with basic info
alignment_brand_statsSingle-brand AIGVR trend over the last 30 days
alignment_brand_mentionsRecent AI mention records — platform, sentiment, citation URL

FAQ

Don't have an account?

Sign up for Alignment and start tracking your brand's AI visibility.

Get started free