trakkr-mcp 0.2.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	AI Pages analysis: positioning, strengths, weaknesses, opportunities. Paid plan required.
get_narratives	Narrative intelligence: tracked topics and storylines. Scale plan required.

Crawler

Tool	Description
get_crawler_overview	Overview tab: hero stats, chart, setup state, top pages, and recent preview.
get_crawler_live	Live tab: activity, pages, or sessions with dashboard filters.
get_crawler_pages	Pages tab: pages, paths, or normalized bots.
get_crawler_page_details	Page drawer data: verdict, pipeline, health, traffic, diagnostics.
get_crawler_path_details	Path drawer data: verdict, pipeline, top pages, top bots, diagnostics.
get_crawler_bot_details	Bot drawer data: verdict, pipeline, top pages, top paths, diagnostics.
get_crawler_access	Access tab: findings, bot matrix, robots.txt, llms.txt, submit-to-search.
preview_crawler_access_fix	Preview an Access fix without applying it.
send_crawler_verification_ping	Send the verification ping shown in the dashboard.
submit_crawler_to_search	Submit crawler pages to AI search via IndexNow.
get_crawler_submit_status	Read submit-to-search status and summary.
get_crawler_analytics	Deprecated compatibility alias for the new crawler tools.

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?"
• "Show crawler overview for Nike"
• "What changed in Live this week?"
• "Preview crawler access fixes"
• "Send a verification ping"

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