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 metricsget_brandGet detailed brand info: score, platforms, competitorscreate_brandStart monitoring a brand across all 4 AI platformsupdate_brandUpdate brand type, category, description, or promptsdelete_brandStop monitoring and archive a brandlist_scansPaginated scan list for a brandget_scanFull scan detail with probes and citationsget_trendsHistorical scan trends (7, 30, or 90 days)get_promptsAI platform probe results grouped by promptget_personasProbe results grouped by personaget_insightsAI generated recommendations for visibilityupdate_insightDismiss or complete an insightget_site_auditTechnical audit (robots.txt, llms.txt, schema)get_reportComprehensive report with all data in one callget_accountPlan, credit balance, brand counttrigger_scanTrigger new scan for existing brandEnvironment Variables
CITESURF_API_KEYrequiredYour API key from Dashboard > SettingsCITESURF_BASE_URLAPI base URL (default: https://www.citesurf.com)Configuration
{"mcpServers": {"citesurf": {"command": "npx", "args": ["-y", "@citesurf/mcp"], "env": {"CITESURF_API_KEY": "cs_live_..."}}}}