Skip to main content
Glama
Citesurf MCP

Citesurf MCP

by citesurf

@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

Related MCP server: mcp-server-peecai

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

Available Tools

16 tools
create_brandB

Start monitoring a brand for AI visibility across ChatGPT, Claude, Gemini, Perplexity

Inputs: name (required), website (required), language.

delete_brandA
Destructive

Stop monitoring a brand and archive its data

Inputs: brandId (required).

get_accountB
Read-only

Get account info: plan, payment status, credit balance, brand count and limit

Inputs: no named parameters.

get_brandB
Read-only

Get detailed brand info: visibility score, platform breakdown, competitors, sentiment

Inputs: brandId (required).

get_insightsB
Read-only

Get AI generated recommendations for improving brand visibility, prioritized by impact

Inputs: brandId (required), status, offset, pageSize.

get_personasA
Read-only

Get AI platform probe results grouped by persona (how different user types discover the brand)

Inputs: brandId (required), offset, pageSize.

get_promptsA
Read-only

Get AI platform probe results grouped by prompt (what each AI said about the brand)

Inputs: brandId (required), platform, offset, pageSize.

get_reportB
Read-only

Get comprehensive AI visibility report: scores, platform performance, prompts, sentiment, competitors, cited domains, trends, site audit, and insights in one call

Inputs: brandId (required).

get_scanA
Read-only

Get full scan detail with probes, results per platform, citations, and site audit

Inputs: brandId (required), scanId (required).

get_site_auditB
Read-only

Get technical audit results: robots.txt AI crawler access, llms.txt, schema.org, sitemap, Open Graph

Inputs: brandId (required).

list_brandsA
Read-only

List all monitored brands with latest AI visibility metrics

Inputs: no named parameters.

list_scansA
Read-only

List scans for a brand with pagination (visibility score, mention rate, platform scores per scan)

Inputs: brandId (required), offset, pageSize.

trigger_scanA

Trigger a new scan for an existing monitored brand (costs 1 credit, covers all 4 AI platforms). Returns credits used and remaining balance.

Inputs: brandId (required).

update_brandA
Idempotent

Update brand metadata: type, category, description, or monitoring prompts. All fields optional, only pass what you want to change.

Inputs: brandId (required), type, category, description, +1 more.

update_insightA
Destructive

Dismiss or complete an insight. Dismiss deletes it, complete validates improvement with before and after metrics.

Inputs: brandId (required), insightId (required), action (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct purposes with clear boundaries, such as create_brand vs. delete_brand or get_brand vs. get_insights. However, some overlap exists between get_report, get_scan, and get_trends, as they all provide detailed analytics that could be confused without careful reading of descriptions.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as create_brand, get_account, list_brands, and update_brand. There are no deviations in naming conventions, making the set predictable and easy to navigate.

    Tool Count4/5

    With 16 tools, the count is slightly high but reasonable for the domain of brand monitoring and AI visibility analysis. It covers core operations like CRUD for brands, scanning, and reporting, though it may feel a bit heavy compared to a more streamlined set.

    Completeness5/5

    The tool set provides comprehensive coverage for brand monitoring, including full CRUD for brands (create, get, update, delete, list), scanning and reporting capabilities, account management, and insights handling. No obvious gaps are present, supporting complete workflows from setup to analysis.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Track how your brand appears in AI-generated answers across ChatGPT, Perplexity, and other AI models. Analyze visibility, sentiment, citations, and domain rankings with 31 tools — including analytics reports, chat inspection, query analysis, and full CRUD for brands, prompts, tags, and topics.
      17
      105 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to run brand-visibility audits by querying multiple AI engines, generating competitive leaderboards, and identifying growth opportunities. Integrates with any MCP-capable client to measure and act on brand discoverability in AI recommendations.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to monitor and analyze a brand's visibility across ChatGPT, Claude, Perplexity, and Google AI Overviews, providing insights, recommendations, and competitive analysis without switching tabs.
      25
      197 npm
      1
      MIT