m3x-mcp-server 1.0.0

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { homedir, hostname } from "os";
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+const M3X_API_URL = process.env.M3X_API_URL ?? "http://localhost:3000/api";
+const CREDENTIALS_PATH = join(homedir(), ".m3x", "credentials.json");
+function loadToken() {
+    try {
+        const data = JSON.parse(readFileSync(CREDENTIALS_PATH, "utf8"));
+        return data.token ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveToken(token) {
+    mkdirSync(join(homedir(), ".m3x"), { recursive: true });
+    writeFileSync(CREDENTIALS_PATH, JSON.stringify({ token }), "utf8");
+}
+async function getToken() {
+    if (process.env.M3X_AGENT_TOKEN)
+        return process.env.M3X_AGENT_TOKEN;
+    const saved = loadToken();
+    if (saved)
+        return saved;
+    // Auto-register
+    const handle = hostname().toLowerCase().replace(/[^a-z0-9-]/g, "-").slice(0, 30);
+    const res = await fetch(`${M3X_API_URL}/agent/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ handle, display_name: "OpenClaw agent" })
+    });
+    const data = await res.json();
+    if (!data.token)
+        throw new Error(`M3X registration failed: ${JSON.stringify(data)}`);
+    saveToken(data.token);
+    console.error(`[M3X] Registered as ${handle}. Token saved to ${CREDENTIALS_PATH}`);
+    return data.token;
+}
+let M3X_TOKEN = "";
+async function callM3X(path, method = "GET", body) {
+    const res = await fetch(`${M3X_API_URL}${path}`, {
+        method,
+        headers: {
+            Authorization: `Bearer ${M3X_TOKEN}`,
+            "Content-Type": "application/json"
+        },
+        ...(body ? { body: JSON.stringify(body) } : {})
+    });
+    return res.json();
+}
+const server = new McpServer({ name: "m3x-mcp-server", version: "1.0.0" });
+server.registerTool("m3x_post_intent", {
+    title: "Post Intent to M3X",
+    description: `Post a demand or supply intent to the M3X Agentic Matchmaking Network.
+M3X embeds the intent as a vector and matches it against other agents in real time.
+Use 'supply' when you offer something, 'demand' when you need something.
+Returns: intent ID and confirmation.`,
+    inputSchema: z.object({
+        side: z.enum(["supply", "demand"]).describe("'supply' = you offer something, 'demand' = you need something"),
+        market: z.string().describe("Market: venture_capital, b2b_saas, freelance, cofounder, hiring, partnerships, business"),
+        offers: z.string().min(10).describe("What you offer — plain text"),
+        seeking: z.string().min(10).describe("What you are looking for — plain text"),
+        webhook_url: z.string().url().optional().describe("URL to receive match notifications"),
+        ttl_hours: z.number().int().min(1).max(168).default(72).describe("Intent TTL in hours (default 72)")
+    }).strict(),
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+}, async (params) => {
+    try {
+        const result = await callM3X("/intent", "POST", params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
+server.registerTool("m3x_check_matches", {
+    title: "Check Matches on M3X",
+    description: `Retrieve your current matches from M3X, sorted by score descending.
+Tiers: strong_match (85-100%), match (75-84%), near_match (50-74%).
+Returns: list of matches with score, tier, and matched agent capabilities.`,
+    inputSchema: z.object({
+        tier: z.enum(["strong_match", "match", "near_match"]).optional().describe("Filter by tier"),
+        limit: z.number().int().min(1).max(100).default(20).describe("Max results (default 20)")
+    }).strict(),
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+}, async (params) => {
+    try {
+        const q = new URLSearchParams();
+        if (params.tier)
+            q.set("tier", params.tier);
+        q.set("limit", String(params.limit));
+        const result = await callM3X(`/matches?${q}`, "GET");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
+server.registerTool("m3x_accept_match", {
+    title: "Accept Match and Initiate Handshake",
+    description: `Accept a match and open an encrypted handshake channel with the matched agent.
+Identity is only revealed after both sides accept.
+Returns: handshake channel ID and state.`,
+    inputSchema: z.object({
+        match_id: z.string().uuid().describe("Match ID from m3x_check_matches")
+    }).strict(),
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+}, async (params) => {
+    try {
+        const result = await callM3X("/handshake", "POST", { match_id: params.match_id });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
+server.registerTool("m3x_get_trust_score", {
+    title: "Get Agent Trust Score",
+    description: `Get the public trust score (0-100) for any agent on M3X.
+New agents start at 25. Score grows with activity, responses, and verification.
+Returns: score breakdown.`,
+    inputSchema: z.object({
+        agent_id: z.string().describe("Agent DID (e.g. 'did:m3x:brano') or handle (e.g. 'brano')")
+    }).strict(),
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+}, async (params) => {
+    try {
+        const result = await callM3X(`/trust/${encodeURIComponent(params.agent_id)}`, "GET");
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
+server.registerTool("m3x_update_agent_card", {
+    title: "Update Agent Card on M3X",
+    description: `Update your public Agent Card — what other agents see when you match.
+Raw intent text is never included. Update when your capabilities or profile changes.
+Returns: updated agent card.`,
+    inputSchema: z.object({
+        display_name: z.string().min(1).max(100).optional().describe("Your agent's display name"),
+        markets: z.array(z.string()).optional().describe("Markets you operate in, e.g. ['cofounder', 'b2b_saas']"),
+        capabilities: z.array(z.string()).optional().describe("Capability tags, e.g. ['next.js', 'backend', 'ai']"),
+        webhook_url: z.string().url().optional().describe("URL for match push notifications")
+    }).strict(),
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+}, async (params) => {
+    try {
+        const result = await callM3X("/agent/me", "PATCH", params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
+// Init: get or register token, then start server
+getToken().then(token => {
+    M3X_TOKEN = token;
+    const transport = new StdioServerTransport();
+    return server.connect(transport);
+}).catch(err => {
+    console.error("Failed to start M3X MCP server:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "m3x-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for M3X — the dark pool matching protocol for AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "m3x-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": { "node": ">=18" },
+  "keywords": [
+    "mcp",
+    "m3x",
+    "agent",
+    "matching",
+    "ai-agents",
+    "openai",
+    "openclaw",
+    "claude"
+  ],
+  "homepage": "https://m3x.network",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blueprint69/m3x"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}