collimer-mcp
Advanced tools
+4
-7
@@ -5,3 +5,3 @@ #!/usr/bin/env node | ||
| // Never returns the full report (gated behind a free account). | ||
| // `beacon_free_scan` is kept as a deprecated hidden alias (removed in a future release). | ||
| // (The deprecated `beacon_free_scan` alias was removed in 0.3.0 after its one-release window.) | ||
| import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; | ||
@@ -12,3 +12,3 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"; | ||
| const OVERALL_TIMEOUT_MS = 5 * 60 * 1000; | ||
| const server = new McpServer({ name: "collimer", version: "0.2.1" }); | ||
| const server = new McpServer({ name: "collimer", version: "0.3.0" }); | ||
| const scanToolConfig = { | ||
@@ -19,4 +19,4 @@ title: "Collimer AI-visibility scan", | ||
| "AI-visibility score (0–100), a confidence interval, the single biggest gap, and a " + | ||
| "branded report URL. The full report (share of voice across each engine + every " + | ||
| "recommendation) unlocks with a free account on the web. Tip: after the site makes " + | ||
| "branded report URL. The full ranked fix plan + verification re-scan unlock with a " + | ||
| "free account on the web. Tip: after the site makes " + | ||
| "changes, re-run the scan to measure the delta.", | ||
@@ -48,6 +48,3 @@ inputSchema: { | ||
| } | ||
| // Primary tool. | ||
| server.registerTool("collimer_scan", scanToolConfig, handleScan); | ||
| // Deprecated alias — kept one release for clients pinned to the old name. | ||
| server.registerTool("beacon_free_scan", { ...scanToolConfig, description: `${scanToolConfig.description} (Deprecated alias for collimer_scan.)` }, handleScan); | ||
| async function main() { | ||
@@ -54,0 +51,0 @@ const transport = new StdioServerTransport(); |
+2
-4
@@ -5,3 +5,3 @@ // Core scan logic — wraps the Collimer public free-scan REST API. | ||
| export const SOURCE = process.env.COLLIMER_SCAN_SOURCE ?? "mcp"; | ||
| export const USER_AGENT = "collimer-mcp/0.2.1"; | ||
| export const USER_AGENT = "collimer-mcp/0.3.0"; | ||
| /** Parse a positive-number env override, falling back when missing/invalid (#7). */ | ||
@@ -139,7 +139,5 @@ function num(value, fallback) { | ||
| lines.push(`Full scorecard: ${t.report_url}`); | ||
| const total = t.full_report?.recommendations_total; | ||
| const unlock = t.cta_url ?? t.full_report?.unlock_url; | ||
| if (unlock) { | ||
| const n = typeof total === "number" ? `${total} recommendations + ` : ""; | ||
| lines.push(`Unlock the full report (${n}share of voice across each AI engine) with a free account: ${unlock}`); | ||
| lines.push(`Unlock the full ranked fix plan for this domain with a free account: ${unlock}`); | ||
| } | ||
@@ -146,0 +144,0 @@ lines.push("Tip: after you make changes, re-run the scan to measure the delta."); |
+2
-2
| { | ||
| "name": "collimer-mcp", | ||
| "version": "0.2.1", | ||
| "version": "0.3.0", | ||
| "mcpName": "io.github.sandcastlelabs/collimer-mcp", | ||
| "description": "MCP server for Collimer — run a free AI-search visibility scan on any website and get the score, top gap, and a branded report.", | ||
| "description": "MCP server for Collimer — run a free AI-search visibility scan on any website: score, top findings, and the upgrade path to a full ranked fix plan with verification.", | ||
| "license": "MIT", | ||
@@ -7,0 +7,0 @@ "homepage": "https://collimer.com", |
+3
-3
@@ -9,3 +9,3 @@ # collimer-mcp | ||
| It 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 report — share of voice across every engine + every recommendation — unlocks with a free account at [collimer.com](https://collimer.com). | ||
| It 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). | ||
@@ -48,3 +48,3 @@ ## Install | ||
| Returns the teaser — score, confidence interval, top gap, report URL, and an unlock link. It **never** returns the full report; that's gated behind a free account. | ||
| Returns 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. | ||
@@ -63,3 +63,3 @@ ## Configuration (env) | ||
| [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 start tracking at [collimer.com](https://collimer.com). API docs: [app.collimer.com/docs](https://app.collimer.com/docs). | ||
| [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). | ||
@@ -66,0 +66,0 @@ ## Privacy |
17189
-2.19%261
-1.88%