@impactgain/ci-mcp

An MCP server that brings Competitors Intelligence into your AI assistant — pull competitor posts, ads, AI analysis, and weekly digests conversationally in Claude Desktop, Cursor, or Windsurf.

"What has HubSpot been posting this week?" → your assistant calls ci_get_competitor_posts for you.

Prerequisites

• Node.js 18+
• A Competitors Intelligence account
• An API key (ci_live_…) — create one in your dashboard at https://radar.impactgain.agency/dashboard/settings/api

You do not need to clone or build anything. The package is downloaded and run automatically by your AI tool via npx.

Installation

1. Get your API key

Log in at https://radar.impactgain.agency/dashboard/settings/api → Your API Keys → create a key. The full secret is shown only once — copy it immediately. Keys begin with ci_live_.

2. Add the server to your AI tool

Claude Desktop — edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "competitors-intelligence": {
      "command": "npx",
      "args": ["-y", "@impactgain/ci-mcp"],
      "env": {
        "CI_API_KEY": "ci_live_your_key_here",
        "CI_COMPANY_ID": "your-company-uuid-here"
      }
    }
  }
}

Cursor — ~/.cursor/mcp.json (or Settings → MCP → Add):

{
  "mcpServers": {
    "competitors-intelligence": {
      "command": "npx",
      "args": ["-y", "@impactgain/ci-mcp"],
      "env": {
        "CI_API_KEY": "ci_live_your_key_here",
        "CI_COMPANY_ID": "your-company-uuid-here"
      }
    }
  }
}

Windsurf — same block under mcpServers in its MCP config file.

3. Restart your AI tool

On restart it launches the server over stdio and the ci_* tools become available. Try: "List the competitors I'm tracking."

Available tools

| Tool | What it does | Key params | |---|---|---| | ci_list_competitors | List all tracked competitors with their IDs and platforms. Call this first. | — | | ci_get_competitor_posts | Organic posts (LinkedIn, Instagram, blog, …), newest first. | competitor_id, platform?, days? (1–90), limit?, offset? | | ci_get_competitor_ads | Paid ads on LinkedIn / Meta, newest first. | competitor_id, platform?, days? (1–90), limit?, offset? | | ci_get_competitor_analysis | Latest AI analysis: summary, strengths, weaknesses, recommendations, activity trend. | competitor_id | | ci_get_weekly_digest | This week's company-wide competitive briefing. | company_id? (falls back to CI_COMPANY_ID) | | ci_refresh_competitor | Queue a fresh scrape for a competitor (async, ~1–3 min). Max once / 30 min. | competitor_id, limit? |

All read tools are read-only and idempotent. ci_refresh_competitor triggers a background job.

Configuration

The server is configured entirely via environment variables (set in the env block above):

| Variable | Required | Description | |---|---|---| | CI_API_KEY | ✅ | Your API key (ci_live_…). | | CI_COMPANY_ID | ❌ | Default company UUID. When set, ci_get_weekly_digest works without passing company_id. | | CI_API_BASE_URL | ❌ | Override the API base URL. Default: https://radar.impactgain.agency. |

Why set CI_COMPANY_ID?

ci_get_weekly_digest needs your company UUID, and it must match the company your API key belongs to. Setting CI_COMPANY_ID once means you can just ask "What's my weekly digest?" without supplying the ID every time. You can find your company UUID via ci_list_competitors (returned as company_id).

Troubleshooting

| Symptom | Fix | |---|---| | CI_API_KEY environment variable is not set | Add CI_API_KEY to the env block in your MCP config, then restart your AI tool. | | Invalid or missing API key (UNAUTHORIZED) | The key may be revoked or mistyped. Generate a new one in the dashboard and update your config. | | company_id is required | Set CI_COMPANY_ID in your config, or pass company_id to ci_get_weekly_digest. | | Access denied (FORBIDDEN) | The competitor/company doesn't belong to your API key's company. | | Not found (NOT_FOUND) | Run ci_list_competitors to get valid IDs; analysis/digest may not be generated yet. | | This competitor was refreshed recently (REFRESH_COOLDOWN) | Wait 30 minutes between refreshes of the same competitor. | | Rate limit exceeded | You've hit the per-key or per-IP limit. Wait a moment and retry. | | Server doesn't appear in the tool list | Confirm Node.js 18+ is installed and on PATH; fully quit and reopen your AI tool. |

How it works

The server runs locally on your machine (spawned by your AI tool over stdio) and calls the Competitors Intelligence REST API over HTTPS using your API key. No data passes through any third party — it's your tool talking directly to the Competitors Intelligence API.

AI tool  ──stdio──▶  @impactgain/ci-mcp  ──HTTPS (Bearer ci_live_…)──▶  radar.impactgain.agency/api/v1

License

MIT