nudg3-mcp 1.0.0

MCP server for Nudg3 brand visibility intelligence — query your AI search visibility from Claude, Cursor, or any MCP client

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.

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

Tool	Scope	Description
get_overview	read:analytics	Health check: organic + branded visibility, trends, alerts, suggested investigations
analyze_competitors	read:analytics	Organic competitive rankings, position gaps, fastest movers
analyze_prompts	read:analytics	Prompt-level performance by funnel stage; auto-resolves your primary brand
analyze_sources	read:analytics	Top cited domains, type distribution, content gap detection
analyze_responses	read:analytics	Provider-grouped response samples, sentiment patterns
query_metrics	read:analytics	Composable analytics query with measures, dimensions, filters
get_metric_catalog	read:analytics	Discover available measures, filters, and export datasets
export_data	export:data	CSV export for chat responses, sources, dashboard, prompts
get_reports	read:insights	List or fetch visibility audit reports
get_insights	read:insights	AI-generated opportunities, threats, and recommendations from a report
get_actions	read:insights	Workspace action items with priority, effort, and impact

Environment Variables

Variable	Required	Default	Description
NUDG3_API_KEY	Yes	—	Your Nudg3 API key
NUDG3_API_URL	No	https://api.nudg3.ai	API base URL
NUDG3_TIMEOUT	No	30	HTTP timeout in seconds

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