@patxin/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# @patxin/mcp-server
+
+MCP server for [patxin.com](https://patxin.com) — patch in a human for real-time cognitive micro-tasks.
+
+When your AI agent needs human judgment — legal review, creative feedback, ethical decisions, domain expertise — it calls patxin and gets a matched human in under 60 seconds.
+
+## Setup
+
+### Claude Desktop / Claude Code
+
+```bash
+claude mcp add patxin -- npx @patxin/mcp-server
+```
+
+### Cursor / other MCP clients
+
+Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "patxin": {
+      "command": "npx",
+      "args": ["@patxin/mcp-server"],
+      "env": {
+        "PATXIN_API_KEY": "pk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `PATXIN_API_KEY` | Yes | Your patxin API key (`pk_live_*` or `pk_test_*`) |
+| `PATXIN_API_URL` | No | Custom API base URL (default: `https://api.patxin.com`) |
+
+Test keys (`pk_test_*`) return simulated responses without real patxers or credit spend.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `patxin_check_limits` | Check remaining credits and request limits |
+| `patxin_check_policy` | Check information policy and allowed skills |
+| `patxin_estimate` | Get price estimate before committing |
+| `patxin_request` | Request a human (blocks until completion) |
+| `patxin_status` | Check status of an existing request |
+| `patxin_rate` | Rate a completed interaction |
+
+## Example
+
+Once connected, your agent can use natural language:
+
+> "I need a Spanish lawyer to review this NDA clause for compliance with GDPR Article 28."
+
+The agent will call `patxin_estimate` to check pricing, then `patxin_request` to get a qualified human review.
+
+## Real-time
+
+The server uses WebSocket connections for instant task completion notifications, with automatic fallback to HTTP polling if WebSocket is unavailable.
+
+## Links
+
+- Website: https://patxin.com
+- API docs: https://patxin.com/docs
+- API health: https://api.patxin.com/v1/health
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,26 @@
+export declare function checkLimits(): Promise<unknown>;
+export declare function checkPolicy(): Promise<unknown>;
+export declare function estimate(body: {
+    skill: string;
+    urgency: string;
+    duration: string;
+}): Promise<unknown>;
+export declare function createRequest(body: {
+    skill: string;
+    urgency: string;
+    duration: string;
+    context: string;
+    max_price: string;
+    information_policy?: string;
+}): Promise<unknown>;
+export declare function getRequestStatus(requestId: string): Promise<unknown>;
+export declare function rateRequest(requestId: string, body: {
+    score: number;
+    comment?: string;
+}): Promise<unknown>;
+export declare function pollUntilComplete(requestId: string, intervalMs?: number, timeoutMs?: number): Promise<unknown>;
+/**
+ * Wait for a request to complete using WebSocket (instant push) with
+ * automatic fallback to HTTP polling if WS connection fails.
+ */
+export declare function waitUntilComplete(requestId: string, timeoutMs?: number): Promise<unknown>;

package/dist/api.js

@@ -0,0 +1,76 @@
+const DEFAULT_BASE_URL = "https://api.patxin.com";
+function getConfig() {
+    const apiKey = process.env.PATXIN_API_KEY;
+    if (!apiKey) {
+        throw new Error("PATXIN_API_KEY environment variable is required");
+    }
+    const baseUrl = process.env.PATXIN_API_URL || DEFAULT_BASE_URL;
+    return { apiKey, baseUrl };
+}
+async function request(method, path, body) {
+    const { apiKey, baseUrl } = getConfig();
+    const res = await fetch(`${baseUrl}${path}`, {
+        method,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const error = data.error;
+        throw new Error(error?.message || `API error: ${res.status}`);
+    }
+    return data;
+}
+export async function checkLimits() {
+    return request("GET", "/v1/account/limits");
+}
+export async function checkPolicy() {
+    return request("GET", "/v1/account/policy");
+}
+export async function estimate(body) {
+    return request("POST", "/v1/estimate", body);
+}
+export async function createRequest(body) {
+    return request("POST", "/v1/requests", body);
+}
+export async function getRequestStatus(requestId) {
+    return request("GET", `/v1/requests/${requestId}`);
+}
+export async function rateRequest(requestId, body) {
+    return request("POST", `/v1/requests/${requestId}/rate`, body);
+}
+export async function pollUntilComplete(requestId, intervalMs = 3000, timeoutMs = 600_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const data = (await getRequestStatus(requestId));
+        if (data.status === "completed" ||
+            data.status === "expired" ||
+            data.status === "cancelled" ||
+            data.status === "disputed") {
+            return data;
+        }
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error(`Request ${requestId} timed out after ${timeoutMs / 1000}s`);
+}
+/**
+ * Wait for a request to complete using WebSocket (instant push) with
+ * automatic fallback to HTTP polling if WS connection fails.
+ */
+export async function waitUntilComplete(requestId, timeoutMs = 600_000) {
+    const { apiKey, baseUrl } = getConfig();
+    try {
+        const { waitForCompletion } = await import("./ws.js");
+        // WS resolves with the event; we still fetch the full status via HTTP
+        await waitForCompletion(requestId, apiKey, baseUrl, timeoutMs);
+        return await getRequestStatus(requestId);
+    }
+    catch {
+        // WS failed (connection refused, timeout, etc.) — fall back to polling
+        return pollUntilComplete(requestId, 3000, timeoutMs);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/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 { checkLimits, checkPolicy, estimate, createRequest, getRequestStatus, waitUntilComplete, rateRequest, } from "./api.js";
+const server = new McpServer({
+    name: "patxin",
+    version: "0.1.0",
+});
+// --- Tools ---
+server.tool("patxin_check_limits", "Check your remaining credits, daily request limits, and concurrent request capacity. Call this before making a request to ensure you have budget.", {}, async () => {
+    try {
+        const data = await checkLimits();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+});
+server.tool("patxin_check_policy", "Check your information policy: what data you can share, which skills are allowed, and whether NDAs are required.", {}, async () => {
+    try {
+        const data = await checkPolicy();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+});
+server.tool("patxin_estimate", "Get a price estimate and availability for a human micro-task before committing. Returns estimated price, available patxers, and match time.", {
+    skill: z.string().describe("Required skill (e.g. 'legal_review_spain', 'code_review', 'translation_en_es')"),
+    urgency: z.enum(["1min", "5min", "15min", "30min"]).describe("How quickly you need a match. Higher urgency costs more."),
+    duration: z.string().describe("Expected task duration (e.g. '5min', '15min', '1h')"),
+}, async ({ skill, urgency, duration }) => {
+    try {
+        const data = await estimate({ skill, urgency, duration });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+});
+server.tool("patxin_request", "Request a qualified human to complete a cognitive micro-task. This tool blocks until the human completes the task (or it expires/is cancelled). Use patxin_estimate first to check pricing. The context field should contain all information the human needs to complete the task.", {
+    skill: z.string().describe("Required skill (e.g. 'legal_review_spain', 'code_review')"),
+    urgency: z.enum(["1min", "5min", "15min", "30min"]).describe("How quickly you need a match"),
+    duration: z.string().describe("Expected task duration (e.g. '15min')"),
+    context: z.string().describe("Full context and instructions for the human. Be specific about what you need."),
+    max_price: z.string().describe("Maximum price you're willing to pay (e.g. '8EUR', '15USD')"),
+    information_policy: z.enum(["open", "redacted", "sandboxed"]).optional().describe("How to handle sensitive data. Defaults to 'redacted'."),
+}, async ({ skill, urgency, duration, context, max_price, information_policy }) => {
+    try {
+        const created = (await createRequest({
+            skill,
+            urgency,
+            duration,
+            context,
+            max_price,
+            information_policy,
+        }));
+        const result = await waitUntilComplete(created.request_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+});
+server.tool("patxin_status", "Check the status of an existing patxin request by its ID. Use this if you need to check on a request without waiting for completion.", {
+    request_id: z.string().describe("The request ID (e.g. 'req_abc123')"),
+}, async ({ request_id }) => {
+    try {
+        const data = await getRequestStatus(request_id);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+});
+server.tool("patxin_rate", "Rate a completed patxin request. Always rate interactions — it improves matching quality for future requests.", {
+    request_id: z.string().describe("The request ID to rate"),
+    score: z.number().int().min(1).max(5).describe("Rating from 1 (poor) to 5 (excellent)"),
+    comment: z.string().optional().describe("Optional feedback comment"),
+}, async ({ request_id, score, comment }) => {
+    try {
+        const data = await rateRequest(request_id, { score, comment });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.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/dist/ws.d.ts

@@ -0,0 +1,14 @@
+type RequestEvent = {
+    type: string;
+    request_id?: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+};
+/**
+ * Open a WebSocket to the patxin API and wait for a terminal status event
+ * for the given request ID.
+ *
+ * Resolves with the event data on terminal status, rejects on timeout or error.
+ */
+export declare function waitForCompletion(requestId: string, apiKey: string, baseUrl: string, timeoutMs?: number): Promise<RequestEvent>;
+export {};

package/dist/ws.js

@@ -0,0 +1,79 @@
+import WebSocket from "ws";
+const TERMINAL_STATUSES = new Set(["completed", "expired", "cancelled", "disputed"]);
+const PING_INTERVAL_MS = 30_000;
+/**
+ * Open a WebSocket to the patxin API and wait for a terminal status event
+ * for the given request ID.
+ *
+ * Resolves with the event data on terminal status, rejects on timeout or error.
+ */
+export function waitForCompletion(requestId, apiKey, baseUrl, timeoutMs = 600_000) {
+    return new Promise((resolve, reject) => {
+        const wsUrl = `${baseUrl.replace(/^http/, "ws")}/v1/ws?token=${encodeURIComponent(apiKey)}`;
+        let ws;
+        let pingTimer;
+        let timeoutTimer;
+        let settled = false;
+        function cleanup() {
+            settled = true;
+            clearInterval(pingTimer);
+            clearTimeout(timeoutTimer);
+            if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
+                ws.close();
+            }
+        }
+        try {
+            ws = new WebSocket(wsUrl);
+        }
+        catch (err) {
+            reject(new Error(`WebSocket connection failed: ${err.message}`));
+            return;
+        }
+        timeoutTimer = setTimeout(() => {
+            if (!settled) {
+                cleanup();
+                reject(new Error(`WebSocket wait timed out after ${timeoutMs / 1000}s for ${requestId}`));
+            }
+        }, timeoutMs);
+        ws.on("open", () => {
+            // Keepalive pings
+            pingTimer = setInterval(() => {
+                if (ws.readyState === WebSocket.OPEN) {
+                    ws.send(JSON.stringify({ type: "ping" }));
+                }
+            }, PING_INTERVAL_MS);
+        });
+        ws.on("message", (raw) => {
+            if (settled)
+                return;
+            try {
+                const event = JSON.parse(raw.toString());
+                // Only care about events for our request
+                if (event.request_id !== requestId)
+                    return;
+                // Extract status from event type (e.g. "request.completed" → "completed")
+                const status = event.type.replace("request.", "");
+                if (TERMINAL_STATUSES.has(status)) {
+                    cleanup();
+                    resolve(event);
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+        ws.on("error", (err) => {
+            if (!settled) {
+                cleanup();
+                reject(new Error(`WebSocket error: ${err.message}`));
+            }
+        });
+        ws.on("close", () => {
+            if (!settled) {
+                cleanup();
+                reject(new Error("WebSocket connection closed unexpectedly"));
+            }
+        });
+    });
+}
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@patxin/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for patxin.com — patch in a human for real-time cognitive micro-tasks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "patxin-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26",
+    "ws": "^8.19.0",
+    "zod": "^3.24"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4",
+    "typescript": "^5.7"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "patxin",
+    "human-in-the-loop",
+    "ai-agent",
+    "cognitive-tasks",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agraciag/patxin.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://patxin.com",
+  "author": "Alejandro Gracia García <alex@patxin.com>",
+  "engines": {
+    "node": ">=18"
+  }
+}