{
  "markdown": "# collimer-mcp\n\n[![npm](https://img.shields.io/npm/v/collimer-mcp)](https://www.npmjs.com/package/collimer-mcp) · MIT · [Model Context Protocol](https://modelcontextprotocol.io)\n\n**Let any AI agent run a free AI-search visibility scan on any website** — how visible a brand is in ChatGPT, Claude, Gemini, Perplexity, and Google AI Overviews.\n\nTrackers tell you you're invisible. Collimer tells you *why*, and what to fix.\n\nIt exposes one tool, **`collimer_scan`**, which returns a depth-gated teaser: an AI-visibility score (0–100), a confidence interval, the single biggest gap, and a branded report URL. The full ranked fix plan and verification re-scan unlock with a free account at [collimer.com](https://collimer.com).\n\n## Install\n\nAdd Collimer to any MCP client. It runs on-demand via `npx` — no install step.\n\n**Claude Desktop / Claude Code** — add to your MCP config (`claude_desktop_config.json`, or `.mcp.json` in your project):\n\n```json\n{\n  \"mcpServers\": {\n    \"collimer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"collimer-mcp\"]\n    }\n  }\n}\n```\n\n**Cursor / Windsurf / VS Code** — same block, in the editor's MCP settings (`~/.cursor/mcp.json`, Windsurf MCP settings, or `.vscode/mcp.json`).\n\nThen ask your assistant:\n\n> *\"How visible is stripe.com in AI search?\"*\n> *\"Run a Collimer scan on example.com and tell me the biggest AI-visibility gap.\"*\n> *\"Does ChatGPT cite acme.com when asked about its category?\"*\n\nYour assistant will call `collimer_scan` and return the teaser.\n\n## The tool\n\n**`collimer_scan(domain, email?)`**\n\n| Arg | | |\n|---|---|---|\n| `domain` | required | The website to scan — `example.com` or `https://example.com`. |\n| `email` | optional | Emails the report and speeds claiming the account later. |\n\nReturns the teaser — score, confidence interval, top gap, report URL, and an unlock link. The full ranked fix plan and verification re-scan are **never** returned; they unlock with a free account.\n\n## Configuration (env)\n\n| Var | Default | Purpose |\n|---|---|---|\n| `COLLIMER_API_BASE` | `https://app.collimer.com` | API base URL |\n| `COLLIMER_SCAN_SOURCE` | `mcp` | Funnel-attribution channel (set per distribution) |\n| `COLLIMER_MAX_POLLS` | `60` | Max poll attempts |\n| `COLLIMER_POLL_INTERVAL_MS` | `5000` | Poll interval |\n| `COLLIMER_REQUEST_TIMEOUT_MS` | `30000` | Per-request timeout |\n\n## What is Collimer?\n\n[Collimer](https://collimer.com) measures and improves how often AI answer engines cite your brand — generative engine optimization (GEO), the AI-search successor to SEO. This MCP server is the free front door: scan any site from inside your assistant, see the score and the biggest gap, then open the full report and get your ranked fix plan at [collimer.com](https://collimer.com). API docs: [app.collimer.com/docs](https://app.collimer.com/docs).\n\n## Privacy\n\nThe server calls Collimer's public scan API for the domain you pass and returns the result. It doesn't read your files or your conversation. Scans carry a `source` tag (default `mcp`) so we can see which channels are useful — no personal data beyond the optional email you provide.\n\n## Develop\n\n```bash\nnpm install\nnpm run build          # → dist/\nnpm run smoke          # real scan against prod, prints the teaser\nnpm run test:protocol  # spawns the server + calls the tool over MCP/stdio\n```\n\n## License\n\nMIT © [Sandcastle Labs](https://sandcastlelabs.ai)\n",
  "bytes": 3381,
  "sha": "40a2aaa5a71aaf893122f519806611715bde5cd1b316335fc2ce68624c4e4a5a",
  "repo_slug": "sandcastlelabs/collimer-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sandcastlelabs_collimer_mcp_000c7ac7/readme"
}