Citesurf MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "CITESURF_API_KEY=${CITESURF_API_KEY}" citesurf -- npx -y @citesurf/mcp
Required:CITESURF_API_KEY+ 1 optional
README.md

AI visibility monitoring across ChatGPT, Claude, Gemini, and Perplexity.

@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

Tools (16)

list_brandsList all monitored brands with latest metrics
get_brandGet detailed brand info: score, platforms, competitors
create_brandStart monitoring a brand across all 4 AI platforms
update_brandUpdate brand type, category, description, or prompts
delete_brandStop monitoring and archive a brand
list_scansPaginated scan list for a brand
get_scanFull scan detail with probes and citations
get_trendsHistorical scan trends (7, 30, or 90 days)
get_promptsAI platform probe results grouped by prompt
get_personasProbe results grouped by persona
get_insightsAI generated recommendations for visibility
update_insightDismiss or complete an insight
get_site_auditTechnical audit (robots.txt, llms.txt, schema)
get_reportComprehensive report with all data in one call
get_accountPlan, credit balance, brand count
trigger_scanTrigger new scan for existing brand

Environment Variables

CITESURF_API_KEYrequiredYour API key from Dashboard > Settings
CITESURF_BASE_URLAPI base URL (default: https://www.citesurf.com)

Configuration

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

Try it

List all the brands I am currently monitoring.
What are the top visibility insights for my brand xyz?
How has my brand's visibility score changed over the last 30 days?
Run a comprehensive report on my brand and show me the latest scan details.
What do different personas see when asking about my brand?

Frequently Asked Questions

What are the key features of Citesurf?

Monitor brand visibility across ChatGPT, Claude, Gemini, and Perplexity. Track historical visibility scores and sentiment trends. Perform technical site audits including robots.txt and llms.txt checks. Generate actionable insights and recommendations for brand visibility. Analyze probe results grouped by specific personas or prompts.

What can I use Citesurf for?

Marketing teams tracking how often their brand is recommended by AI models. SEO specialists auditing how AI crawlers perceive their brand's technical documentation. Brand managers identifying competitor mentions within AI-generated responses. Content strategists optimizing brand descriptions to improve AI visibility.

How do I install Citesurf?

Install Citesurf by running: npx -y @citesurf/mcp

What MCP clients work with Citesurf?

Citesurf works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Citesurf docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare