trakkr-mcp 0.1.0

MCP server for Trakkr — AI visibility monitoring for ChatGPT, Perplexity, Gemini, and more

trakkr-mcp

MCP server for Trakkr — AI visibility monitoring.

Connect your AI assistant (Claude, Cursor, Windsurf) to Trakkr and query your brand's AI search visibility data conversationally.

Quick Start

# Install
pip install trakkr-mcp

# Or run directly with uvx (no install needed)
uvx trakkr-mcp

Set your API key:

export TRAKKR_API_KEY="sk_live_your_key_here"

Get your API key at trakkr.ai/exports/api-keys.

Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "trakkr": {
      "command": "uvx",
      "args": ["trakkr-mcp"],
      "env": {
        "TRAKKR_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "trakkr": {
      "command": "uvx",
      "args": ["trakkr-mcp"],
      "env": {
        "TRAKKR_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "trakkr": {
      "command": "uvx",
      "args": ["trakkr-mcp"],
      "env": {
        "TRAKKR_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Available Tools

Core Data

Tool	Description
list_brands	List all brands you're tracking. Returns brand IDs needed for other tools.
get_visibility_scores	Get AI visibility scores and trends over time.
list_prompts	List tracked search queries for a brand.
manage_prompt	Create, update, or delete a tracked prompt.

Visibility

Tool	Description
get_citations	Citation URLs and trends. Views: list, history, queries, sources, feed, heatmap.
get_rankings	Competitive rankings in AI search results.
get_model_breakdown	Visibility by AI model (ChatGPT, Perplexity, Gemini, etc.).
get_competitors	Competitor analysis. Views: summary, arena, head-to-head, by-model, threats.

Intelligence

Tool	Description
get_opportunities	Citation gaps where competitors appear but you don't.
get_content_ideas	AI-generated content ideas to improve visibility.
get_perception	How AI models describe and position the brand. Paid plan required.
get_prism	PRISM analysis: positioning, strengths, weaknesses, opportunities. Paid plan required.
get_crawler_analytics	Which AI bots are crawling your website. Paid plan required.
get_narratives	Narrative intelligence: tracked topics and storylines. Scale plan required.

Actions

Tool	Description
run_diagnosis	Diagnose a search query across AI models in real-time.
get_diagnosis_result	Get diagnosis results, history, or usage quota.
generate_report	Generate an AI visibility report (executive, weekly, or full).
get_reports	List or retrieve generated reports.
export_data	Export data as JSON or CSV.

Example Conversations

Once connected, you can ask your AI assistant things like:

• "How is my brand doing in AI search this month?"
• "Which competitors are gaining ground in ChatGPT?"
• "What content opportunities am I missing?"
• "Show me which pages get cited most by Perplexity"
• "Run a diagnosis on 'best project management tools'"
• "What does my visibility trend look like over the last 90 days?"

Requirements

• Python 3.10+
• A Trakkr account with an API key (get one here)

Documentation

Full API documentation: trakkr.ai/learn/api

MCP setup guide: trakkr.ai/learn/api/mcp

License

MIT