diploria-mcp

Official Diploria MCP server. Connects Claude Desktop, Cursor, Windsurf, Zed, and any MCP-compatible AI tool to your brand's AI visibility data.

Setup

1. Get your API key

Sign in to diploria.ai → Settings → API Keys & MCP → Create key.

2. Add to your AI tool config

Claude Desktop (Claude > Settings > Developer > Edit Config):

{
  "mcpServers": {
    "diploria": {
      "command": "npx",
      "args": ["-y", "diploria-mcp"],
      "env": {
        "DIPLORIA_API_KEY": "dip_...",
        "DIPLORIA_API_BASE": "https://diploria.ai/api"
      }
    }
  }
}

Cursor (Cursor Settings > MCP > Add new global MCP server):

{
  "mcpServers": {
    "diploria": {
      "command": "npx",
      "args": ["-y", "diploria-mcp"],
      "env": {
        "DIPLORIA_API_KEY": "dip_...",
        "DIPLORIA_API_BASE": "https://diploria.ai/api"
      }
    }
  }
}

Windsurf (Windsurf Settings > Cascade > MCP Servers > View raw config):

{
  "mcpServers": {
    "diploria": {
      "command": "npx",
      "args": ["-y", "diploria-mcp"],
      "env": {
        "DIPLORIA_API_KEY": "dip_...",
        "DIPLORIA_API_BASE": "https://diploria.ai/api"
      }
    }
  }
}

Zed (Zed > Settings > Open Settings (JSON)):

{
  "context_servers": {
    "diploria": {
      "command": "npx",
      "args": ["-y", "diploria-mcp"],
      "env": {
        "DIPLORIA_API_KEY": "dip_...",
        "DIPLORIA_API_BASE": "https://diploria.ai/api"
      }
    }
  }
}

3. Restart your AI tool

Look for the 🔨 tools icon (Claude) or the MCP servers panel to confirm Diploria is connected.

Available tools

| Tool | Description | |------|-------------| | list_brands | List all brands — always call this first to get brandIds | | get_brand_dashboard | Visibility scores, mention rates, and last poll date | | get_poll_history | Recent poll run history | | get_poll_results | Per-engine, per-prompt mention breakdown for a specific run | | get_citations | Top cited domains and URLs in the last 30 days | | get_sentiment | Sentiment trend and recent negative mentions | | get_tag_analytics | Mention rates by intent category and engine | | get_competitor_gaps | Side-by-side brand vs competitor mention rates | | get_competitor_citations | Sources that cite competitors but not your brand | | get_load_bearing_sources | URLs most cited by AI engines | | get_readiness_index | Brand readiness score with category breakdown | | get_readiness_scans | Scanned URLs with readiness pillar scores | | get_readiness_recommendations | Top-priority fixes sorted by potential improvement | | get_optimization_quadrant | Pages mapped by readiness score vs citation rate | | get_accuracy_facts | Ground-truth facts used to detect hallucinations | | get_accuracy_incidents | Detected hallucinations and misstatements | | get_agent_traffic_summary | AI bot crawler traffic metrics |

Example prompts

• "What's my AI visibility score for Acme brand?"
• "Where are my competitors outranking me?"
• "Show me the latest negative sentiment mentions."
• "Which pages have the worst readiness scores?"
• "What hallucinations has Diploria detected this month?"

License

MIT