@pincerpay/mcp 0.1.0

package/dist/tools/validate-config.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { PincerPayConfigSchema, resolveChain } from "@pincerpay/core";
+const inputSchema = {
+    config: z.string().describe("JSON string of a PincerPayConfig object to validate. " +
+        'Must include apiKey, merchantAddress, and routes. Example: ' +
+        '\'{"apiKey":"pp_live_x","merchantAddress":"addr","routes":{"GET /api":{"price":"0.01"}}}\''),
+};
+export function registerValidateConfig(server) {
+    server.tool("validate-payment-config", "Validate a PincerPay merchant configuration object. " +
+        "Checks API key format, merchant address, route patterns, " +
+        "chain names, and USDC amounts. Returns validation results " +
+        "with specific error messages for each issue found.", inputSchema, async ({ config }) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(config);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            valid: false,
+                            errors: ["Invalid JSON: could not parse config string"],
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = PincerPayConfigSchema.safeParse(parsed);
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            valid: false,
+                            errors: result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        const warnings = [];
+        const data = result.data;
+        if (!data.apiKey.startsWith("pp_live_") &&
+            !data.apiKey.startsWith("pp_test_")) {
+            warnings.push("API key does not start with 'pp_live_' or 'pp_test_'. Verify it's correct.");
+        }
+        const validMethods = new Set([
+            "GET",
+            "POST",
+            "PUT",
+            "DELETE",
+            "PATCH",
+        ]);
+        const allChains = new Set();
+        for (const [pattern, route] of Object.entries(data.routes)) {
+            // Validate route pattern format: "METHOD /path"
+            const parts = pattern.split(" ");
+            if (parts.length < 2) {
+                warnings.push(`Route "${pattern}": invalid format. Must be "METHOD /path" (e.g., "GET /api/weather").`);
+            }
+            else {
+                const method = parts[0];
+                const path = parts.slice(1).join(" ");
+                if (!validMethods.has(method)) {
+                    warnings.push(`Route "${pattern}": "${method}" is not a standard HTTP method. Expected: GET, POST, PUT, DELETE, or PATCH.`);
+                }
+                if (!path.startsWith("/")) {
+                    warnings.push(`Route "${pattern}": path must start with "/" (e.g., "GET /api/weather").`);
+                }
+            }
+            const chains = route.chains ?? (route.chain ? [route.chain] : ["solana"]);
+            for (const chain of chains) {
+                allChains.add(chain);
+                if (!resolveChain(chain)) {
+                    warnings.push(`Route "${pattern}": unknown chain "${chain}".`);
+                }
+            }
+            const price = parseFloat(route.price);
+            if (price === 0) {
+                warnings.push(`Route "${pattern}": price is 0 — endpoint will effectively be free.`);
+            }
+            if (price > 100) {
+                warnings.push(`Route "${pattern}": price $${price} is unusually high for an API call.`);
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        valid: true,
+                        warnings: warnings.length > 0 ? warnings : undefined,
+                        routeCount: Object.keys(data.routes).length,
+                        chains: [...allChains],
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/tools/validate-config.js.map

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

package/dist/transport/http.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+interface HttpOptions {
+    port: number;
+}
+export declare function startHttpTransport(server: McpServer, options: HttpOptions): Promise<void>;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,iBAgDrB"}

package/dist/transport/http.js

@@ -0,0 +1,34 @@
+import { createServer } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+export async function startHttpTransport(server, options) {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // stateless
+    });
+    await server.connect(transport);
+    const httpServer = createServer(async (req, res) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id, Last-Event-ID, mcp-protocol-version");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (req.url === "/health" && req.method === "GET") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", service: "pincerpay-mcp" }));
+            return;
+        }
+        if (req.url === "/mcp") {
+            await transport.handleRequest(req, res);
+            return;
+        }
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not Found" }));
+    });
+    httpServer.listen(options.port, () => {
+        console.error(`PincerPay MCP server (HTTP) listening on port ${options.port}`);
+        console.error(`MCP endpoint: http://localhost:${options.port}/mcp`);
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAMnG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,OAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,SAAS,EAAE,YAAY;KAC5C,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjD,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CACX,8BAA8B,EAC9B,4BAA4B,CAC7B,CAAC;QACF,GAAG,CAAC,SAAS,CACX,8BAA8B,EAC9B,mEAAmE,CACpE,CAAC;QAEF,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAClD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;YACvB,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QACnC,OAAO,CAAC,KAAK,CACX,iDAAiD,OAAO,CAAC,IAAI,EAAE,CAChE,CAAC;QACF,OAAO,CAAC,KAAK,CACX,kCAAkC,OAAO,CAAC,IAAI,MAAM,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@pincerpay/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "MCP server for PincerPay — on-chain USDC payment gateway for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "pincerpay-mcp": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "homepage": "https://pincerpay.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ds1/pincerpay.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/ds1/pincerpay/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26",
+    "zod": "^3.24",
+    "@pincerpay/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "tsx": "^4",
+    "typescript": "^5.7",
+    "vitest": "^3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "pincerpay",
+    "x402",
+    "usdc",
+    "payments",
+    "ai-agents",
+    "solana",
+    "payment-gateway",
+    "stablecoin"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}