@pincerpay/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PincerPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @pincerpay/mcp
+
+MCP server for [PincerPay](https://pincerpay.com) — on-chain USDC payment gateway for AI agents using the [x402 protocol](https://x402.org).
+
+Works with Claude, Cursor, Windsurf, GitHub Copilot, Replit, and any MCP-compatible client.
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add pincerpay -- npx -y @pincerpay/mcp
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pincerpay": {
+      "command": "npx",
+      "args": ["-y", "@pincerpay/mcp"],
+      "env": {
+        "PINCERPAY_API_KEY": "pp_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Settings > Tools & MCP > Add Server:
+
+```json
+{
+  "mcpServers": {
+    "pincerpay": {
+      "command": "npx",
+      "args": ["-y", "@pincerpay/mcp"],
+      "env": {
+        "PINCERPAY_API_KEY": "pp_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add via the Cascade MCP panel or `mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "pincerpay": {
+      "command": "npx",
+      "args": ["-y", "@pincerpay/mcp"],
+      "env": {
+        "PINCERPAY_API_KEY": "pp_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Remote (Streamable HTTP)
+
+```bash
+npx @pincerpay/mcp --transport=http --port=3100 --api-key=pp_live_your_key
+```
+
+## Tools
+
+| Tool | Description | Auth Required |
+|------|-------------|:---:|
+| `list-supported-chains` | List supported chains and USDC configs | No |
+| `estimate-gas-cost` | Estimate gas fees per chain | No |
+| `validate-payment-config` | Validate merchant config with route pattern checks | No |
+| `scaffold-x402-middleware` | Generate Express/Hono/Next.js middleware | No |
+| `scaffold-agent-client` | Generate agent fetch wrapper with spending policies | No |
+| `generate-ucp-manifest` | Create commerce discovery manifest | No |
+| `check-transaction-status` | Query transaction status | Yes |
+
+## Resources
+
+| Resource | URI | Description |
+|----------|-----|-------------|
+| Chain configs | `chain://{shorthand}` | Config for any of the 6 supported chains |
+| OpenAPI spec | `pincerpay://openapi` | Live facilitator OpenAPI spec |
+| Documentation | `docs://pincerpay/{topic}` | Embedded docs (5 topics — see below) |
+
+### Doc Topics
+
+| Topic | URI | Content |
+|-------|-----|---------|
+| Getting Started | `docs://pincerpay/getting-started` | Prerequisites, Choose Your Path (merchant vs agent), devnet/mainnet, key concepts |
+| Merchant Guide | `docs://pincerpay/merchant` | Express, Hono, and Next.js middleware setup, multi-chain routes, config reference |
+| Agent Guide | `docs://pincerpay/agent` | Agent setup, spending policies (base units), runtime management, properties |
+| Troubleshooting | `docs://pincerpay/troubleshooting` | Common issues table, devnet funding, debugging tips |
+| Reference | `docs://pincerpay/reference` | Chain shorthands, USDC amounts, package exports, API methods |
+
+## Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `get-started` | Interactive onboarding — determines your role and guides you to the right flow |
+| `integrate-merchant` | Step-by-step merchant SDK integration (Express, Hono, or Next.js) |
+| `integrate-agent` | Agent SDK setup with spending policies and gas estimates |
+| `debug-transaction` | Transaction troubleshooting by hash/signature |
+
+## CLI Options
+
+```
+--api-key=KEY           PincerPay API key (or PINCERPAY_API_KEY env var)
+--facilitator-url=URL   Custom facilitator URL (or PINCERPAY_FACILITATOR_URL)
+--transport=stdio|http  Transport type (default: stdio)
+--port=PORT             HTTP port (default: 3100, only with --transport=http)
+```
+
+## API Key
+
+Get your API key from [pincerpay.com/dashboard/settings](https://pincerpay.com/dashboard/settings).
+
+Developer tools (scaffolding, gas estimates, chain listing, config validation) work without an API key. Operations tools (transaction status) require one.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createPincerPayMcpServer } from "./server.js";
+const args = process.argv.slice(2);
+function getArg(name) {
+    const prefix = `--${name}=`;
+    const found = args.find((a) => a.startsWith(prefix));
+    return found?.slice(prefix.length);
+}
+const apiKey = getArg("api-key") ?? process.env.PINCERPAY_API_KEY;
+const facilitatorUrl = getArg("facilitator-url") ?? process.env.PINCERPAY_FACILITATOR_URL;
+const transport = getArg("transport") ?? "stdio";
+const server = createPincerPayMcpServer({
+    apiKey,
+    facilitatorUrl,
+});
+if (transport === "stdio") {
+    const stdioTransport = new StdioServerTransport();
+    await server.connect(stdioTransport);
+}
+else if (transport === "http") {
+    const { startHttpTransport } = await import("./transport/http.js");
+    const port = parseInt(getArg("port") ?? process.env.PORT ?? "3100", 10);
+    await startHttpTransport(server, { port });
+}
+else {
+    console.error(`Unknown transport: "${transport}". Use "stdio" or "http".`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,OAAO,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAClE,MAAM,cAAc,GAClB,MAAM,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;AACrE,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC;AAEjD,MAAM,MAAM,GAAG,wBAAwB,CAAC;IACtC,MAAM;IACN,cAAc;CACf,CAAC,CAAC;AAEH,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;IAC1B,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAClD,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;KAAM,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,kBAAkB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,2BAA2B,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+export interface FacilitatorClientConfig {
+    /** PincerPay API key (pp_live_... or pp_test_...) */
+    apiKey?: string;
+    /** Facilitator URL (defaults to https://facilitator.pincerpay.com) */
+    facilitatorUrl?: string;
+}
+/**
+ * Lightweight HTTP client for the PincerPay facilitator API.
+ * Follows the same pattern as PincerPayClient in @pincerpay/merchant
+ * but without requiring merchantAddress — designed for MCP server use.
+ */
+export declare class FacilitatorClient {
+    readonly facilitatorUrl: string;
+    readonly apiKey?: string;
+    constructor(config: FacilitatorClientConfig);
+    get isAuthenticated(): boolean;
+    /**
+     * Throws if no API key is configured. Call before operations
+     * that require authentication.
+     */
+    requireAuth(): void;
+    request<T>(path: string, body?: unknown): Promise<T>;
+    getSupported(): Promise<unknown>;
+    getStatus(txHash: string): Promise<unknown>;
+    getHealth(): Promise<unknown>;
+    getOpenApiSpec(): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,uBAAuB;IAK3C,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACH,WAAW,IAAI,IAAI;IASb,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBpD,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7B,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAGzC"}

package/dist/client.js

@@ -0,0 +1,60 @@
+import { DEFAULT_FACILITATOR_URL, FACILITATOR_ROUTES, API_KEY_HEADER, } from "@pincerpay/core";
+/**
+ * Lightweight HTTP client for the PincerPay facilitator API.
+ * Follows the same pattern as PincerPayClient in @pincerpay/merchant
+ * but without requiring merchantAddress — designed for MCP server use.
+ */
+export class FacilitatorClient {
+    facilitatorUrl;
+    apiKey;
+    constructor(config) {
+        this.facilitatorUrl = config.facilitatorUrl ?? DEFAULT_FACILITATOR_URL;
+        this.apiKey = config.apiKey;
+    }
+    get isAuthenticated() {
+        return !!this.apiKey;
+    }
+    /**
+     * Throws if no API key is configured. Call before operations
+     * that require authentication.
+     */
+    requireAuth() {
+        if (!this.apiKey) {
+            throw new Error("This operation requires a PincerPay API key. " +
+                "Set PINCERPAY_API_KEY environment variable or pass --api-key to the MCP server.");
+        }
+    }
+    async request(path, body) {
+        const url = `${this.facilitatorUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers[API_KEY_HEADER] = this.apiKey;
+        }
+        const res = await fetch(url, {
+            method: body ? "POST" : "GET",
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "Unknown error");
+            throw new Error(`Facilitator ${path} failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    async getSupported() {
+        return this.request(FACILITATOR_ROUTES.supported);
+    }
+    async getStatus(txHash) {
+        this.requireAuth();
+        return this.request(`${FACILITATOR_ROUTES.status}/${txHash}`);
+    }
+    async getHealth() {
+        return this.request(FACILITATOR_ROUTES.health);
+    }
+    async getOpenApiSpec() {
+        return this.request("/openapi.json");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AASzB;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACnB,cAAc,CAAS;IACvB,MAAM,CAAU;IAEzB,YAAY,MAA+B;QACzC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uBAAuB,CAAC;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,+CAA+C;gBAC7C,iFAAiF,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,IAAc;QAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;YAC7B,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,YAAY,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createPincerPayMcpServer } from "./server.js";
+export type { PincerPayMcpConfig } from "./server.js";
+export { FacilitatorClient } from "./client.js";
+export type { FacilitatorClientConfig } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createPincerPayMcpServer } from "./server.js";
+export { FacilitatorClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/prompts/debug-transaction.d.ts

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

package/dist/prompts/debug-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-transaction.d.ts","sourceRoot":"","sources":["../../src/prompts/debug-transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAiCpD"}

package/dist/prompts/debug-transaction.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export function registerDebugPrompt(server) {
+    server.prompt("debug-transaction", "Investigate a PincerPay transaction's status and diagnose issues. " +
+        "Fetches transaction details from the facilitator and provides analysis.", {
+        txHash: z
+            .string()
+            .describe("Transaction hash (EVM) or Solana signature."),
+    }, ({ txHash }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Debug this PincerPay transaction: ${txHash}
+
+Please:
+1. Use check-transaction-status to fetch the transaction details
+2. Analyze the status (pending/mempool/optimistic/confirmed/failed)
+3. If failed, explain common failure reasons:
+   - Insufficient USDC balance
+   - Wrong chain/network
+   - Expired transaction timeout
+   - RPC connectivity issues
+4. Provide the block explorer link for the transaction
+5. Suggest next steps to resolve any issues`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=debug-transaction.js.map

package/dist/prompts/debug-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-transaction.js","sourceRoot":"","sources":["../../src/prompts/debug-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,MAAM,CACX,mBAAmB,EACnB,oEAAoE;QAClE,yEAAyE,EAC3E;QACE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,CAAC,6CAA6C,CAAC;KAC3D,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,qCAAqC,MAAM;;;;;;;;;;;4CAWjB;iBACjC;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/get-started.d.ts

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

package/dist/prompts/get-started.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-started.d.ts","sourceRoot":"","sources":["../../src/prompts/get-started.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QA2CzD"}

package/dist/prompts/get-started.js

@@ -0,0 +1,40 @@
+export function registerGetStartedPrompt(server) {
+    server.prompt("get-started", "Interactive onboarding for PincerPay. Determines whether you're a merchant " +
+        "(accept USDC payments) or agent developer (make USDC payments) and guides " +
+        "you through the appropriate integration flow.", {}, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I want to integrate PincerPay into my project.
+
+Please help me get started by determining which integration I need:
+
+1. **Merchant** — I have an API and want to accept USDC payments from AI agents.
+   → Ask me about my web framework (Express, Hono, or Next.js), which endpoints to paywall, and my wallet address.
+   → Then use the integrate-merchant workflow: scaffold-x402-middleware → validate-payment-config → generate-ucp-manifest.
+
+2. **Agent Developer** — I'm building an AI agent that needs to pay for API access with USDC.
+   → Ask me about my preferred chain and spending budget.
+   → Then use the integrate-agent workflow: scaffold-agent-client → estimate-gas-cost.
+
+3. **Both** — I need both merchant and agent integration.
+   → Walk me through merchant first, then agent.
+
+4. **Troubleshooting** — I already have PincerPay integrated and need help debugging.
+   → Ask for my transaction hash and use debug-transaction.
+
+Please ask me which of these describes my situation, then guide me through the appropriate flow step by step.
+
+Key things to keep in mind throughout:
+- My project needs "type": "module" in package.json (PincerPay SDKs are ESM-only)
+- .env files must be in .gitignore — never commit API keys or private keys
+- For development, use devnet chains (solana-devnet, base-sepolia)
+- Route prices use human-readable USDC (e.g., "0.01"), but agent spending policies use base units (e.g., "10000")`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=get-started.js.map

package/dist/prompts/get-started.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-started.js","sourceRoot":"","sources":["../../src/prompts/get-started.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,MAAM,CACX,aAAa,EACb,6EAA6E;QAC3E,4EAA4E;QAC5E,+CAA+C,EACjD,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;kHAwBgG;iBACvG;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAKhD"}

package/dist/prompts/index.js

@@ -0,0 +1,11 @@
+import { registerGetStartedPrompt } from "./get-started.js";
+import { registerMerchantPrompt } from "./integrate-merchant.js";
+import { registerAgentPrompt } from "./integrate-agent.js";
+import { registerDebugPrompt } from "./debug-transaction.js";
+export function registerPrompts(server) {
+    registerGetStartedPrompt(server);
+    registerMerchantPrompt(server);
+    registerAgentPrompt(server);
+    registerDebugPrompt(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/prompts/integrate-agent.d.ts

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

package/dist/prompts/integrate-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-agent.d.ts","sourceRoot":"","sources":["../../src/prompts/integrate-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA8CpD"}

package/dist/prompts/integrate-agent.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+export function registerAgentPrompt(server) {
+    server.prompt("integrate-agent", "Guide for building an AI agent that automatically pays for API access with USDC. " +
+        "Covers wallet setup, spending policies, and the x402 payment flow.", {
+        chain: z
+            .string()
+            .default("solana")
+            .describe("Primary chain."),
+        maxBudget: z
+            .string()
+            .optional()
+            .describe("Daily USDC budget in human-readable format, e.g. '5.00'. " +
+            "Will be converted to base units (× 1,000,000) for spending policies."),
+    }, ({ chain, maxBudget }) => {
+        const budgetLine = maxBudget
+            ? `Daily budget: $${maxBudget} USDC (= ${Math.round(Number(maxBudget) * 1_000_000)} base units for maxPerDay)`
+            : "No budget limit set";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `I want to build an AI agent that can pay for APIs using USDC via PincerPay.
+
+Chain: ${chain}
+${budgetLine}
+
+Please:
+1. Use scaffold-agent-client to generate the agent code${maxBudget ? ` — pass maxPerDay as "${Math.round(Number(maxBudget) * 1_000_000)}" (base units, NOT "${maxBudget}")` : ""}
+2. Use estimate-gas-cost to explain the gas costs on ${chain}
+3. Explain how the x402 payment flow works (402 challenge -> sign -> settle)
+4. Show how to set up wallet key management securely
+5. Explain spending policies — IMPORTANT: policies use base units (6 decimals), NOT human-readable amounts. $1.00 = "1000000", $0.10 = "100000". Using "0.10" will cause BigInt() to throw at runtime.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=integrate-agent.js.map

package/dist/prompts/integrate-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-agent.js","sourceRoot":"","sources":["../../src/prompts/integrate-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,mFAAmF;QACjF,oEAAoE,EACtE;QACE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,OAAO,CAAC,QAAQ,CAAC;aACjB,QAAQ,CAAC,gBAAgB,CAAC;QAC7B,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,2DAA2D;YACzD,sEAAsE,CACzE;KACJ,EACD,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QACvB,MAAM,UAAU,GAAG,SAAS;YAC1B,CAAC,CAAC,kBAAkB,SAAS,YAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,4BAA4B;YAC9G,CAAC,CAAC,qBAAqB,CAAC;QAE1B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;;SAEX,KAAK;EACZ,UAAU;;;yDAG6C,SAAS,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,uBAAuB,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE;uDACzH,KAAK;;;uMAG2I;qBAC1L;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/integrate-merchant.d.ts

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

package/dist/prompts/integrate-merchant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-merchant.d.ts","sourceRoot":"","sources":["../../src/prompts/integrate-merchant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA6CvD"}

package/dist/prompts/integrate-merchant.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export function registerMerchantPrompt(server) {
+    server.prompt("integrate-merchant", "Step-by-step guide for adding x402 USDC paywalls to your API. " +
+        "Generates middleware code, environment setup, and testing instructions.", {
+        framework: z
+            .enum(["express", "hono", "nextjs"])
+            .describe("Web framework to use. Use 'nextjs' for Next.js App Router (Hono adapter)."),
+        chain: z
+            .string()
+            .default("solana")
+            .describe("Primary chain."),
+        endpoints: z
+            .string()
+            .describe("Comma-separated list of endpoints with prices, e.g. " +
+            "'GET /api/weather:0.01, GET /api/premium:0.10'"),
+    }, ({ framework, chain, endpoints }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I want to add PincerPay USDC paywalls to my ${framework} API.
+
+Chain: ${chain}
+Endpoints: ${endpoints}
+
+Please:
+1. Use the scaffold-x402-middleware tool to generate the middleware code
+2. Use validate-payment-config to verify the configuration
+3. Use list-supported-chains to confirm the chain is valid
+4. Use generate-ucp-manifest to create a discovery manifest
+5. Explain how to get an API key from pincerpay.com/dashboard
+6. Show how to test with the agent SDK on a testnet chain`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=integrate-merchant.js.map

package/dist/prompts/integrate-merchant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrate-merchant.js","sourceRoot":"","sources":["../../src/prompts/integrate-merchant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,gEAAgE;QAC9D,yEAAyE,EAC3E;QACE,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;aACnC,QAAQ,CACP,2EAA2E,CAC5E;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,OAAO,CAAC,QAAQ,CAAC;aACjB,QAAQ,CAAC,gBAAgB,CAAC;QAC7B,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,CACP,sDAAsD;YACpD,gDAAgD,CACnD;KACJ,EACD,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+CAA+C,SAAS;;SAEjE,KAAK;aACD,SAAS;;;;;;;;0DAQoC;iBAC/C;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/chain-config.d.ts

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

package/dist/resources/chain-config.d.ts.map

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

package/dist/resources/chain-config.js

@@ -0,0 +1,29 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CHAINS } from "@pincerpay/core";
+export function registerChainResources(server) {
+    server.resource("chain-config", new ResourceTemplate("chain://{shorthand}", {
+        list: async () => ({
+            resources: Object.values(CHAINS).map((c) => ({
+                uri: `chain://${c.shorthand}`,
+                name: `${c.name} (${c.shorthand})`,
+                description: `${c.testnet ? "Testnet" : "Mainnet"} — USDC: ${c.usdcAddress.slice(0, 10)}...`,
+                mimeType: "application/json",
+            })),
+        }),
+    }), async (uri, { shorthand }) => {
+        const chain = CHAINS[shorthand];
+        if (!chain) {
+            throw new Error(`Unknown chain: "${shorthand}". Valid: ${Object.keys(CHAINS).join(", ")}`);
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    text: JSON.stringify(chain, null, 2),
+                    mimeType: "application/json",
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=chain-config.js.map

package/dist/resources/chain-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-config.js","sourceRoot":"","sources":["../../src/resources/chain-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,IAAI,gBAAgB,CAAC,qBAAqB,EAAE;QAC1C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,GAAG,EAAE,WAAW,CAAC,CAAC,SAAS,EAAE;gBAC7B,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,GAAG;gBAClC,WAAW,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK;gBAC5F,QAAQ,EAAE,kBAA2B;aACtC,CAAC,CAAC;SACJ,CAAC;KACH,CAAC,EACF,KAAK,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAmB,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,mBAAmB,SAAS,aAAa,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpC,QAAQ,EAAE,kBAAkB;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/docs.d.ts

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

package/dist/resources/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/resources/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAobzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAgCtD"}