@pincerpay/mcp 0.1.0

package/dist/tools/check-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-transaction.js","sourceRoot":"","sources":["../../src/tools/check-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,qEAAqE,CACtE;CACJ,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,MAAyB;IAEzB,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,2EAA2E;QACzE,0FAA0F;QAC1F,+CAA+C,EACjD,WAAW,EACX,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACvD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uCAAuC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBAChG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/estimate-gas.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerEstimateGas(server: McpServer): void;
+//# sourceMappingURL=estimate-gas.d.ts.map

package/dist/tools/estimate-gas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate-gas.d.ts","sourceRoot":"","sources":["../../src/tools/estimate-gas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqDzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAqDpD"}

package/dist/tools/estimate-gas.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { CHAINS, resolveChain } from "@pincerpay/core";
+const inputSchema = {
+    chain: z.string().describe("Chain shorthand (e.g., 'solana', 'base', 'polygon', 'solana-devnet'). " +
+        `Valid values: ${Object.keys(CHAINS).join(", ")}`),
+    amount: z
+        .string()
+        .optional()
+        .describe("USDC amount in human-readable format (e.g., '0.01'). " +
+        "If provided, includes optimistic finality info."),
+};
+const GAS_ESTIMATES = {
+    solana: {
+        token: "SOL",
+        estimateUsd: "~$0.00025",
+        note: "Priority fee ~5000 microlamports. With Kora, gas is paid in USDC instead of SOL.",
+    },
+    "solana-devnet": {
+        token: "SOL",
+        estimateUsd: "~$0.00025",
+        note: "Free devnet SOL from faucet.solana.com.",
+    },
+    base: {
+        token: "ETH",
+        estimateUsd: "~$0.001-0.01",
+        note: "L2 gas typically <$0.01. EIP-1559 base + priority fee.",
+    },
+    "base-sepolia": {
+        token: "ETH",
+        estimateUsd: "~$0.001",
+        note: "Free testnet ETH from Coinbase faucet.",
+    },
+    polygon: {
+        token: "MATIC",
+        estimateUsd: "~$0.001-0.005",
+        note: "Low gas costs, EIP-1559.",
+    },
+    "polygon-amoy": {
+        token: "MATIC",
+        estimateUsd: "~$0.001",
+        note: "Free testnet MATIC from faucet.",
+    },
+};
+export function registerEstimateGas(server) {
+    server.tool("estimate-gas-cost", "Estimate the gas/transaction fee for a USDC payment on a given chain. " +
+        "Returns the native gas token, estimated USD cost, and notes about " +
+        "Kora gasless transactions (Solana) or L2 gas optimization.", inputSchema, async ({ chain, amount }) => {
+        const chainConfig = resolveChain(chain);
+        if (!chainConfig) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown chain: "${chain}". Valid chains: ${Object.keys(CHAINS).join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const estimate = GAS_ESTIMATES[chain] ?? {
+            token: chainConfig.namespace === "solana" ? "SOL" : "ETH",
+            estimateUsd: "unknown",
+            note: "No gas estimate available for this chain.",
+        };
+        const parsedAmount = amount ? parseFloat(amount) : undefined;
+        const isOptimistic = parsedAmount !== undefined ? parsedAmount < 1.0 : undefined;
+        const result = {
+            chain: chainConfig.shorthand,
+            name: chainConfig.name,
+            gasToken: estimate.token,
+            estimatedGasCostUsd: estimate.estimateUsd,
+            note: estimate.note,
+            ...(isOptimistic !== undefined && {
+                optimisticFinality: isOptimistic,
+                optimisticNote: isOptimistic
+                    ? "Sub-$1 payments use optimistic finality (~200ms) — resource delivered before block confirmation."
+                    : "Payment will wait for full block confirmation before resource delivery.",
+            }),
+            blockTimeMs: chainConfig.blockTimeMs,
+        };
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=estimate-gas.js.map

package/dist/tools/estimate-gas.js.map

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

package/dist/tools/generate-ucp.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGenerateUcp(server: McpServer): void;
+//# sourceMappingURL=generate-ucp.d.ts.map

package/dist/tools/generate-ucp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-ucp.d.ts","sourceRoot":"","sources":["../../src/tools/generate-ucp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAoFpD"}

package/dist/tools/generate-ucp.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { resolveChain, CHAINS } from "@pincerpay/core";
+const inputSchema = {
+    merchantName: z.string().describe("Business or project name."),
+    merchantUrl: z
+        .string()
+        .url()
+        .describe("Base URL of the merchant API (e.g., 'https://api.example.com')."),
+    walletAddress: z
+        .string()
+        .describe("Merchant's USDC wallet address."),
+    chains: z
+        .array(z.string())
+        .default(["solana"])
+        .describe(`Supported chain shorthands. Valid: ${Object.keys(CHAINS).join(", ")}`),
+    endpoints: z
+        .array(z.object({
+        path: z.string().describe("API path, e.g. '/api/weather'."),
+        method: z
+            .enum(["GET", "POST", "PUT", "DELETE"])
+            .default("GET"),
+        price: z.string().describe("USDC price, e.g. '0.01'."),
+        description: z.string().describe("What this endpoint provides."),
+    }))
+        .min(1)
+        .describe("Paywalled endpoints to advertise."),
+};
+export function registerGenerateUcp(server) {
+    server.tool("generate-ucp-manifest", "Generate a /.well-known/ucp JSON manifest for agent-readable commerce discovery. " +
+        "UCP (Universal Commerce Protocol) lets AI agents discover your API's " +
+        "payment requirements, supported chains, and endpoint pricing. " +
+        "Place the output at /.well-known/ucp on your domain.", inputSchema, async ({ merchantName, merchantUrl, walletAddress, chains, endpoints }) => {
+        const errors = [];
+        const chainConfigs = chains.map((c) => {
+            const config = resolveChain(c);
+            if (!config) {
+                errors.push(`Unknown chain: "${c}"`);
+                return null;
+            }
+            return {
+                network: config.caip2Id,
+                token: "USDC",
+                tokenAddress: config.usdcAddress,
+            };
+        });
+        if (errors.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: errors.join("\n") +
+                            `\nValid chains: ${Object.keys(CHAINS).join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const manifest = {
+            version: "1.0",
+            merchant: {
+                name: merchantName,
+                url: merchantUrl,
+            },
+            payment: {
+                handler: "pincerpay",
+                facilitator: "https://facilitator.pincerpay.com",
+                chains: chainConfigs,
+                payTo: walletAddress,
+            },
+            endpoints: endpoints.map((ep) => ({
+                path: ep.path,
+                method: ep.method,
+                price: { amount: ep.price, currency: "USDC" },
+                description: ep.description,
+            })),
+        };
+        const manifestJson = JSON.stringify(manifest, null, 2);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## UCP Manifest\n\n` +
+                        `Serve this JSON at \`${merchantUrl}/.well-known/ucp\`:\n\n` +
+                        `\`\`\`json\n${manifestJson}\n\`\`\`\n\n` +
+                        `### How to Serve\n\n` +
+                        `**Express:**\n` +
+                        `\`\`\`typescript\n` +
+                        `app.get("/.well-known/ucp", (req, res) => {\n` +
+                        `  res.json(${JSON.stringify(manifest)});\n` +
+                        `});\n` +
+                        `\`\`\`\n\n` +
+                        `**Hono:**\n` +
+                        `\`\`\`typescript\n` +
+                        `app.get("/.well-known/ucp", (c) => c.json(${JSON.stringify(manifest)}));\n` +
+                        `\`\`\`\n\n` +
+                        `AI agents discover this manifest to learn what your API offers,\n` +
+                        `which chains you accept, and how much each endpoint costs.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=generate-ucp.js.map

package/dist/tools/generate-ucp.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FacilitatorClient } from "../client.js";
+export declare function registerTools(server: McpServer, client: FacilitatorClient): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAStD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAWzE"}

package/dist/tools/index.js

@@ -0,0 +1,19 @@
+import { registerListChains } from "./list-chains.js";
+import { registerEstimateGas } from "./estimate-gas.js";
+import { registerValidateConfig } from "./validate-config.js";
+import { registerCheckTransaction } from "./check-transaction.js";
+import { registerScaffoldMiddleware } from "./scaffold-middleware.js";
+import { registerScaffoldAgent } from "./scaffold-agent.js";
+import { registerGenerateUcp } from "./generate-ucp.js";
+export function registerTools(server, client) {
+    // Operations tools (facilitator interaction)
+    registerListChains(server, client);
+    registerCheckTransaction(server, client);
+    registerEstimateGas(server);
+    // Developer tools (scaffolding + validation)
+    registerValidateConfig(server);
+    registerScaffoldMiddleware(server);
+    registerScaffoldAgent(server);
+    registerGenerateUcp(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAyB;IACxE,6CAA6C;IAC7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,6CAA6C;IAC7C,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/list-chains.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FacilitatorClient } from "../client.js";
+export declare function registerListChains(server: McpServer, client: FacilitatorClient): void;
+//# sourceMappingURL=list-chains.d.ts.map

package/dist/tools/list-chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-chains.d.ts","sourceRoot":"","sources":["../../src/tools/list-chains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAatD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,QAoD1B"}

package/dist/tools/list-chains.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { CHAINS } from "@pincerpay/core";
+const inputSchema = {
+    source: z
+        .enum(["local", "facilitator"])
+        .default("local")
+        .describe("'local' returns all known PincerPay chain configs. " +
+        "'facilitator' queries the live facilitator for currently registered schemes."),
+};
+export function registerListChains(server, client) {
+    server.tool("list-supported-chains", "Returns supported blockchain networks and their USDC configurations. " +
+        "Includes Solana (primary), Base, and Polygon with mainnet/testnet variants. " +
+        "Shows chain shorthand, CAIP-2 ID, USDC contract address, and block time.", inputSchema, async ({ source }) => {
+        if (source === "facilitator") {
+            try {
+                const result = await client.getSupported();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to reach facilitator: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        const chains = Object.values(CHAINS).map((c) => ({
+            shorthand: c.shorthand,
+            name: c.name,
+            caip2Id: c.caip2Id,
+            namespace: c.namespace,
+            usdcAddress: c.usdcAddress,
+            usdcDecimals: c.usdcDecimals,
+            testnet: c.testnet,
+            explorerUrl: c.explorerUrl,
+            blockTimeMs: c.blockTimeMs,
+        }));
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(chains, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=list-chains.js.map

package/dist/tools/list-chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-chains.js","sourceRoot":"","sources":["../../src/tools/list-chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;SAC9B,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CACP,qDAAqD;QACnD,8EAA8E,CACjF;CACJ,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,MAAyB;IAEzB,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,uEAAuE;QACrE,8EAA8E;QAC9E,0EAA0E,EAC5E,WAAW,EACX,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC3C,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;yBACzF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACjE;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/scaffold-agent.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerScaffoldAgent(server: McpServer): void;
+//# sourceMappingURL=scaffold-agent.d.ts.map

package/dist/tools/scaffold-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-agent.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA8EtD"}

package/dist/tools/scaffold-agent.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+const inputSchema = {
+    chain: z
+        .enum([
+        "solana",
+        "base",
+        "polygon",
+        "solana-devnet",
+        "base-sepolia",
+        "polygon-amoy",
+    ])
+        .default("solana")
+        .describe("Primary chain the agent will use."),
+    maxPerTransaction: z
+        .string()
+        .optional()
+        .describe("Max USDC per transaction in base units (6 decimals). E.g., '100000' = $0.10, '1000000' = $1.00."),
+    maxPerDay: z
+        .string()
+        .optional()
+        .describe("Max USDC per day in base units (6 decimals). E.g., '5000000' = $5.00, '10000000' = $10.00."),
+    typescript: z
+        .boolean()
+        .default(true)
+        .describe("Generate TypeScript (true) or JavaScript (false)."),
+};
+export function registerScaffoldAgent(server) {
+    server.tool("scaffold-agent-client", "Generate agent-side code that automatically handles x402 USDC payments. " +
+        "Produces a PincerPayAgent setup with wallet configuration and " +
+        "spending policies. The agent's fetch() is a drop-in replacement " +
+        "for standard fetch that handles 402 challenges automatically.", inputSchema, async ({ chain, maxPerTransaction, maxPerDay, typescript }) => {
+        const isSolana = chain.startsWith("solana");
+        const keyVar = isSolana ? "AGENT_SOLANA_KEY" : "AGENT_EVM_KEY";
+        const keyProp = isSolana ? "solanaPrivateKey" : "evmPrivateKey";
+        const bang = typescript ? "!" : "";
+        let policiesBlock = "";
+        if (maxPerTransaction || maxPerDay) {
+            const entries = [];
+            if (maxPerTransaction)
+                entries.push(`      maxPerTransaction: "${maxPerTransaction}"`);
+            if (maxPerDay)
+                entries.push(`      maxPerDay: "${maxPerDay}"`);
+            policiesBlock =
+                `\n  // Spending policies use base units (6 decimals): 1 USDC = "1000000", $0.10 = "100000"` +
+                    `\n  policies: [\n    {\n${entries.join(",\n")},\n    },\n  ],`;
+        }
+        const code = `import { PincerPayAgent } from "@pincerpay/agent";
+
+const agent = await PincerPayAgent.create({
+  chains: ["${chain}"],
+  ${keyProp}: process.env.${keyVar}${bang},${policiesBlock}
+});
+
+// Use agent.fetch() as a drop-in replacement for fetch.
+// It automatically handles HTTP 402 challenges by signing USDC payments.
+const response = await agent.fetch("https://your-api.example.com/endpoint");
+const data = await response.json();
+console.log(data);`;
+        const envValue = isSolana
+            ? "your_base58_solana_private_key"
+            : "0xYourEvmPrivateKey";
+        const lang = typescript ? "typescript" : "javascript";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## Install\n\n\`\`\`bash\nnpm install @pincerpay/agent\n\`\`\`\n\n` +
+                        `## Code\n\n\`\`\`${lang}\n${code}\n\`\`\`\n\n` +
+                        `## Environment Variables\n\n\`\`\`\n${keyVar}=${envValue}\n\`\`\`\n\n` +
+                        `## How It Works\n\n` +
+                        `1. Agent calls a paywalled API endpoint\n` +
+                        `2. Server responds with HTTP 402 + x402 payment challenge\n` +
+                        `3. Agent SDK automatically signs a USDC transfer\n` +
+                        `4. PincerPay facilitator verifies + broadcasts the transaction\n` +
+                        `5. Server delivers the protected resource\n\n` +
+                        `Spending policies prevent runaway spending — the agent will reject\n` +
+                        `payments that exceed the configured limits.\n\n` +
+                        `## USDC Base Units Reference\n\n` +
+                        `| Human Amount | Base Units |\n` +
+                        `|-------------|------------|\n` +
+                        `| $0.01 | \`"10000"\` |\n` +
+                        `| $0.10 | \`"100000"\` |\n` +
+                        `| $1.00 | \`"1000000"\` |\n` +
+                        `| $10.00 | \`"10000000"\` |\n\n` +
+                        `**Important:** Route \`price\` uses human-readable amounts (e.g., \`"0.01"\`), ` +
+                        `but spending \`policies\` use base units (6 decimals). ` +
+                        `Multiply the human amount by 1,000,000 to get base units.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=scaffold-agent.js.map

package/dist/tools/scaffold-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-agent.js","sourceRoot":"","sources":["../../src/tools/scaffold-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC;SACL,IAAI,CAAC;QACJ,QAAQ;QACR,MAAM;QACN,SAAS;QACT,eAAe;QACf,cAAc;QACd,cAAc;KACf,CAAC;SACD,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,mCAAmC,CAAC;IAChD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iGAAiG,CAClG;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;IACH,UAAU,EAAE,CAAC;SACV,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,0EAA0E;QACxE,gEAAgE;QAChE,kEAAkE;QAClE,+DAA+D,EACjE,WAAW,EACX,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;QAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;QAChE,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnC,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAAC;YACnC,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,iBAAiB;gBACnB,OAAO,CAAC,IAAI,CACV,6BAA6B,iBAAiB,GAAG,CAClD,CAAC;YACJ,IAAI,SAAS;gBACX,OAAO,CAAC,IAAI,CAAC,qBAAqB,SAAS,GAAG,CAAC,CAAC;YAClD,aAAa;gBACX,4FAA4F;oBAC5F,2BAA2B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,GAAG;;;cAGL,KAAK;IACf,OAAO,iBAAiB,MAAM,GAAG,IAAI,IAAI,aAAa;;;;;;;mBAOvC,CAAC;QAEd,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,qBAAqB,CAAC;QAE1B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,oEAAoE;wBACpE,oBAAoB,IAAI,KAAK,IAAI,cAAc;wBAC/C,uCAAuC,MAAM,IAAI,QAAQ,cAAc;wBACvE,qBAAqB;wBACrB,2CAA2C;wBAC3C,6DAA6D;wBAC7D,oDAAoD;wBACpD,kEAAkE;wBAClE,+CAA+C;wBAC/C,sEAAsE;wBACtE,iDAAiD;wBACjD,kCAAkC;wBAClC,iCAAiC;wBACjC,gCAAgC;wBAChC,2BAA2B;wBAC3B,4BAA4B;wBAC5B,6BAA6B;wBAC7B,iCAAiC;wBACjC,iFAAiF;wBACjF,yDAAyD;wBACzD,2DAA2D;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/scaffold-middleware.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerScaffoldMiddleware(server: McpServer): void;
+//# sourceMappingURL=scaffold-middleware.d.ts.map

package/dist/tools/scaffold-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-middleware.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold-middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqIzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QA4D3D"}

package/dist/tools/scaffold-middleware.js

@@ -0,0 +1,160 @@
+import { z } from "zod";
+const inputSchema = {
+    framework: z
+        .enum(["express", "hono", "nextjs"])
+        .describe("Web framework to generate middleware for. " +
+        "Use 'nextjs' for Next.js App Router (generates Hono adapter in catch-all route)."),
+    routes: z
+        .array(z.object({
+        pattern: z
+            .string()
+            .describe("Route pattern, e.g. 'GET /api/weather'."),
+        price: z.string().describe("USDC price, e.g. '0.01'."),
+        chain: z.string().default("solana").describe("Chain shorthand."),
+        description: z.string().optional(),
+    }))
+        .min(1)
+        .describe("Paywalled routes to configure."),
+    merchantAddress: z
+        .string()
+        .optional()
+        .describe("Merchant wallet address (placeholder used if omitted)."),
+    typescript: z
+        .boolean()
+        .default(true)
+        .describe("Generate TypeScript (true) or JavaScript (false)."),
+};
+function generateExpressCode(addr, routesBlock, ts) {
+    const bang = ts ? "!" : "";
+    return `import express from "express";
+import { pincerpay } from "@pincerpay/merchant/express";
+
+const app = express();
+
+app.use(
+  pincerpay({
+    apiKey: process.env.PINCERPAY_API_KEY${bang},
+    merchantAddress: "${addr}",
+    routes: {
+${routesBlock}
+    },
+  })
+);
+
+// Your route handlers below — any route matching the patterns
+// above will require x402 USDC payment before the handler runs.
+app.get("/api/example", (req, res) => {
+  res.json({ message: "Paid content!" });
+});
+
+const port = process.env.PORT ?? 3000;
+app.listen(port, () => {
+  console.log(\`Server running at http://localhost:\${port}\`);
+});`;
+}
+function generateHonoCode(addr, routesBlock, ts) {
+    const bang = ts ? "!" : "";
+    return `import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+const app = new Hono();
+
+app.use(
+  "*",
+  pincerpayHono({
+    apiKey: process.env.PINCERPAY_API_KEY${bang},
+    merchantAddress: "${addr}",
+    routes: {
+${routesBlock}
+    },
+  })
+);
+
+// Your route handlers below — any route matching the patterns
+// above will require x402 USDC payment before the handler runs.
+app.get("/api/example", (c) => {
+  return c.json({ message: "Paid content!" });
+});
+
+serve({ fetch: app.fetch, port: Number(process.env.PORT ?? 3000) });`;
+}
+function generateNextjsCode(addr, routesBlock, ts) {
+    const bang = ts ? "!" : "";
+    return `// app/api/[...route]/route.ts
+import { Hono } from "hono";
+import { handle } from "hono/vercel";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+// basePath must match the catch-all route location
+const app = new Hono().basePath("/api");
+
+app.use(
+  "*",
+  pincerpayHono({
+    apiKey: process.env.PINCERPAY_API_KEY${bang},
+    merchantAddress: "${addr}",
+    routes: {
+${routesBlock}
+    },
+  })
+);
+
+// Route handlers — paths are relative to basePath ("/api")
+app.get("/example", (c) => {
+  return c.json({ message: "Paid content!" });
+});
+
+export const GET = handle(app);
+export const POST = handle(app);
+export const PUT = handle(app);
+export const DELETE = handle(app);`;
+}
+export function registerScaffoldMiddleware(server) {
+    server.tool("scaffold-x402-middleware", "Generate Express, Hono, or Next.js middleware code that adds x402 USDC payment walls to API routes. " +
+        "Produces a complete, copy-paste-ready code snippet with PincerPay SDK setup, " +
+        "route configuration, and environment variable usage. " +
+        "Next.js uses a Hono adapter in a catch-all App Router route. " +
+        "Supports Solana (primary), Base, and Polygon chains.", inputSchema, async ({ framework, routes, merchantAddress, typescript }) => {
+        const addr = merchantAddress ?? "YOUR_WALLET_ADDRESS";
+        const routesBlock = routes
+            .map((r) => {
+            const desc = r.description
+                ? `, description: "${r.description}"`
+                : "";
+            return `      "${r.pattern}": { price: "${r.price}", chain: "${r.chain}"${desc} }`;
+        })
+            .join(",\n");
+        const code = framework === "express"
+            ? generateExpressCode(addr, routesBlock, typescript)
+            : framework === "nextjs"
+                ? generateNextjsCode(addr, routesBlock, typescript)
+                : generateHonoCode(addr, routesBlock, typescript);
+        const installCmd = framework === "express"
+            ? "npm install @pincerpay/merchant express"
+            : framework === "nextjs"
+                ? "npm install @pincerpay/merchant hono"
+                : "npm install @pincerpay/merchant hono @hono/node-server";
+        const lang = typescript ? "typescript" : "javascript";
+        const nextjsNote = framework === "nextjs"
+            ? `\n## Next.js Notes\n\n` +
+                `- Place this file at \`app/api/[...route]/route.ts\`\n` +
+                `- The \`basePath("/api")\` must match the catch-all route location\n` +
+                `- Route handlers use paths relative to basePath (e.g., \`/weather\` serves \`/api/weather\`)\n` +
+                `- Export each HTTP method you need (GET, POST, PUT, DELETE)\n\n`
+            : "";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## Install\n\n\`\`\`bash\n${installCmd}\n\`\`\`\n\n` +
+                        `## Code\n\n\`\`\`${lang}\n${code}\n\`\`\`\n\n` +
+                        nextjsNote +
+                        `## Environment Variables\n\n\`\`\`\nPINCERPAY_API_KEY=pp_live_your_key_here\n\`\`\`\n\n` +
+                        `Get your API key from https://pincerpay.com/dashboard/settings`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=scaffold-middleware.js.map

package/dist/tools/scaffold-middleware.js.map

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

package/dist/tools/validate-config.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerValidateConfig(server: McpServer): void;
+//# sourceMappingURL=validate-config.d.ts.map

package/dist/tools/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../src/tools/validate-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAmIvD"}