# CompetLab MCP Server

Competitive intelligence platform with 24 tools. Monitor competitor pricing, content, positioning, tech stacks, and AI visibility — track how ChatGPT, Claude, and Gemini rank your brand.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add competlab/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list competlab/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get competlab/mcp-server list_projects

# Call a tool
npx -y @smithery/cli@latest tool call competlab/mcp-server list_projects '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--competlab.run.tools`

**Required config:**
- `CL-API-Key` (header) — CompetLab API key (starts with cl_live_)

## Tools (24)

- `list_projects` — List all projects in your organization with status, competitor count, and last monitored timestamp. This is the startin…
- `get_project` — Get project details including per-dimension monitoring freshness (techTrust, content, positioning, pricing, aiVisibilit…
- `list_competitors` — List all competitors being monitored for a project. Includes the user's own domain (marked isOwn: true) for self-analys…
- `get_competitor` — Get competitor details including monitored pages (homepage URL, pricing page URL). Use competitorId values from list_co…
- `get_tech_trust_dashboard` — Get the latest Tech & Trust Profile for all competitors. Returns security headers (grade A-F, HSTS, CSP, X-Frame-Option…
- `get_tech_trust_history` — Get paginated history of Tech & Trust monitoring runs. Returns run summaries with completion timestamps. Check paginati…
- `get_tech_trust_run_detail` — Get full competitor-by-competitor data for a specific historical Tech & Trust run. Use runId values from get_tech_trust…
- `get_content_dashboard` — Get the latest Content Intelligence for all competitors. Returns sitemap URL counts, strategic URL identification, cont…
- `get_content_history` — Get paginated history of Content Intelligence monitoring runs. Check pagination.hasMore to fetch additional pages.
- `get_content_run_detail` — Get full competitor-by-competitor data for a specific historical Content Intelligence run. Use runId values from get_co…
- `get_content_changelog` — Get detected content changes over time — new URLs, removed URLs, moved URLs. Filter by competitor and/or content catego…
- `get_positioning_dashboard` — Get the latest Positioning analysis for all competitors. Returns homepage messaging: page title, main headline, tagline…
- `get_positioning_history` — Get paginated history of Positioning monitoring runs. Check pagination.hasMore to fetch additional pages.
- `get_positioning_run_detail` — Get full competitor-by-competitor data for a specific historical Positioning run. Use runId values from get_positioning…
- `get_pricing_dashboard` — Get the latest Pricing Intelligence for all competitors. Returns structured pricing plans (name, price, billing interva…
- `get_pricing_history` — Get paginated history of Pricing Intelligence monitoring runs. Check pagination.hasMore to fetch additional pages.
- `get_pricing_run_detail` — Get full competitor-by-competitor data for a specific historical Pricing Intelligence run. Use runId values from get_pr…
- `get_ai_visibility_dashboard` — Get the latest AI Visibility scores for all competitors. This is CompetLab's unique dimension — no other CI platform tr…
- `get_ai_visibility_history` — Get paginated history of AI Visibility checks. Note: uses checkId not runId — AI Visibility has a different data model …
- `get_ai_visibility_check_detail` — Get full detail for a specific AI Visibility check including per-competitor rankings, mention rates, AI Visibility Scor…
- `get_ai_visibility_trend` — Get AI Visibility trend data over time — track how LLM brand perception changes. Returns up to 200 data points. Without…
- `get_action_plan` — Get the AI-generated competitive action plan aggregated across all 5 monitoring dimensions. Returns insights (with evid…
- `list_alerts` — Get paginated competitive alerts — detected changes across all monitored dimensions. Filter by dimension (tech-trust, c…
- `list_schedules` — Get monitoring schedules for all 5 dimensions. Returns enabled/disabled status, interval in days, next run timestamp, a…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get competlab/mcp-server <tool-name>
```