Metadata-Version: 2.4
Name: trakkr-mcp
Version: 0.1.0
Summary: MCP server for Trakkr — AI visibility monitoring for ChatGPT, Perplexity, Gemini, and more
Project-URL: Homepage, https://trakkr.ai
Project-URL: Documentation, https://trakkr.ai/learn/api/mcp
Project-URL: Repository, https://github.com/macklpgr/trakkr-mcp
Author-email: Trakkr <hello@trakkr.ai>
License-Expression: MIT
Keywords: ai-search,ai-visibility,brand-monitoring,mcp,trakkr
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp[cli]>=1.0
Description-Content-Type: text/markdown

# trakkr-mcp

MCP server for [Trakkr](https://trakkr.ai) — AI visibility monitoring.

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

## Quick Start

```bash
# Install
pip install trakkr-mcp

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

Set your API key:

```bash
export TRAKKR_API_KEY="sk_live_your_key_here"
```

Get your API key at [trakkr.ai/exports/api-keys](https://trakkr.ai/exports/api-keys).

## Configuration

### Claude Desktop

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

```json
{
  "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):

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

### Windsurf

Add to your Windsurf MCP config:

```json
{
  "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](https://trakkr.ai/exports/api-keys))

## Documentation

Full API documentation: [trakkr.ai/learn/api](https://trakkr.ai/learn/api)

MCP setup guide: [trakkr.ai/learn/api/mcp](https://trakkr.ai/learn/api/mcp)

## License

MIT
