@mambalabsdev/mcp-icp-fit-scorer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mamba Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# ICP Fit Scorer MCP Server
+
+An MCP server that scores a company against your ideal customer profile. It wraps the Mamba Labs ICP Fit Scorer actor on Apify and returns a Clay-ready flat JSON row to any MCP client.
+
+## What it does
+
+Give it a company domain and a definition of your ICP, and it scores the company on weighted signals, returning a 0 to 100 score, an A to D tier, and a per-signal breakdown. Define your ICP three ways: a prebuilt template, a JSON scoring config, or a plain-English description (which uses your own LLM key). Turn on `fetch_signals` and the actor will gather hiring and tech-stack signals for you before scoring. One flat row, ready for Clay, a CRM, or an AI agent workflow. All of the scoring runs on Apify. This package is a thin client that calls the actor and hands back the result.
+
+## Quick start
+
+You need Node.js 18 or newer and an Apify account with an API token.
+
+Add this to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "mamba-icp-scorer": {
+      "command": "npx",
+      "args": ["-y", "@mambalabsdev/mcp-icp-fit-scorer"],
+      "env": {
+        "APIFY_TOKEN": "your-apify-token"
+      }
+    }
+  }
+}
+```
+
+Get your token at https://console.apify.com/account/integrations, paste it in, and restart Claude Desktop. The `score_icp_fit` tool will be available.
+
+## Prerequisites
+
+- Node.js 18 or newer
+- An Apify account with an API token
+
+## Example prompts
+
+- "Score clay.com against the b2b_saas template and fetch its signals."
+- "How well does stripe.com fit an ICP of mid-market fintech companies? Explain the score."
+- "Score figma.com with my scoring config and include the per-signal breakdown."
+- "Rate openai.com against this ICP description: enterprise AI teams hiring for go-to-market."
+
+## Inputs
+
+- `company_domain` (required): the primary domain of the company to score. Example: `clay.com`
+- `company_name` (optional): display name of the company.
+- `template` (optional): name of a prebuilt scoring config.
+- `scoring_config` (optional): a JSON object of scoring weights.
+- `icp_description` (optional): plain-English ICP description. Requires `llm_api_key`.
+- `llm_api_key` (optional): your OpenAI or Anthropic key, used only with `icp_description`.
+- `llm_provider` (optional): `openai` or `anthropic`.
+- `fetch_signals` (optional): let the actor gather hiring and tech-stack signals automatically.
+- `include_explanation` (optional): add a `score_explanation` string to the output.
+
+Define your ICP with exactly one of `template`, `scoring_config`, or `icp_description`.
+
+This server exposes the single-company scoring path. The actor also supports batch inputs (a dataset or CSV of companies) and a results webhook. For those, run the actor directly on Apify.
+
+## Output
+
+The tool returns the actor's flat JSON row for the scored company, including `icp_score` (0 to 100), `icp_tier` (A to D), the per-signal breakdown, and an optional explanation. See the Apify Store page for the full output schema.
+
+## Full actor documentation
+
+This server is a thin client and holds no scoring logic. For the complete input and output reference, pricing, and run history, see the Apify Store page:
+
+https://apify.com/mambalabs/icp-fit-scorer
+
+## Mamba Labs GTM Suite
+
+This is one of six actors in the Mamba Labs GTM Suite, covering hiring signals, tech stack detection, signal aggregation, job board keyword scanning, LinkedIn URL resolution, and ICP scoring. See them all at https://apify.com/mambalabs.
+
+## License
+
+MIT
+
+Built by Mamba Labs. https://apify.com/mambalabs

package/build/index.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+const APIFY_TOKEN = process.env.APIFY_TOKEN;
+if (!APIFY_TOKEN) {
+    console.error([
+        "APIFY_TOKEN is not set.",
+        "This server needs an Apify API token to run the ICP Fit Scorer actor.",
+        "Create a token at https://console.apify.com/account/integrations and pass it as the APIFY_TOKEN environment variable.",
+    ].join("\n"));
+    process.exit(1);
+}
+// The tilde between the org name and the actor name is Apify's required separator.
+const ACTOR_ENDPOINT = "https://api.apify.com/v2/acts/mambalabs~icp-fit-scorer/run-sync-get-dataset-items?timeout=300";
+const server = new McpServer({
+    name: "mamba-icp-fit-scorer",
+    version: pkg.version,
+});
+// This tool exposes the single-company scoring surface. The actor also supports
+// batch inputs (dataset_id, csv_url), a webhook, and ~18 manual signal-override
+// fields; those are intentionally not surfaced here. Use fetch_signals to let the
+// actor gather hiring and tech-stack signals on its own.
+server.tool("score_icp_fit", "Score a company against your ideal customer profile (ICP) using weighted signals. Returns a 0 to 100 icp_score, an A to D icp_tier, and a per-signal breakdown as a flat, Clay-ready JSON row. Define your ICP with a prebuilt template, a JSON scoring_config, or a plain-English icp_description (which requires llm_api_key).", {
+    company_domain: z
+        .string()
+        .describe("The primary domain of the company to score. Example: clay.com"),
+    company_name: z.string().optional().describe("Optional display name of the company."),
+    template: z
+        .string()
+        .optional()
+        .describe("Name of a prebuilt scoring config. Alternative to scoring_config or icp_description."),
+    scoring_config: z
+        .record(z.any())
+        .optional()
+        .describe("JSON object of scoring weights. Alternative to template or icp_description."),
+    icp_description: z
+        .string()
+        .optional()
+        .describe("Plain-English description of your target ICP. Requires llm_api_key. Alternative to template or scoring_config."),
+    llm_api_key: z
+        .string()
+        .optional()
+        .describe("Your OpenAI or Anthropic API key. Required only when using icp_description."),
+    llm_provider: z
+        .string()
+        .optional()
+        .describe("LLM provider to use with icp_description: openai or anthropic."),
+    fetch_signals: z
+        .boolean()
+        .optional()
+        .describe("If true, the actor fetches hiring and tech-stack signals for the company automatically before scoring."),
+    include_explanation: z
+        .boolean()
+        .optional()
+        .describe("If true, adds a score_explanation string to the output describing how the score was derived."),
+}, async (args) => {
+    const input = { company_domain: args.company_domain };
+    for (const key of [
+        "company_name",
+        "template",
+        "scoring_config",
+        "icp_description",
+        "llm_api_key",
+        "llm_provider",
+        "fetch_signals",
+        "include_explanation",
+    ]) {
+        if (args[key] !== undefined)
+            input[key] = args[key];
+    }
+    let response;
+    try {
+        response = await fetch(ACTOR_ENDPOINT, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${APIFY_TOKEN}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(input),
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `Could not reach the Apify API: ${message}` }],
+        };
+    }
+    if (!response.ok) {
+        let detail = "";
+        try {
+            const body = (await response.json());
+            if (body?.error?.message)
+                detail = ` ${body.error.message}`;
+        }
+        catch {
+            detail = "";
+        }
+        let message;
+        switch (response.status) {
+            case 401:
+                message = "Invalid Apify token. Check your APIFY_TOKEN environment variable.";
+                break;
+            case 402:
+                message =
+                    "Insufficient Apify credits. Check your account balance at https://console.apify.com/billing";
+                break;
+            case 408:
+                message =
+                    "Actor run timed out after 300 seconds. Try again, or run the actor on Apify directly for longer jobs.";
+                break;
+            default:
+                message = `Apify request failed with status ${response.status}.${detail}`;
+        }
+        return { isError: true, content: [{ type: "text", text: message }] };
+    }
+    const items = await response.json();
+    return {
+        content: [{ type: "text", text: JSON.stringify(items, null, 2) }],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mambalabsdev/mcp-icp-fit-scorer",
+  "version": "1.0.0",
+  "description": "MCP server for ICP Fit Scorer. Scores a company against your ideal customer profile with weighted signals via Apify. Returns a 0 to 100 score, a tier, and a per-signal breakdown. Clay-ready output.",
+  "type": "module",
+  "bin": {
+    "mcp-icp-fit-scorer": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "icp",
+    "lead-scoring",
+    "qualification",
+    "apify",
+    "clay",
+    "lead-generation"
+  ],
+  "author": "Mamba Labs <labs@mambamindsetgrowth.com>",
+  "license": "MIT",
+  "homepage": "https://apify.com/mambalabs/icp-fit-scorer",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mambalabsdev/mcp-icp-fit-scorer"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0"
+  }
+}