ssid-mcp 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# ssid-mcp
+
+MCP server for [SSID](https://ssid.ai) — identify the manufacturer behind any MAC
+address, and detect randomized/private addresses used by modern phones.
+
+## Install
+
+Add to any MCP-capable host (Claude Desktop, Cursor, etc.):
+
+```json
+{
+  "mcpServers": {
+    "ssid": { "command": "npx", "args": ["-y", "ssid-mcp"] }
+  }
+}
+```
+
+## Tool
+
+- **`lookup_mac(mac)`** → vendor, OUI, `kind` (universal / randomized / multicast /
+  invalid), `randomized` flag, confidence and the source.
+
+```
+lookup_mac("F4:F5:E8:11:22:33")
+→ { "vendor": { "organization": "Google, Inc." }, "kind": "universal", "randomized": false, ... }
+```
+
+## Auth
+
+The free tier needs no key. To raise limits, set `SSID_API_KEY` (get one at
+https://ssid.ai/api-docs). Point at a different base with `SSID_API_BASE`.
+
+Data compiled from the IEEE OUI registry. Facts are public; SSID adds freshness,
+randomized-MAC detection and a stable, SLA-backed feed.

package/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * ssid-mcp — standalone, publishable MCP server for agent hosts.
+ *
+ * Unlike the in-repo mcp/server.ts (which reads the local DB), this package calls
+ * the HOSTED public API (https://ssid.ai/api/v1/lookup) so `npx -y ssid-mcp` works
+ * with zero local data. One tool: lookup_mac. No API key needed for the free tier;
+ * set SSID_API_KEY to raise limits.
+ *
+ * NOT YET PUBLISHED — publishing to npm + the MCP registries (growth G1) is gated on
+ * the G19 paid-agent validation and the 6201 license. This is publish-ready.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const BASE = process.env.SSID_API_BASE || "https://ssid.ai";
+const API_KEY = process.env.SSID_API_KEY || "";
+
+async function lookup(mac) {
+  const url = `${BASE}/api/v1/lookup?mac=${encodeURIComponent(mac)}`;
+  const headers = API_KEY ? { Authorization: `Bearer ${API_KEY}` } : {};
+  const res = await fetch(url, { headers });
+  if (!res.ok) throw new Error(`SSID API error ${res.status}`);
+  return res.json();
+}
+
+async function main() {
+  const server = new McpServer({ name: "ssid", version: "0.1.0" });
+
+  server.registerTool(
+    "lookup_mac",
+    {
+      title: "MAC / OUI vendor lookup",
+      description:
+        "Identify the manufacturer (vendor) behind a MAC address from its OUI, and detect randomized/private (locally-administered) addresses used by modern phones. Returns vendor, OUI, kind, randomized flag, confidence and the source.",
+      inputSchema: { mac: z.string().describe("A MAC address in any format, e.g. F4:F5:E8:11:22:33") },
+    },
+    async ({ mac }) => {
+      try {
+        const data = await lookup(mac);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: `Lookup failed: ${e.message}` }], isError: true };
+      }
+    },
+  );
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("[ssid-mcp] ready on stdio");
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "ssid-mcp",
+  "version": "0.1.0",
+  "description": "SSID MCP server — identify the manufacturer behind any MAC address, with randomized-address detection. Backed by ssid.ai.",
+  "author": "SSID (Drumworks Ventures FZ)",
+  "license": "MIT",
+  "publishConfig": { "access": "public" },
+  "type": "module",
+  "bin": {
+    "ssid-mcp": "index.js"
+  },
+  "files": ["index.js", "README.md"],
+  "keywords": ["mcp", "modelcontextprotocol", "mac-address", "oui", "network", "device-identity", "ssid"],
+  "homepage": "https://ssid.ai",
+  "repository": { "type": "git", "url": "https://github.com/Drumworks/ssid" },
+  "engines": { "node": ">=18" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  }
+}