@agentpickup/mcp 0.3.0 → 0.3.2

package/README.md

@@ -1,8 +1,8 @@
 # @agentpickup/mcp
 
-An MCP server for [agentPickup](https://github.com/dav3trad3r/agentpickup) shops. It lets an AI agent find
-pickup shops near its user, see what they sell, order, pay in USDC over x402, and hand its user the QR they
-show at the counter to collect.
+An MCP server for [agentPickup](https://agentpickup.app) shops. It lets an AI agent find
+pickup shops near its user, see what they sell, order, pay by card or in USDC over x402, and hand its user the
+QR they show at the counter to collect.
 
 ## Tools
 
@@ -10,8 +10,8 @@ show at the counter to collect.
 |---|---|
 | `find_shops` | Shops near a point (`lat`/`lng`), in a suburb (`place`) or selling something (`query`), from the agentPickup directory: each one's `shop_url`, address, hours, open now, distance and matching items |
 | `get_shop` | Items and prices, the pickup location, and how the shop takes payment |
-| `create_pickup_order` | Creates an order. Needs the user's email, where the shop sends the receipt and pickup QR. A test shop marks it paid straight away, with no money moving |
-| `pay_order` | Pays the order's x402 link from your wallet and returns the pass link. With no wallet set up, returns the price and pay link instead |
+| `create_pickup_order` | Creates an order. Needs the user's email, where the shop sends the receipt and pickup QR. A test shop marks it paid straight away, with no money moving. Where the shop takes cards, `payment: "card"` returns a checkout link for the user to pay on instead |
+| `pay_order` | Pays the order's x402 link from your wallet and returns the pass link. With no wallet set up, returns the price and pay link instead. For a card order, returns its checkout link |
 | `order_status` | Waiting for payment, paid, ready, collected or expired |
 | `get_pickup_pass` | Fetches the pass link, pickup code and QR again by signing in as the paying wallet (Sign-In-With-X) |
 | `start_group_order` | Starts a group order (a coffee run) with a closing time; returns the code to share and a key to close it early |

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type Fetch, type Payer } from "./wallet.js";
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.3.2";
 export interface PickupMcpOptions {
     /** The agentPickup shop this server orders from. */
     shopUrl: string;

package/dist/server.js

@@ -4,14 +4,15 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 import { z } from "zod";
 import { errorOf, usd } from "./wallet.js";
-export const VERSION = "0.3.0";
+export const VERSION = "0.3.2";
 class ToolError extends Error {
 }
 const INSTRUCTIONS = `agentPickup lets you buy things online for the user to collect in person.
 0. find_shops (when available): shops near the user that sell what they want. Pass a shop's shop_url to the other tools.
 1. get_shop: see what the shop sells, its pickup location and how it takes payment.
 2. create_pickup_order: needs the user's email, where the shop sends the pickup QR.
-3. pay_order: pays from the configured wallet in USDC over x402. Confirm the items and total with the user first.
+3. pay_order: pays from the configured wallet in USDC over x402. Where the shop takes cards, payment: "card" on
+   create_pickup_order gives a checkout link for the user to pay on instead. Confirm the items and total with the user first.
 4. Give the user the pass link and pickup code. They show the QR at the counter to collect.
 get_pickup_pass fetches the pass again later; order_status says whether it's ready or collected.
 Group orders (a coffee run): start_group_order gives a code to share; each person's agent calls join_group_order and
@@ -73,7 +74,13 @@ export function createPickupMcpServer(opts) {
     const shopArg = opts.allowOtherShops || opts.directoryUrl
         ? { shop_url: z.string().optional().describe(`An agentPickup shop's URL, as find_shops returns it. Defaults to ${home}.`) }
         : {};
-    const server = new McpServer({ name: "agentpickup", title: "agentPickup", version: VERSION }, { instructions: INSTRUCTIONS });
+    const server = new McpServer({
+        name: "agentpickup",
+        title: "agentPickup",
+        version: VERSION,
+        websiteUrl: "https://agentpickup.app",
+        icons: [{ src: "https://agentpickup.app/logo.png", mimeType: "image/png", sizes: ["1024x1024"] }],
+    }, { instructions: INSTRUCTIONS });
     if (opts.directoryUrl) {
         const directoryUrl = opts.directoryUrl;
         server.registerTool("find_shops", {
@@ -89,7 +96,7 @@ export function createPickupMcpServer(opts) {
                 open_now: z.boolean().optional().describe("Only shops open now (shops without listed hours stay in)."),
                 limit: z.number().int().min(1).max(50).optional(),
             },
-            annotations: { readOnlyHint: true, openWorldHint: true },
+            annotations: { title: "Find pickup shops", readOnlyHint: true, openWorldHint: true },
         }, guarded(async (args) => {
             if ((args.lat === undefined) !== (args.lng === undefined))
                 throw new ToolError("Send lat and lng together.");
@@ -140,7 +147,7 @@ export function createPickupMcpServer(opts) {
         title: "See what a shop sells",
         description: "What the shop sells (item ids and prices), where to collect, and which payments it takes.",
         inputSchema: { ...shopArg },
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: { title: "See what a shop sells", readOnlyHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const data = await call(shop, "/api/catalog");
@@ -183,7 +190,7 @@ export function createPickupMcpServer(opts) {
                 .describe("Who pays: agent (USDC over x402, or a test payment at a test shop) or card (the user pays on a checkout link). Default: agent where the shop takes it, else card."),
             ...shopArg,
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+        annotations: { title: "Order for pickup", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         // The agent pays over x402 where the shop takes it, a test shop marks the order paid straight away, and a
@@ -218,7 +225,7 @@ export function createPickupMcpServer(opts) {
             ? `Pay an order in USDC over x402 from wallet ${opts.payer.address}. This spends money: confirm the items and total with the user first. Returns the pickup pass link.`
             : "No wallet is set up here, so this returns the price and pay link for another x402 client to pay.",
         inputSchema: { order_id: z.string(), ...shopArg },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+        annotations: { title: "Pay for an order", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const status = (await call(shop, `/api/orders/${encodeURIComponent(args.order_id)}`));
@@ -252,7 +259,7 @@ export function createPickupMcpServer(opts) {
         title: "Check an order",
         description: "Whether an order is waiting for payment, paid, ready to collect, collected or expired.",
         inputSchema: { order_id: z.string(), ...shopArg },
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: { title: "Check an order", readOnlyHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const { order } = (await call(shop, `/api/orders/${encodeURIComponent(args.order_id)}`));
@@ -270,7 +277,7 @@ export function createPickupMcpServer(opts) {
         title: "Get the pickup pass",
         description: "The pass link, pickup code and QR content for an order this wallet paid, by signing in with the wallet (Sign-In-With-X).",
         inputSchema: { order_id: z.string(), ...shopArg },
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: { title: "Get the pickup pass", readOnlyHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         if (!opts.payer)
             throw new ToolError("No wallet is set up here. The pass was emailed to the buyer when the order was paid.");
@@ -300,7 +307,7 @@ export function createPickupMcpServer(opts) {
             closes_in_minutes: z.number().int().min(5).max(240).optional().describe("Default 15"),
             ...shopArg,
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+        annotations: { title: "Start a group order", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const data = (await call(shop, "/api/groups", {
@@ -322,7 +329,7 @@ export function createPickupMcpServer(opts) {
             name: z.string().min(1).max(60).describe("The user's name, shown to staff on their items"),
             ...shopArg,
         },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+        annotations: { title: "Join a group order", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const { payments } = (await call(shop, "/api/catalog"));
@@ -343,7 +350,7 @@ export function createPickupMcpServer(opts) {
         title: "Check a group order",
         description: "Who's in a group order, what they ordered, who has paid, and whether it has closed and been collected.",
         inputSchema: { code: z.string().min(4).max(12), ...shopArg },
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: { title: "Check a group order", readOnlyHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const { group } = (await call(shop, `/api/groups/${encodeURIComponent(args.code)}`));
@@ -353,7 +360,7 @@ export function createPickupMcpServer(opts) {
         title: "Close a group order now",
         description: "Close a group order early, as its organiser. Unpaid shares are left out; the shop gets the rest as one order.",
         inputSchema: { code: z.string().min(4).max(12), organiser_key: z.string().min(8), ...shopArg },
-        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+        annotations: { title: "Close a group order now", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     }, guarded(async (args) => {
         const shop = await shopFor(args.shop_url);
         const { group } = (await call(shop, `/api/groups/${encodeURIComponent(args.code)}/close`, {

package/package.json

@@ -1,62 +1,62 @@
-{
-  "name": "@agentpickup/mcp",
-  "version": "0.3.0",
-  "description": "MCP server for agentPickup: let an AI agent find pickup shops near its user, order, pay over x402, and hand its user the QR to collect in person.",
-  "mcpName": "io.github.dav3trad3r/agentpickup",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "agentpickup-mcp": "dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "source": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "LICENSE.md",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build"
-  },
-  "engines": {
-    "node": ">=22.13"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "x402",
-    "agentic-commerce",
-    "agent-payments",
-    "click-and-collect",
-    "pickup"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dav3trad3r/agentpickup.git",
-    "directory": "packages/mcp"
-  },
-  "homepage": "https://agentpickup.app",
-  "bugs": {
-    "url": "https://github.com/dav3trad3r/agentpickup/issues"
-  },
-  "author": "Dave Hallett",
-  "license": "FSL-1.1-ALv2",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.32.2",
-    "@x402/core": "2.29.0",
-    "@x402/evm": "2.29.0",
-    "@x402/extensions": "2.29.0",
-    "viem": "^2.57.14",
-    "zod": "^4.6.7"
-  }
-}
+{
+  "name": "@agentpickup/mcp",
+  "version": "0.3.2",
+  "description": "MCP server for agentPickup: let an AI agent find pickup shops near its user, order, pay by card or in USDC over x402, and hand its user the QR to collect in person.",
+  "mcpName": "io.github.dav3trad3r/agentpickup",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agentpickup-mcp": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "x402",
+    "agentic-commerce",
+    "agent-payments",
+    "click-and-collect",
+    "pickup"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tokenise-au/agentpickup-sdk.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://agentpickup.app",
+  "bugs": {
+    "url": "https://github.com/Tokenise-au/agentpickup-sdk/issues"
+  },
+  "author": "Dave Hallett",
+  "license": "FSL-1.1-ALv2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "@x402/core": "2.29.0",
+    "@x402/evm": "2.29.0",
+    "@x402/extensions": "2.29.0",
+    "viem": "^2.57.14",
+    "zod": "^4.6.7"
+  }
+}