@localleads/mcp 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# @localleads/mcp
+
+Stdio [Model Context Protocol](https://modelcontextprotocol.io) server for [LocalLeads](https://leads.postorbit.io). Connects Claude Desktop, Cursor, VS Code, and other local MCP clients to the LocalLeads REST API so the model can search Google Maps for businesses, enrich contacts, and check your credit balance without leaving the chat.
+
+> **Using Claude.ai (web)?** Use the **remote** MCP connector at `https://leadsapi.postorbit.io/mcp` instead. It supports OAuth so claude.ai can connect with one click. See [the docs](https://leads.postorbit.io/docs/api/mcp) for details.
+
+## Install
+
+```bash
+npm install -g @localleads/mcp
+# or run on demand with npx (no install)
+npx -y @localleads/mcp
+```
+
+## Configure
+
+You need a LocalLeads API key (starts with `ll_`). Generate one at **Settings → Security → API Keys** in your LocalLeads dashboard.
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "localleads": {
+      "command": "npx",
+      "args": ["-y", "@localleads/mcp"],
+      "env": {
+        "LOCALLEADS_API_KEY": "ll_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The LocalLeads tool icon (🔨) appears in the chat toolbar.
+
+### Cursor / VS Code
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "localleads": {
+      "command": "npx",
+      "args": ["-y", "@localleads/mcp"],
+      "env": {
+        "LOCALLEADS_API_KEY": "ll_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Name | Cost | What it does |
+|---|---|---|
+| `search_leads` | charges credits | Search Google Maps for businesses in a location. Returns a query ID. |
+| `get_query_progress` | free | Poll the status of an in-flight search. |
+| `get_search_results` | free | Retrieve leads from a completed search. |
+| `list_all_leads` | free | List every lead saved in the account, with filters. |
+| `enrich_leads` | 1 credit per lead | Find verified business emails for one or more leads. |
+| `get_enrichment_result` | free | Get the email + confidence score for an enriched lead. |
+| `list_enrichment_jobs` | free | List in-flight search and enrichment jobs. |
+| `check_credits` | free | Return current credit balance. |
+
+## Environment variables
+
+| Var | Required | Description |
+|---|---|---|
+| `LOCALLEADS_API_KEY` | yes | Your `ll_…` API key. |
+| `LOCALLEADS_API_BASE` | no | Override the API base URL. Defaults to `https://leadsapi.postorbit.io`. Must be `https://`. |
+
+## Maintainers
+
+Publishing a new version? See [PUBLISHING.md](https://github.com/EtherLabZ/LocalLeads/blob/main/leads-mcp/PUBLISHING.md) for the 2FA / token workflow.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * LocalLeads MCP Server
+ *
+ * Exposes the LocalLeads REST API as MCP tools so Claude (and any other MCP
+ * client) can search local business leads, enrich contacts, and manage
+ * credits without leaving the conversation.
+ *
+ * Config (environment variables):
+ *   LOCALLEADS_API_KEY   required  Your API key (starts with ll_)
+ *   LOCALLEADS_API_BASE  optional  Override the base URL (default: production)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/index.js

@@ -0,0 +1,330 @@
+#!/usr/bin/env node
+/**
+ * LocalLeads MCP Server
+ *
+ * Exposes the LocalLeads REST API as MCP tools so Claude (and any other MCP
+ * client) can search local business leads, enrich contacts, and manage
+ * credits without leaving the conversation.
+ *
+ * Config (environment variables):
+ *   LOCALLEADS_API_KEY   required  Your API key (starts with ll_)
+ *   LOCALLEADS_API_BASE  optional  Override the base URL (default: production)
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// ─── Config ──────────────────────────────────────────────────────────────────
+const API_KEY = process.env.LOCALLEADS_API_KEY ?? "";
+const BASE_URL = process.env.LOCALLEADS_API_BASE ?? "https://leadsapi.postorbit.io";
+if (!API_KEY) {
+    process.stderr.write("Error: LOCALLEADS_API_KEY environment variable is required.\n" +
+        "Generate one at https://leads.postorbit.io/dashboard/settings?tab=security\n");
+    process.exit(1);
+}
+// Only allow https:// base URLs to prevent accidental key exfiltration
+if (!BASE_URL.startsWith("https://")) {
+    process.stderr.write("Error: LOCALLEADS_API_BASE must start with https://\n");
+    process.exit(1);
+}
+// ─── Input validation helpers ─────────────────────────────────────────────────
+/**
+ * Validates a path segment (query ID, lead ID) to prevent path traversal.
+ * Allows alphanumeric characters, hyphens, and underscores only.
+ */
+function assertSafeId(value, name) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${name} must be a non-empty string`);
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(value)) {
+        throw new Error(`${name} contains invalid characters. Only alphanumeric, hyphens, and underscores are allowed.`);
+    }
+    if (value.length > 128) {
+        throw new Error(`${name} is too long (max 128 characters)`);
+    }
+    return value;
+}
+/** Clamps a numeric argument to an inclusive range. */
+function clampInt(value, min, max, fallback) {
+    const n = typeof value === "number" ? Math.floor(value) : fallback;
+    return Math.min(Math.max(n, min), max);
+}
+// ─── API client ──────────────────────────────────────────────────────────────
+async function call(method, path, body) {
+    const url = `${BASE_URL}${path}`;
+    const res = await fetch(url, {
+        method,
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    const json = (await res.json());
+    if (!json.success) {
+        throw new Error(json.error ?? `API error ${res.status}`);
+    }
+    // Return both data and meta when present (pagination)
+    if (json.meta !== undefined) {
+        return { data: json.data, meta: json.meta };
+    }
+    return json.data;
+}
+// ─── Tool definitions ─────────────────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: "search_leads",
+        description: "Search Google Maps for local businesses and generate a lead list. " +
+            "Returns a query ID you can poll with get_search_results. " +
+            "Each search costs 1 credit. Use check_credits first if unsure of balance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: 'What to search for, e.g. "plumbers", "coffee shops", "dentists"',
+                },
+                location: {
+                    type: "string",
+                    description: 'City or region to search in, e.g. "London", "Manchester", "New York"',
+                },
+                country: {
+                    type: "string",
+                    description: 'Two-letter ISO country code, e.g. "GB", "US", "AU"',
+                    default: "GB",
+                },
+                resultLimit: {
+                    type: "number",
+                    description: "Maximum number of leads to return (1–100, default 20)",
+                    default: 20,
+                },
+            },
+            required: ["query", "location"],
+        },
+    },
+    {
+        name: "get_search_results",
+        description: "Retrieve the leads from a completed search query. " +
+            "Poll this after search_leads until status is COMPLETED. " +
+            "Returns an array of business leads with name, address, phone, website, rating.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                queryId: {
+                    type: "string",
+                    description: "The query ID returned by search_leads",
+                },
+                limit: {
+                    type: "number",
+                    description: "Number of leads to return per page (default 20, max 100)",
+                    default: 20,
+                },
+                offset: {
+                    type: "number",
+                    description: "Pagination offset (default 0)",
+                    default: 0,
+                },
+            },
+            required: ["queryId"],
+        },
+    },
+    {
+        name: "get_query_progress",
+        description: "Check the progress of an in-flight search query. " +
+            "Returns status (PENDING, PROCESSING, COMPLETED, FAILED) and percent complete.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                queryId: {
+                    type: "string",
+                    description: "The query ID returned by search_leads",
+                },
+            },
+            required: ["queryId"],
+        },
+    },
+    {
+        name: "list_all_leads",
+        description: "List all leads saved in the account across all searches. " +
+            "Supports pagination and optional text filtering.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Leads per page (default 20, max 100)",
+                    default: 20,
+                },
+                offset: {
+                    type: "number",
+                    description: "Pagination offset (default 0)",
+                    default: 0,
+                },
+                search: {
+                    type: "string",
+                    description: "Optional text filter applied to business name and address",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "enrich_leads",
+        description: "Start an enrichment job to find verified business emails for one or " +
+            "more leads. Returns a job ID. Each successful enrichment costs 1 credit.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                leadIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "IDs of leads to enrich. Either leadIds or queryId is required.",
+                },
+                queryId: {
+                    type: "string",
+                    description: "Enrich every lead in this query. Mutually exclusive with leadIds.",
+                },
+                maxCredits: {
+                    type: "number",
+                    description: "Optional safety cap on credits to spend.",
+                },
+            },
+        },
+    },
+    {
+        name: "get_enrichment_result",
+        description: "Retrieve the enrichment result (email, confidence score, etc.) for a lead " +
+            "that has been enriched. Returns null if enrichment has not been run yet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                leadId: {
+                    type: "string",
+                    description: "The ID of the lead",
+                },
+            },
+            required: ["leadId"],
+        },
+    },
+    {
+        name: "list_enrichment_jobs",
+        description: "List all pending and completed enrichment jobs for the account. " +
+            "Useful for checking bulk enrichment status.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "check_credits",
+        description: "Check the current credit balance for the account. " +
+            "Returns monthly credits, bonus credits, used credits, and available credits.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+];
+// ─── Tool handlers ────────────────────────────────────────────────────────────
+async function handleTool(name, args) {
+    switch (name) {
+        case "search_leads": {
+            const result = await call("POST", "/api/v1/leads/search", {
+                query: String(args.query ?? "").slice(0, 200),
+                location: String(args.location ?? "").slice(0, 200),
+                country: String(args.country ?? "GB").slice(0, 2).toUpperCase(),
+                resultLimit: clampInt(args.resultLimit, 1, 100, 20),
+            });
+            return JSON.stringify(result, null, 2);
+        }
+        case "get_search_results": {
+            const queryId = assertSafeId(args.queryId, "queryId");
+            const params = new URLSearchParams();
+            params.set("limit", String(clampInt(args.limit, 1, 100, 20)));
+            params.set("offset", String(clampInt(args.offset, 0, 100_000, 0)));
+            const result = await call("GET", `/api/v1/leads/query/${queryId}/leads?${params}`);
+            return JSON.stringify(result, null, 2);
+        }
+        case "get_query_progress": {
+            const queryId = assertSafeId(args.queryId, "queryId");
+            const result = await call("GET", `/api/v1/leads/query/${queryId}/progress`);
+            return JSON.stringify(result, null, 2);
+        }
+        case "list_all_leads": {
+            const params = new URLSearchParams();
+            params.set("limit", String(clampInt(args.limit, 1, 100, 20)));
+            params.set("offset", String(clampInt(args.offset, 0, 100_000, 0)));
+            if (typeof args.search === "string" && args.search.length > 0) {
+                params.set("search", args.search.slice(0, 200));
+            }
+            const result = await call("GET", `/api/v1/leads/all?${params}`);
+            return JSON.stringify(result, null, 2);
+        }
+        case "enrich_leads": {
+            const leadIds = Array.isArray(args.leadIds)
+                ? args.leadIds.map((id) => assertSafeId(id, "leadIds[]"))
+                : undefined;
+            const queryId = typeof args.queryId === "string" && args.queryId.length > 0
+                ? assertSafeId(args.queryId, "queryId")
+                : undefined;
+            if (!leadIds && !queryId) {
+                throw new Error("Either leadIds or queryId is required");
+            }
+            const result = await call("POST", "/api/v1/enrichment/start", {
+                leadIds,
+                queryId,
+                maxCredits: typeof args.maxCredits === "number" ? args.maxCredits : undefined,
+            });
+            return JSON.stringify(result, null, 2);
+        }
+        case "get_enrichment_result": {
+            const leadId = assertSafeId(args.leadId, "leadId");
+            const result = await call("GET", `/api/v1/enrichment/lead/${leadId}`);
+            return JSON.stringify(result, null, 2);
+        }
+        case "list_enrichment_jobs": {
+            const result = await call("GET", "/api/v1/enrichment/jobs");
+            return JSON.stringify(result, null, 2);
+        }
+        case "check_credits": {
+            const result = await call("GET", "/api/v1/credits/balance");
+            return JSON.stringify(result, null, 2);
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+// ─── Server ───────────────────────────────────────────────────────────────────
+const server = new Server({
+    name: "localleads",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    try {
+        const text = await handleTool(name, args);
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@localleads/mcp",
+  "version": "0.1.0",
+  "description": "Stdio MCP server for LocalLeads — let Claude Desktop, Cursor, and other local MCP clients search business leads, enrich contacts, and check credits via the LocalLeads API. For Claude.ai use the remote MCP connector at https://leadsapi.postorbit.io/mcp instead.",
+  "type": "module",
+  "bin": {
+    "localleads-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-desktop",
+    "cursor",
+    "leads",
+    "local-business",
+    "google-maps",
+    "lead-generation",
+    "localleads"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EtherLabZ/LocalLeads.git",
+    "directory": "leads-mcp"
+  },
+  "homepage": "https://leads.postorbit.io/docs/api/mcp",
+  "bugs": {
+    "url": "https://github.com/EtherLabZ/LocalLeads/issues"
+  }
+}