agentpay-mcp 4.1.10 → 4.1.16

package/docs/x402-multi-ledger-receipt-normalization.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/up2itnow0822/agentpay-mcp/docs/x402-multi-ledger-receipt-normalization.schema.json",
+  "title": "AgentPay x402 multi-ledger receipt",
+  "type": "object",
+  "required": ["schema", "observedAt", "source", "payment", "ledger", "settlement", "verification", "boundary"],
+  "properties": {
+    "schema": { "const": "agentpay-x402-multi-ledger-receipt/v1" },
+    "observedAt": { "type": "string", "format": "date-time" },
+    "source": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "repo": { "type": "string" },
+        "evidenceUrl": { "type": "string" },
+        "pushedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "payment": {
+      "type": "object",
+      "required": ["x402Version", "paymentHeader", "receiptHeader"],
+      "properties": {
+        "x402Version": { "type": "string" },
+        "paymentHeader": { "const": "Payment-Signature" },
+        "receiptHeader": { "const": "payment-response" }
+      }
+    },
+    "ledger": {
+      "type": "object",
+      "required": ["label", "namespace"],
+      "properties": {
+        "label": { "type": "string" },
+        "namespace": { "enum": ["eip155", "xrpl", "tvm", "solana", "other"] },
+        "chainId": {}
+      }
+    },
+    "settlement": {
+      "type": "object",
+      "required": ["asset", "target"],
+      "properties": {
+        "asset": { "type": "string" },
+        "target": { "type": "string" },
+        "reference": { "type": "string" }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "required": ["status", "checkedAt"],
+      "properties": {
+        "status": { "enum": ["verified", "pending", "unsupported_refused", "failed", "unknown"] },
+        "verifier": { "type": "string" },
+        "checkedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "boundary": {
+      "type": "object",
+      "required": ["custody", "nonCustodial", "description"],
+      "properties": {
+        "custody": { "enum": ["non-custodial", "facilitator", "managed", "unknown"] },
+        "nonCustodial": { "type": "boolean" },
+        "description": { "type": "string" }
+      }
+    },
+    "unsupportedLedgerRefusal": { "type": "string" }
+  }
+}

package/examples/smithery-paid-mcp-installation/README.md

@@ -0,0 +1,63 @@
+# Smithery paid MCP installation example
+
+This example is intentionally documentation-first because the live Smithery listing for AgentPay MCP still needs external verification. It gives app teams the copy-paste shape for Smithery CLI, Vercel AI SDK MCP, and `@smithery/api` TypeScript usage while preserving AgentPay's payment-safety invariant.
+
+## Install shape
+
+```bash
+npm install -g smithery
+smithery namespace create agentpay-buyer-demo
+smithery mcp add up2itnow0822/agentpay-mcp
+smithery tool list <connection>
+```
+
+Do not run a paid tool from a directory-installed server until the host app has loaded a spend policy and captured a fresh `.well-known/x402` snapshot.
+
+## Safety defaults
+
+```bash
+export CHAIN_ID="84532"
+export AGENTPAY_DEFAULT_MAX_USDC="1.00"
+export AGENTPAY_APPROVAL_MODE="human_required"
+export AGENTPAY_MANIFEST_MAX_AGE_SECONDS="300"
+```
+
+## Vercel AI SDK MCP shape
+
+```typescript
+import { createMCPClient } from "@ai-sdk/mcp";
+import { createConnection } from "@smithery/api/mcp";
+
+const { transport } = await createConnection({
+  mcpUrl: process.env.AGENTPAY_SMITHERY_MCP_URL!,
+});
+
+const client = await createMCPClient({ transport });
+const tools = await client.tools();
+
+// Wrap paid tools with host-side approval before calling x402_pay.
+console.log(Object.keys(tools));
+await client.close();
+```
+
+## TypeScript SDK shape
+
+```typescript
+import Smithery from "@smithery/api";
+import { AgentpayMcp } from "https://api.smithery.ai/sdks/typescript/up2itnow0822/agentpay-mcp/latest";
+
+const smithery = new Smithery({ apiKey: process.env.SMITHERY_API_KEY });
+const conn = await smithery.connections.create("agentpay-buyer-demo", {
+  mcpUrl: process.env.AGENTPAY_SMITHERY_MCP_URL!,
+});
+
+const agentpay = new AgentpayMcp({
+  smithery,
+  namespace: "agentpay-buyer-demo",
+  connectionId: conn.connectionId,
+});
+
+// Check manifest freshness and request human approval before calling agentpay.tools.x402_pay.
+```
+
+See `docs/smithery-paid-mcp-installation.md` for the full proof and acceptance checklist.

package/llms.txt

@@ -19,3 +19,7 @@ Important docs:
 - `docs/mcp-registry-listing-proof.md` for registry, Glama, Smithery, and install-readiness proof
 - `docs/directory-introspection-readiness.md` for npx and Docker introspection
 - `docs/dependency-pin-policy.md` for payment-critical dependency pinning
+
+- `docs/agentpay-five-tool-parity-proof.md` and `docs/agentpay-five-tool-parity-proof.json` for search/check/fetch/wallet/pay buyer-flow parity without hosted-session custody
+- `docs/agentpay-escrow-reputation-boundary.md` for separating x402 payment authorization from escrow, identity, reputation, and work proof
+- `docs/paid-mcp-proxy-discovery-readiness.md` and `docs/agentpay-paid-proxy-discovery-listing.json` for paid-proxy and directory listing submissions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentpay-mcp",
-  "version": "4.1.10",
+  "version": "4.1.16",
   "mcpName": "io.github.up2itnow0822/agentpay",
   "description": "AgentPay MCP Server - Non-custodial x402 payment layer for AI agents. Multi-chain wallets, spending limits, and machine-to-machine payments. Patent Pending.",
   "main": "dist/index.js",
@@ -16,6 +16,7 @@
     "docs/*.md",
     "docs/*.json",
     "docs/fixtures/*.json",
+    "examples/smithery-paid-mcp-installation/*.md",
     "Dockerfile",
     "smithery.yaml",
     "glama.json",