@citesurf/mcp

MCP server for Citesurf. AI visibility monitoring.

Check if ChatGPT, Claude, Perplexity, and Gemini recommend any brand. Get visibility scores, sentiment, competitor data, and actionable insights, all from your AI agent.

Install

npx -y @citesurf/mcp

Requirements

• A Citesurf account with an active Plus or Max subscription
• An API key (create one in Dashboard > Settings)
• Prepaid credits for scan operations

Setup

Add to your MCP client config:

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "citesurf": {
      "command": "npx",
      "args": ["-y", "@citesurf/mcp"],
      "env": {
        "CITESURF_API_KEY": "cs_live_..."
      }
    }
  }
}

Cursor

.cursor/mcp.json in your project or global settings

{
  "mcpServers": {
    "citesurf": {
      "command": "npx",
      "args": ["-y", "@citesurf/mcp"],
      "env": {
        "CITESURF_API_KEY": "cs_live_..."
      }
    }
  }
}

Claude Code

claude mcp add citesurf -e CITESURF_API_KEY=cs_live_... -- npx -y @citesurf/mcp

Environment Variables

| Variable | Required | Description | | ------------------- | -------- | -------------------------------------------------- | | CITESURF_API_KEY | Yes | Your API key from Dashboard > Settings | | CITESURF_BASE_URL | No | API base URL (default: https://www.citesurf.com) |

Tools

Brands

| Tool | Description | Credits | | -------------- | ------------------------------------------------------ | ------- | | list_brands | List all monitored brands with latest metrics | 0 | | get_brand | Get detailed brand info: score, platforms, competitors | 0 | | create_brand | Start monitoring a brand across all 4 AI platforms | 0 | | update_brand | Update brand type, category, description, or prompts | 0 | | delete_brand | Stop monitoring and archive a brand | 0 |

Data

| Tool | Description | Credits | | ---------------- | ---------------------------------------------- | ------- | | list_scans | Paginated scan list for a brand | 0 | | get_scan | Full scan detail with probes and citations | 0 | | get_trends | Historical scan trends (7, 30, or 90 days) | 0 | | get_prompts | AI platform probe results grouped by prompt | 0 | | get_personas | Probe results grouped by persona | 0 | | get_insights | AI generated recommendations for visibility | 0 | | update_insight | Dismiss or complete an insight | 0 | | get_site_audit | Technical audit (robots.txt, llms.txt, schema) | 0 | | get_report | Comprehensive report with all data in one call | 0 | | get_account | Plan, credit balance, brand count | 0 |

Scans

| Tool | Description | Credits | | -------------- | ----------------------------------- | ------- | | trigger_scan | Trigger new scan for existing brand | 1 |

Each scan costs 1 credit and runs across all 4 platforms (ChatGPT, Claude, Gemini, Perplexity). Reading data never costs credits. Purchase credit packs in the Citesurf dashboard.

Example Usage

> List my monitored brands
> What are the top insights for brand xyz?
> How has my visibility score changed over the last 30 days?
> Show me the latest scan detail for my brand
> What do different personas see when asking about my brand?
> Run a comprehensive report on my brand
> Update my brand's description and monitoring prompts

License

MIT