Docs

API & MCP Documentation

Integrate VisibilityRadar into your workflow — via MCP (Claude Desktop, Cursor, Windsurf) or directly via REST API.

Overview

VisibilityRadar exposes two integration surfaces:

🔌 MCP Server

Use VisibilityRadar directly inside Claude Desktop, Cursor, or Windsurf. No browser needed — just ask your AI assistant.

MCP setup →

🌐 REST API

Trigger analyses, retrieve history, and build dashboards programmatically using standard HTTP requests.

API reference →

Plan requirement: MCP and API access require a Pro or Agency plan. Daily limits: Pro = 5/day, Agency = 20/day.

Quick Start

1
Get your API key
Go to Account Settings → MCP API Keys and click Generate Key. Copy it — it's shown only once.
2
Choose your integration
Use the MCP server for AI assistant integration, or call the REST API directly from your app.

Run your first analysis

curl -X POST https://visibilityradar.ai/api/mcp/analyze \
  -H "Content-Type: application/json" \
  -H "x-api-key: vr_your_key_here" \
  -d '{"brand": "Nike", "market": "global", "competitors": ["Adidas"]}'

Authentication

All API requests require an API key passed in the x-api-key header.

x-api-key: vr_your_api_key_here

API keys start with vr_ followed by 48 hex characters.

Keys are shown only once at creation. If lost, revoke and generate a new one.

You can create up to 3 API keys per account.

MCP Server

Use VisibilityRadar directly from Claude Desktop, Cursor, or Windsurf.

Installation

npx visibilityradar-mcp

Claude Desktop Config

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "visibilityradar": {
      "command": "npx",
      "args": ["visibilityradar-mcp"],
      "env": {
        "VR_API_KEY": "vr_your_api_key_here"
      }
    }
  }
}

Cursor Config

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "visibilityradar": {
      "command": "npx",
      "args": ["visibilityradar-mcp"],
      "env": {
        "VR_API_KEY": "vr_your_api_key_here"
      }
    }
  }
}

Available Tools

analyze_brand

Run a full AI visibility analysis for a brand.

// Parameters
{
  brand: string,        // required — e.g. "Nike"
  market?: string,      // optional — e.g. "US", "global"
  competitors?: string[] // optional — max 3
}

get_brand_history

Fetch past analysis results and score trends.

// Parameters
{
  brand: string  // required — brand name to look up
}

Example Usage

# In Claude Desktop or Cursor, just ask:

"Analyze Nike's AI visibility in the US market vs Adidas"

# Or check history:

"Show me the AI visibility history for Notion"

API Endpoints

POST/api/mcp/analyze

Run a full AI visibility analysis. Results are saved to your dashboard automatically.

Request

curl -X POST https://visibilityradar.ai/api/mcp/analyze \
  -H "Content-Type: application/json" \
  -H "x-api-key: vr_your_key_here" \
  -d '{
    "brand": "Nike",
    "market": "US",
    "competitors": ["Adidas", "Puma"]
  }'

Request Body

Field	Type	Required	Description
brand	string	Yes	Brand name to analyze
market	string	No	Target market — e.g. US, global, TR. Defaults to global
competitors	string[]	No	Competitor brand names. Max 3 (Pro), max 5 (Agency)

Response

{
  "brand": "Nike",
  "market": "US",
  "overall_score": 78,
  "label": "Strong",
  "model_scores": [
    { "model": "Claude", "score": 82 },
    { "model": "GPT-4o", "score": 79 },
    { "model": "Gemini", "score": 74 },
    { "model": "Perplexity", "score": 80 },
    { "model": "Grok", "score": 76 },
    { "model": "DeepSeek", "score": 71 }
  ],
  "sentiment": {
    "positive": 72,
    "neutral": 21,
    "negative": 7
  },
  "competitors": [
    { "brand": "Adidas", "score": 61 },
    { "brand": "Puma", "score": 44 }
  ],
  "top_recommendations": [
    { "action": "Build a stronger Wikipedia presence", "priority": "HIGH" },
    { "action": "Earn coverage on Perplexity-indexed publications", "priority": "HIGH" }
  ],
  "dashboard_url": "https://visibilityradar.ai/dashboard"
}

GET/api/mcp/history

Retrieve the last 20 analyses. Filter by brand using the query parameter.

Request

curl https://visibilityradar.ai/api/mcp/history?brand=Nike \
  -H "x-api-key: vr_your_key_here"

Query Parameters

Parameter	Required	Description
brand	No	Filter results by brand name

Response

{
  "analyses": [
    {
      "overall_score": 78,
      "market": "US",
      "created_at": "2026-06-29T10:00:00Z"
    }
  ]
}

Errors & Rate Limits

Rate Limits

Plan	Daily MCP limit	Monthly limit
Pro	5 / day	10 / month
Agency	20 / day	Unlimited

Error Codes

401

Unauthorized

Missing or invalid API key.

403

Forbidden

API access requires Pro or Agency plan.

429

Rate Limited

Daily or monthly analysis limit reached. Upgrade or wait until reset.

500

Server Error

Analysis failed. Try again in a few seconds.

Ready to integrate?

Get your API key from Account Settings and start in minutes.

Get API Key →FAQ