uniqueness-mcp 0.1.0

package/index.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+// Uniqueness Engine MCP server. Exposes the connection brief as an agent tool.
+// Auth: UNIQUENESS_API_KEY env (get one: POST /api/signup, or `npx uniqueness signup`).
+//
+// Claude/Cursor/Codex config:
+//   { "mcpServers": { "uniqueness": {
+//       "command": "npx", "args": ["-y", "uniqueness-mcp"],
+//       "env": { "UNIQUENESS_API_KEY": "uq_live_..." } } } }
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const BASE = process.env.UNIQUENESS_API_URL || "https://uniquenessengine.com";
+const KEY = process.env.UNIQUENESS_API_KEY || "";
+
+const server = new McpServer({ name: "uniqueness", version: "0.1.0" });
+
+server.tool(
+  "get_connection_brief",
+  "Given a LinkedIn URL (or name + company, or email), return a fact-checked Connection Brief: " +
+    "verified personal + professional signal, each claim grounded in a source + verbatim quote, " +
+    "identity-gated (returns needs_review rather than guessing), with outreach angles. " +
+    "Every credit charge is reported. Use before personalized outreach, gifting, or call prep.",
+  {
+    linkedin_url: z.string().optional().describe("LinkedIn profile URL"),
+    name: z.string().optional().describe("Full name (use with company)"),
+    company: z.string().optional().describe("Company name (use with name)"),
+    email: z.string().optional().describe("Work email (optional disambiguator)"),
+    deep: z.boolean().optional().describe("Async deep social mode (when available)"),
+  },
+  async (args) => {
+    if (!KEY) {
+      return {
+        isError: true,
+        content: [{ type: "text", text: "Missing UNIQUENESS_API_KEY. Get a free key: POST https://uniquenessengine.com/api/signup {email}." }],
+      };
+    }
+    if (!args.linkedin_url && !args.name) {
+      return { isError: true, content: [{ type: "text", text: "Provide linkedin_url, or name (+ company)." }] };
+    }
+    const body = {};
+    if (args.linkedin_url) body.linkedin_url = args.linkedin_url;
+    if (args.name) body.name = args.name;
+    if (args.company) body.company = args.company;
+    if (args.email) body.email = args.email;
+    if (args.deep) body.mode = "deep";
+
+    const res = await fetch(`${BASE}/api/brief`, {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${KEY}` },
+      body: JSON.stringify(body),
+    });
+    const json = await res.json().catch(() => ({}));
+    if (res.status === 401) return { isError: true, content: [{ type: "text", text: "401 unauthorized — invalid API key." }] };
+    if (res.status === 402) return { isError: true, content: [{ type: "text", text: "Out of credits. " + (json.message || "") }] };
+    if (!res.ok) return { isError: true, content: [{ type: "text", text: `brief failed (${res.status}): ${json.error || ""}` }] };
+
+    return { content: [{ type: "text", text: JSON.stringify(json, null, 2) }] };
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("uniqueness-mcp ready (stdio)");

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "uniqueness-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Uniqueness Engine — fact-checked connection briefs as an agent tool.",
+  "type": "module",
+  "bin": {
+    "uniqueness-mcp": "./index.mjs"
+  },
+  "files": [
+    "index.mjs"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "license": "MIT"
+}