@pincerpay/mcp 0.1.0

package/dist/resources/docs.js

@@ -0,0 +1,460 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+const DOCS = {
+    "getting-started": {
+        title: "Getting Started with PincerPay",
+        content: `# Getting Started with PincerPay
+
+PincerPay is an on-chain USDC payment gateway for AI agents using the x402 protocol (HTTP 402).
+No card rails — pure stablecoin settlement on Solana (primary), Base, and Polygon.
+
+## Prerequisites
+
+- Node.js 22+
+- \`"type": "module"\` in your package.json — both SDKs are **ESM-only**. Without this, you'll get \`ERR_MODULE_NOT_FOUND\`.
+- A USDC wallet (Solana or EVM) for receiving/sending payments
+
+## Choose Your Path
+
+### Merchant — Accept USDC payments from AI agents
+You have an API and want to add payment walls so agents pay per request.
+
+1. **Install**: \`npm install @pincerpay/merchant\`
+2. **Get an API key**: Sign up at https://pincerpay.com/dashboard → Settings → API Keys (\`pp_live_...\`)
+3. **Generate code**: Use the \`scaffold-x402-middleware\` tool (supports Express, Hono, Next.js)
+4. **Validate config**: Use the \`validate-payment-config\` tool to check your setup
+5. **Add discovery**: Use the \`generate-ucp-manifest\` tool for agent discoverability
+
+→ Full guide: \`docs://pincerpay/merchant\`
+
+### Agent Developer — Build agents that pay for API access
+You're building an AI agent that needs to automatically pay for paywalled APIs.
+
+1. **Install**: \`npm install @pincerpay/agent\`
+2. **Generate code**: Use the \`scaffold-agent-client\` tool with your chain and spending limits
+3. **Estimate costs**: Use the \`estimate-gas-cost\` tool to understand fees on your chain
+
+→ Full guide: \`docs://pincerpay/agent\`
+
+### Already Integrated? Troubleshooting
+Use the \`debug-transaction\` prompt with your transaction hash, or see \`docs://pincerpay/troubleshooting\`.
+
+## Security Checklist
+- Add \`.env*\` to \`.gitignore\` — **never commit API keys or private keys**
+- Store wallet keys in environment variables, not source code
+- Use \`pp_test_\` keys and devnet chains during development
+
+## Devnet vs Mainnet
+
+| Environment | Chain Shorthand | Notes |
+|-------------|----------------|-------|
+| Development | \`"solana-devnet"\` | Free devnet USDC. Use Solana faucet for SOL. |
+| Development | \`"base-sepolia"\` | Free testnet USDC via Circle faucet. |
+| Production | \`"solana"\` | Real USDC on Solana mainnet. |
+| Production | \`"base"\` | Real USDC on Base mainnet. |
+
+**Both merchant and agent must use the same chain** (e.g., both on \`"solana-devnet"\`).
+
+## How It Works
+
+1. Merchant wraps API routes with PincerPay middleware
+2. Agent calls the API and receives HTTP 402 with payment challenge
+3. Agent SDK automatically signs a USDC transfer
+4. PincerPay facilitator verifies the signature and broadcasts the transaction
+5. Merchant delivers the protected resource
+
+## Supported Chains
+- **Solana** (primary) — ~$0.00025 gas, 400ms block time
+- **Base** (EVM) — ~$0.001-0.01 gas, 2s block time
+- **Polygon** (EVM) — ~$0.001-0.005 gas, 2s block time
+
+## Key Concepts
+- **Optimistic Finality**: Payments under $1 USDC are released after mempool broadcast (~200ms)
+- **Gas Passthrough**: Agents pay gas costs in USDC (via Kora on Solana, meta-txns on EVM), not merchants
+- **x402 Protocol**: HTTP 402-based payment challenges (Coinbase open standard)
+- **Prices vs Policies**: Route \`price\` uses human-readable amounts ("0.01"), spending \`policies\` use base units ("10000")`,
+    },
+    merchant: {
+        title: "Merchant Integration Guide",
+        content: `# Merchant SDK Integration
+
+## Install
+
+\`\`\`bash
+npm install @pincerpay/merchant
+\`\`\`
+
+Sub-path imports are available for tree-shaking: \`@pincerpay/merchant/express\` and \`@pincerpay/merchant/hono\`.
+
+## Express Middleware
+
+\`\`\`typescript
+import express from "express";
+import { pincerpay } from "@pincerpay/merchant/express";
+
+const app = express();
+
+app.use(
+  pincerpay({
+    apiKey: process.env.PINCERPAY_API_KEY!,
+    merchantAddress: "YOUR_SOLANA_WALLET_ADDRESS",
+    routes: {
+      "GET /api/weather": { price: "0.001", chain: "solana" },
+      "GET /api/premium": { price: "0.01", chain: "solana" },
+    },
+  })
+);
+\`\`\`
+
+## Hono Middleware
+
+\`\`\`typescript
+import { Hono } from "hono";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+const app = new Hono();
+
+app.use(
+  "*",
+  pincerpayHono({
+    apiKey: process.env.PINCERPAY_API_KEY!,
+    merchantAddress: "YOUR_SOLANA_WALLET_ADDRESS",
+    routes: {
+      "GET /api/weather": { price: "0.001", chain: "solana" },
+    },
+  })
+);
+\`\`\`
+
+## Next.js (Hono Adapter)
+
+Next.js doesn't have native x402 middleware. Use Hono as a lightweight handler in a catch-all App Router route:
+
+\`\`\`typescript
+// app/api/[...route]/route.ts
+import { Hono } from "hono";
+import { handle } from "hono/vercel";
+import { pincerpayHono } from "@pincerpay/merchant/hono";
+
+const app = new Hono().basePath("/api");
+
+app.use("*", pincerpayHono({
+  apiKey: process.env.PINCERPAY_API_KEY!,
+  merchantAddress: "YOUR_SOLANA_WALLET_ADDRESS",
+  routes: {
+    "GET /api/weather": {
+      price: "0.01",
+      chain: "solana",
+    },
+  },
+}));
+
+app.get("/weather", (c) => {
+  return c.json({ forecast: "sunny", temp: 72 });
+});
+
+export const GET = handle(app);
+export const POST = handle(app);
+\`\`\`
+
+**Notes:** \`basePath("/api")\` must match the catch-all location. Route handlers use paths relative to basePath (\`/weather\` → \`/api/weather\`). Install: \`npm install @pincerpay/merchant hono\`.
+
+## Multi-Chain Routes
+
+Accept payments on multiple chains per route — agents auto-select the chain they have funds on:
+
+\`\`\`typescript
+routes: {
+  "GET /api/weather": {
+    price: "0.01",
+    chains: ["solana", "base", "polygon"],
+  },
+}
+\`\`\`
+
+If neither \`chain\` nor \`chains\` is specified, defaults to \`"solana"\`.
+
+## Configuration
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| apiKey | Yes | Your PincerPay API key (\`pp_live_...\` or \`pp_test_...\`) |
+| merchantAddress | Yes | Your USDC wallet address |
+| facilitatorUrl | No | Custom facilitator URL (defaults to PincerPay hosted) |
+| routes | Yes | Map of route patterns to paywall configs |
+
+## Route Config
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| price | Yes | USDC price as human-readable string (e.g., "0.01" = 1 cent) |
+| chain | No | Chain shorthand (default: "solana") |
+| chains | No | Array of chain shorthands for multi-chain support |
+| description | No | Human-readable description shown in 402 response |
+
+## Utility: toBaseUnits
+
+Convert human-readable USDC to base units (useful for spending policies):
+
+\`\`\`typescript
+import { toBaseUnits } from "@pincerpay/merchant";
+toBaseUnits("0.01"); // → "10000"
+toBaseUnits("1.00"); // → "1000000"
+\`\`\``,
+    },
+    agent: {
+        title: "Agent Integration Guide",
+        content: `# Agent SDK Integration
+
+## Install
+
+\`\`\`bash
+npm install @pincerpay/agent
+\`\`\`
+
+No peer dependencies — transitive deps (\`@solana/kit\`, \`viem\`, \`@x402/*\`) install automatically.
+
+## Basic Usage
+
+\`\`\`typescript
+import { PincerPayAgent } from "@pincerpay/agent";
+
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+});
+
+// agent.fetch() is a drop-in replacement for fetch
+const response = await agent.fetch("https://api.example.com/weather");
+const data = await response.json();
+\`\`\`
+
+**Note:** \`PincerPayAgent.create()\` is async (required for Solana key derivation). For EVM-only agents, you can also use \`new PincerPayAgent(config)\` (synchronous).
+
+## With Spending Policies
+
+**Important:** Spending policies use **base units** (6 decimals), NOT human-readable amounts. \`BigInt("0.10")\` will throw at runtime!
+
+\`\`\`typescript
+const agent = await PincerPayAgent.create({
+  chains: ["solana"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+  // Spending policies use base units: 1 USDC = "1000000", $0.10 = "100000"
+  policies: [
+    {
+      maxPerTransaction: "100000",   // $0.10 per API call
+      maxPerDay: "5000000",          // $5.00 per day
+    },
+  ],
+});
+\`\`\`
+
+| Human Amount | Base Units |
+|-------------|------------|
+| $0.01 | \`"10000"\` |
+| $0.10 | \`"100000"\` |
+| $1.00 | \`"1000000"\` |
+| $10.00 | \`"10000000"\` |
+
+Multiply human amount × 1,000,000 to get base units. Or use \`toBaseUnits("0.10")\` from \`@pincerpay/merchant\`.
+
+## Runtime Policy Management
+
+\`\`\`typescript
+// Pre-check if a payment would be allowed
+const check = agent.checkPolicy("500000"); // 0.50 USDC
+if (!check.allowed) console.log(check.reason);
+
+// Update spending limits dynamically
+agent.setPolicy({ maxPerTransaction: "5000000", maxPerDay: "50000000" });
+
+// Monitor daily spending
+const { date, amount } = agent.getDailySpend();
+console.log(\`Spent \${amount} base units on \${date}\`);
+
+// Get current policy
+const policy = agent.getPolicy();
+\`\`\`
+
+## Agent Properties
+
+| Property | Description |
+|----------|-------------|
+| \`agent.fetch(url, init?)\` | Payment-enabled fetch — auto-handles 402 challenges |
+| \`agent.solanaAddress\` | Agent's Solana public key (only available via \`.create()\`) |
+| \`agent.evmAddress\` | Agent's EVM public address |
+| \`agent.chains\` | Configured chain shorthands |
+| \`agent.checkPolicy(amountBaseUnits)\` | Pre-check \`{ allowed, reason? }\` against spending limits |
+| \`agent.setPolicy(policy)\` | Replace spending policy at runtime |
+| \`agent.getPolicy()\` | Get current spending policy |
+| \`agent.getDailySpend()\` | Get \`{ date: string, amount: bigint }\` for today's tracked spend |
+
+## How x402 Payment Flow Works
+
+1. \`agent.fetch(url)\` calls the merchant API
+2. Server returns HTTP 402 with \`X-Payment\` header (x402 challenge)
+3. Agent SDK extracts payment requirements (amount, chain, recipient)
+4. Agent signs a USDC transfer transaction
+5. PincerPay facilitator verifies + broadcasts the transaction
+6. Agent retries the original request with the payment proof
+7. Server validates payment and returns the protected resource
+
+## Multi-Chain Support
+
+\`\`\`typescript
+const agent = await PincerPayAgent.create({
+  chains: ["solana", "base"],
+  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
+  evmPrivateKey: process.env.AGENT_EVM_KEY!,
+});
+\`\`\`
+
+The agent automatically selects the correct chain based on the merchant's 402 response.
+
+## Environment Variables
+
+\`\`\`
+AGENT_SOLANA_KEY=your_base58_private_key_here
+# or for EVM:
+AGENT_EVM_KEY=0xyour_hex_private_key_here
+\`\`\`
+
+**Never commit private keys.** Ensure \`.env*\` is in \`.gitignore\`.`,
+    },
+    troubleshooting: {
+        title: "Troubleshooting Common Issues",
+        content: `# Troubleshooting
+
+## Common Issues
+
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| \`ERR_MODULE_NOT_FOUND\` | ESM import issues | Add \`"type": "module"\` to package.json or use \`.mts\` extension. Both \`@pincerpay/merchant\` and \`@pincerpay/agent\` are ESM-only. |
+| \`SyntaxError: Cannot use import statement\` | CommonJS project importing ESM | Add \`"type": "module"\` to package.json. |
+| 402 but no payment attempted | Chain mismatch | Agent and merchant must use the same chain (e.g., both \`"solana-devnet"\`). Check \`chains\` array. |
+| \`Invalid base58 character\` | Wrong key format for Solana | Solana private keys are base58 (alphanumeric, no \`0x\` prefix). EVM keys are hex (\`0x...\`). |
+| Payment succeeds but 402 persists | Facilitator URL mismatch | Both merchant and agent must use the same facilitator. Default: \`https://facilitator.pincerpay.com\`. |
+| \`Exceeds per-transaction limit\` | Spending policy too restrictive | Increase \`maxPerTransaction\` — value is in **base units** (6 decimals). \`"1000000"\` = $1.00 USDC. |
+| \`BigInt("0.10")\` throws | Human-readable amount in policy | Policies use base units, not human amounts. Use \`"100000"\` not \`"0.10"\` for $0.10. |
+| \`At least one wallet key required\` | No private key configured | Set \`solanaPrivateKey\` or \`evmPrivateKey\` in agent config. Check \`.env\` is loaded. |
+| Route not matching for 402 | Wrong route pattern format | Pattern must be \`"METHOD /path"\` — e.g., \`"GET /api/weather"\`. Uppercase method, space, leading slash. |
+| \`pp_live_\` key on devnet | API key environment mismatch | Use \`pp_test_\` keys for devnet chains. |
+
+## Devnet Funding
+
+- **Solana devnet SOL**: https://faucet.solana.com
+- **Solana devnet USDC**: Request from PincerPay team or use a devnet DEX
+- **Base Sepolia ETH**: Base Sepolia faucet
+- **Base Sepolia USDC**: Circle testnet USDC faucet
+
+## Debugging Tips
+
+1. **Verify 402 response**: \`curl -s -w "\\nHTTP Status: %{http_code}\\n" http://localhost:3000/api/endpoint\` — should return 402 with \`paymentRequirements\` JSON
+2. **Check chain match**: Both merchant route config and agent \`chains\` array must use identical chain shorthands
+3. **Test agent fetch**: \`const response = await agent.fetch(url); console.log(response.status);\` — should be 200 after payment
+4. **Inspect spending**: \`console.log(agent.getDailySpend())\` to see current daily spend tracking
+5. **Validate config**: Use the \`validate-payment-config\` MCP tool to check your merchant config for errors`,
+    },
+    reference: {
+        title: "API Reference",
+        content: `# PincerPay Reference
+
+## Chain Shorthands
+
+| Shorthand | Network | CAIP-2 ID | Notes |
+|-----------|---------|-----------|-------|
+| \`solana\` | Solana Mainnet | \`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\` | Primary chain, default |
+| \`solana-devnet\` | Solana Devnet | \`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\` | Solana testnet |
+| \`base\` | Base Mainnet | \`eip155:8453\` | EVM, low fees |
+| \`base-sepolia\` | Base Sepolia | \`eip155:84532\` | EVM testnet |
+| \`polygon\` | Polygon Mainnet | \`eip155:137\` | EVM |
+| \`polygon-amoy\` | Polygon Amoy | \`eip155:80002\` | Polygon testnet |
+
+## USDC Amounts (6 Decimals)
+
+Route \`price\` fields use human-readable strings. Spending \`policies\` use base unit strings.
+
+| Human Amount | Base Units | Route \`price\` | Policy value |
+|-------------|------------|---------------|--------------|
+| $0.001 | 1,000 | \`"0.001"\` | \`"1000"\` |
+| $0.01 | 10,000 | \`"0.01"\` | \`"10000"\` |
+| $0.10 | 100,000 | \`"0.10"\` | \`"100000"\` |
+| $1.00 | 1,000,000 | \`"1.00"\` | \`"1000000"\` |
+| $10.00 | 10,000,000 | \`"10.00"\` | \`"10000000"\` |
+| $100.00 | 100,000,000 | \`"100.00"\` | \`"100000000"\` |
+
+Convert: multiply human amount × 1,000,000. Or use \`toBaseUnits("0.01")\` from \`@pincerpay/merchant\`.
+
+## Package Exports
+
+| Package | Key Exports |
+|---------|-------------|
+| \`@pincerpay/merchant\` | \`pincerpay\` (Express), \`pincerpayHono\` (Hono), \`PincerPayClient\` (low-level), \`toBaseUnits\`, \`resolveRouteChains\`, \`getUsdcAsset\` |
+| \`@pincerpay/merchant/express\` | \`pincerpay\` (tree-shakeable sub-path import) |
+| \`@pincerpay/merchant/hono\` | \`pincerpayHono\` (tree-shakeable sub-path import) |
+| \`@pincerpay/agent\` | \`PincerPayAgent\` (main agent class), \`SolanaSmartAgent\` (Squads session keys — advanced) |
+| \`@pincerpay/core\` | \`PincerPayConfig\`, \`AgentConfig\`, \`SpendingPolicy\`, \`RoutePaywallConfig\`, \`ChainConfig\` (types) |
+
+## PincerPayClient Methods (Low-Level)
+
+For advanced users building custom middleware:
+
+| Method | Description |
+|--------|-------------|
+| \`verify(paymentPayload, paymentRequirements)\` | Verify a raw x402 payment payload |
+| \`settle(paymentPayload, paymentRequirements)\` | Settle a verified payment on-chain |
+| \`getSupported()\` | Get supported schemes/networks from the facilitator |
+| \`getStatus(txHash)\` | Get transaction status by hash |
+
+Most users should use \`pincerpay()\` or \`pincerpayHono()\` middleware instead.
+
+## PincerPayAgent Properties & Methods
+
+| Member | Description |
+|--------|-------------|
+| \`agent.fetch(url, init?)\` | Payment-enabled fetch — auto-handles 402 challenges |
+| \`agent.solanaAddress\` | Agent's Solana public key (only via \`.create()\`) |
+| \`agent.evmAddress\` | Agent's EVM public address |
+| \`agent.chains\` | Configured chain shorthands |
+| \`agent.checkPolicy(amountBaseUnits)\` | Pre-check \`{ allowed, reason? }\` against spending limits |
+| \`agent.setPolicy(policy)\` | Replace spending policy at runtime |
+| \`agent.getPolicy()\` | Get current spending policy |
+| \`agent.getDailySpend()\` | Get \`{ date: string, amount: bigint }\` for today's tracked spend |
+
+## Route Pattern Format
+
+Route patterns must follow this format: \`"METHOD /path"\`
+
+- **Method**: Uppercase HTTP method (GET, POST, PUT, DELETE, PATCH)
+- **Space**: Single space between method and path
+- **Path**: Must start with \`/\`
+
+Examples: \`"GET /api/weather"\`, \`"POST /api/submit"\`, \`"GET /api/data/:id"\``,
+    },
+};
+export function registerDocsResources(server) {
+    const topics = Object.keys(DOCS);
+    server.resource("docs", new ResourceTemplate("docs://pincerpay/{topic}", {
+        list: async () => ({
+            resources: topics.map((key) => ({
+                uri: `docs://pincerpay/${key}`,
+                name: DOCS[key].title,
+                mimeType: "text/markdown",
+            })),
+        }),
+    }), async (uri, { topic }) => {
+        const doc = DOCS[topic];
+        if (!doc) {
+            throw new Error(`Unknown doc topic: "${topic}". Available: ${topics.join(", ")}`);
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    text: doc.content,
+                    mimeType: "text/markdown",
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/resources/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/resources/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,IAAI,GAAuD;IAC/D,iBAAiB,EAAE;QACjB,KAAK,EAAE,gCAAgC;QACvC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+HAqEkH;KAC5H;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,4BAA4B;QACnC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4HN;KACJ;IACD,KAAK,EAAE;QACL,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sEAmHyD;KACnE;IACD,eAAe,EAAE;QACf,KAAK,EAAE,+BAA+B;QACtC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8GA8BiG;KAC3G;IACD,SAAS,EAAE;QACT,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFAwEqE;KAC/E;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,CAAC,QAAQ,CACb,MAAM,EACN,IAAI,gBAAgB,CAAC,0BAA0B,EAAE;QAC/C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9B,GAAG,EAAE,oBAAoB,GAAG,EAAE;gBAC9B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAE,CAAC,KAAK;gBACtB,QAAQ,EAAE,eAAwB;aACnC,CAAC,CAAC;SACJ,CAAC;KACH,CAAC,EACF,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAe,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,GAAG,CAAC,OAAO;oBACjB,QAAQ,EAAE,eAAe;iBAC1B;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/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 registerResources(server: McpServer, client: FacilitatorClient): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAKtD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,QAK1B"}

package/dist/resources/index.js

@@ -0,0 +1,9 @@
+import { registerChainResources } from "./chain-config.js";
+import { registerOpenApiResource } from "./openapi-spec.js";
+import { registerDocsResources } from "./docs.js";
+export function registerResources(server, client) {
+    registerChainResources(server);
+    registerOpenApiResource(server, client);
+    registerDocsResources(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAyB;IAEzB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/resources/openapi-spec.d.ts

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

package/dist/resources/openapi-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-spec.d.ts","sourceRoot":"","sources":["../../src/resources/openapi-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,QA8B1B"}

package/dist/resources/openapi-spec.js

@@ -0,0 +1,28 @@
+export function registerOpenApiResource(server, client) {
+    server.resource("openapi-spec", "pincerpay://openapi", async (uri) => {
+        try {
+            const spec = await client.getOpenApiSpec();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify(spec, null, 2),
+                        mimeType: "application/json",
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: `Failed to fetch OpenAPI spec: ${err instanceof Error ? err.message : String(err)}`,
+                        mimeType: "text/plain",
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=openapi-spec.js.map

package/dist/resources/openapi-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-spec.js","sourceRoot":"","sources":["../../src/resources/openapi-spec.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,MAAyB;IAEzB,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,qBAAqB,EACrB,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3C,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;wBACnC,QAAQ,EAAE,kBAAkB;qBAC7B;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;wBACzF,QAAQ,EAAE,YAAY;qBACvB;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface PincerPayMcpConfig {
+    /** PincerPay API key (pp_live_... or pp_test_...) */
+    apiKey?: string;
+    /** Facilitator URL (defaults to https://facilitator.pincerpay.com) */
+    facilitatorUrl?: string;
+}
+/**
+ * Create a configured PincerPay MCP server with all tools,
+ * resources, and prompts registered.
+ *
+ * Tools that don't require auth (scaffolding, gas estimates,
+ * chain listing) work without an API key. Operations tools
+ * (transaction status) require a key and return a helpful error
+ * if none is configured.
+ */
+export declare function createPincerPayMcpServer(config?: PincerPayMcpConfig): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,kBAAuB,aAuCvE"}

package/dist/server.js

@@ -0,0 +1,48 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FacilitatorClient } from "./client.js";
+import { registerTools } from "./tools/index.js";
+import { registerResources } from "./resources/index.js";
+import { registerPrompts } from "./prompts/index.js";
+/**
+ * Create a configured PincerPay MCP server with all tools,
+ * resources, and prompts registered.
+ *
+ * Tools that don't require auth (scaffolding, gas estimates,
+ * chain listing) work without an API key. Operations tools
+ * (transaction status) require a key and return a helpful error
+ * if none is configured.
+ */
+export function createPincerPayMcpServer(config = {}) {
+    const server = new McpServer({
+        name: "pincerpay",
+        version: "0.1.0",
+    }, {
+        instructions: "PincerPay is an on-chain USDC payment gateway for AI agents — no card rails, " +
+            "pure stablecoin settlement via the x402 protocol (HTTP 402). Solana is the primary " +
+            "chain; Base and Polygon are optional EVM alternatives.\n\n" +
+            "ROLE ROUTING: When a user wants to integrate PincerPay, first determine their role:\n" +
+            "- Merchant (accept payments): use the `integrate-merchant` prompt → scaffold-x402-middleware → validate-payment-config → generate-ucp-manifest\n" +
+            "- Agent developer (make payments): use the `integrate-agent` prompt → scaffold-agent-client → estimate-gas-cost\n" +
+            "- Unclear: use the `get-started` prompt to triage\n" +
+            "- Debugging: use the `debug-transaction` prompt\n\n" +
+            "KEY GOTCHAS to always warn about:\n" +
+            "1. Route `price` uses human-readable USDC (\"0.01\"), but spending `policies` use base units with 6 decimals (\"10000\" = $0.01). Using \"0.10\" in a policy causes BigInt() to throw.\n" +
+            "2. ESM required: \"type\": \"module\" in package.json — SDKs are ESM-only.\n" +
+            "3. Security: .gitignore must include .env* — never commit API keys or private keys.\n" +
+            "4. Use devnet chains for testing (solana-devnet, base-sepolia).\n\n" +
+            "Docs resources: docs://pincerpay/getting-started, docs://pincerpay/merchant, " +
+            "docs://pincerpay/agent, docs://pincerpay/troubleshooting, docs://pincerpay/reference.",
+        capabilities: {
+            logging: {},
+        },
+    });
+    const client = new FacilitatorClient({
+        apiKey: config.apiKey,
+        facilitatorUrl: config.facilitatorUrl,
+    });
+    registerTools(server, client);
+    registerResources(server, client);
+    registerPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AASrD;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAA6B,EAAE;IACtE,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EACV,+EAA+E;YAC/E,qFAAqF;YACrF,4DAA4D;YAC5D,uFAAuF;YACvF,kJAAkJ;YAClJ,mHAAmH;YACnH,qDAAqD;YACrD,qDAAqD;YACrD,qCAAqC;YACrC,0LAA0L;YAC1L,8EAA8E;YAC9E,uFAAuF;YACvF,qEAAqE;YACrE,+EAA+E;YAC/E,uFAAuF;QACzF,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/check-transaction.d.ts

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

package/dist/tools/check-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-transaction.d.ts","sourceRoot":"","sources":["../../src/tools/check-transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWtD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,QA8C1B"}

package/dist/tools/check-transaction.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+const inputSchema = {
+    txHash: z
+        .string()
+        .min(1)
+        .describe("Transaction hash (EVM hex) or signature (Solana base58) to look up."),
+};
+export function registerCheckTransaction(server, client) {
+    server.tool("check-transaction-status", "Query the PincerPay facilitator for the status of a payment transaction. " +
+        "Returns chain, amount, addresses, status (pending/mempool/optimistic/confirmed/failed), " +
+        "and timestamps. Requires a PincerPay API key.", inputSchema, async ({ txHash }) => {
+        try {
+            client.requireAuth();
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: err instanceof Error ? err.message : String(err),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await client.getStatus(txHash);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to fetch transaction status: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=check-transaction.js.map