nudg3-mcp

MCP server for Nudg3 brand visibility intelligence. Query your brand's AI search visibility from Claude Desktop, Cursor, Windsurf, or any MCP client.

Quickstart

1. Get an API key

Create one at app.nudg3.ai/api-keys.

Two key types (since 1.1.0):

• Workspace-scoped key — bound to one workspace. The default for single-brand customers. Every tool just works; you don't pass workspace_id.
• Agency / company-scoped key — bound to an agency or a company that owns multiple workspaces. Use list_workspaces first, then pass workspace_id to other tools. If the key only authorises one workspace the auto-resolver picks it for you; if it authorises many, the error response tells the LLM which UUIDs are available so it can ask you.

2. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "nudg3": {
      "command": "uvx",
      "args": ["nudg3-mcp"],
      "env": {
        "NUDG3_API_KEY": "nudg3_live_ak_..."
      }
    }
  }
}

3. Ask questions

• "What's my brand visibility score this week?"
• "Compare my visibility across ChatGPT and Gemini"
• "Which sources cite my brand most?"
• "Export my dashboard data for the last 30 days"

Tools

Since 1.1.0, every analytics/insights/export tool accepts an optional workspace_id argument. Workspace-scoped key callers can omit it. Agency/company-scoped key callers pass the UUID returned by list_workspaces — when only one workspace is accessible, it's auto-resolved.

Environment Variables

Other MCP Clients

Cursor

{
  "mcpServers": {
    "nudg3": {
      "command": "uvx",
      "args": ["nudg3-mcp"],
      "env": {
        "NUDG3_API_KEY": "nudg3_live_ak_..."
      }
    }
  }
}

Custom / programmatic

pip install nudg3-mcp
NUDG3_API_KEY=nudg3_live_ak_... nudg3-mcp

Development

git clone https://github.com/NUDG3-AI/nudg3-mcp-server.git
cd nudg3-mcp-server
python -m venv venv && source venv/Scripts/activate
pip install -e ".[dev]"
pytest