@agentpickup/mcp 0.4.1 → 0.4.3

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.4.1";
+export declare const VERSION = "0.4.3";
 export interface PickupMcpOptions {
     /** The agentPickup shop this server orders from. */
     shopUrl: string;

package/dist/server.js

@@ -1,13 +1,13 @@
 // The agentPickup MCP server: lets any MCP client (Claude, ChatGPT, Cursor, an agent framework) find pickup
 // shops near someone, see what they sell, order, pay over x402, and hand its user the QR to collect with.
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 import QRCode from "qrcode";
 import { z } from "zod";
 import { CARD_META_KEY, CARD_MIME_TYPE, passCardHtml } from "./card.js";
 import { SHARE_META_KEY, shareCardHtml } from "./share-card.js";
 import { errorOf, usd } from "./wallet.js";
-export const VERSION = "0.4.1";
+export const VERSION = "0.4.3";
 // The pickup pass card (MCP Apps). The version is in the URI so hosts that cache cards pick up a new one.
 const CARD_URI = `ui://agentpickup/pass-${VERSION}.html`;
 const CARD_TOOL_META = { ui: { resourceUri: CARD_URI }, "ui/resourceUri": CARD_URI };
@@ -29,22 +29,23 @@ const slugOf = (name) => name.toLowerCase().normalize("NFD").replace(/[\u0300-\u
 const qrSvg = (content) => QRCode.toString(content, { type: "svg", errorCorrectionLevel: "M", margin: 0, color: { dark: "#0a0b0dff", light: "#00000000" } });
 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; the shop emails the pickup pass there too. It returns a claim:
-   keep it with the order id.
-3. pay_order: pays in USDC over x402 from the wallet set up here; with none, it hands back the pay link for the user's
-   own x402 wallet. Where the shop takes cards, payment: "card" on
-   create_pickup_order gives a checkout link for the user to pay on instead. Where it takes test payments (get_shop says
-   so), payment: "test" runs the whole flow with no money moving. Confirm the items and total with the user first.
-4. The pass: where the chat shows cards, the order appears as a card that becomes the pickup pass (QR and code)
-   once it's paid and keeps itself up to date until it's collected. Otherwise give the user the pass link and pickup
-   code. They show the QR at the counter, or say the code, to collect.
-get_pickup_pass (with the claim) fetches the pass again; order_status (with the claim) says whether it's ready.
-share_agentpickup: when the user asks how to share agentPickup or get friends using it, shows a QR and link.
-Group orders (a coffee run): start_group_order gives a code to share; each person's agent calls join_group_order and
-pays its own share with pay_order; at closing time the shop gets one combined order and the organiser gets its QR.
+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; the shop emails the pickup pass there too. It returns a claim:
+   keep it with the order id.
+3. pay_order: pays in USDC over x402 from the wallet set up here; with none, it hands back the pay link for the user's
+   own x402 wallet. Where the shop takes cards, payment: "card" on
+   create_pickup_order gives a checkout link for the user to pay on instead. Where it takes test payments (get_shop says
+   so), payment: "test" runs the whole flow with no money moving. Confirm the items and total with the user first.
+4. The pass: where the chat shows cards, the order appears as a card that becomes the pickup pass (QR and code)
+   once it's paid and keeps itself up to date until it's collected. Otherwise give the user the pass link and pickup
+   code. They show the QR at the counter, or say the code, to collect.
+get_pickup_pass (with the claim) fetches the pass again; order_status (with the claim) says whether it's ready.
+share_agentpickup: when the user wants to share agentPickup itself, invite a friend or get friends using it, shows a
+QR and link for them. That isn't a group order: start_group_order is only for ordering together at one shop.
+Group orders (a coffee run): start_group_order gives a code to share; each person's agent calls join_group_order and
+pays its own share with pay_order; at closing time the shop gets one combined order and the organiser gets its QR.
 group_order_status shows who's in; close_group_order closes it early.`;
 const money = (cents, currency) => new Intl.NumberFormat("en-US", { style: "currency", currency: currency.toUpperCase() }).format(cents / 100);
 const reply = (summary, data, card) => ({
@@ -168,6 +169,11 @@ export function createPickupMcpServer(opts) {
     }, async () => ({
         contents: [{ uri: CARD_URI, mimeType: CARD_MIME_TYPE, text: passCardHtml(VERSION), _meta: { ui: { prefersBorder: false } } }],
     }));
+    // Apps that loaded an older tool list (a phone that hasn't reconnected, a ChatGPT app version fixed at review) ask
+    // for an older version's card: they get today's.
+    server.registerResource("pickup-pass-earlier", new ResourceTemplate("ui://agentpickup/pass-{version}.html", { list: undefined }), { title: "Pickup pass", mimeType: CARD_MIME_TYPE, _meta: { ui: { prefersBorder: false } } }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: CARD_MIME_TYPE, text: passCardHtml(VERSION), _meta: { ui: { prefersBorder: false } } }],
+    }));
     if (opts.directoryUrl) {
         const directoryUrl = opts.directoryUrl;
         server.registerTool("find_shops", {
@@ -438,6 +444,9 @@ export function createPickupMcpServer(opts) {
     }, async () => ({
         contents: [{ uri: SHARE_URI, mimeType: CARD_MIME_TYPE, text: shareCardHtml(VERSION), _meta: { ui: { prefersBorder: false } } }],
     }));
+    server.registerResource("share-agentpickup-earlier", new ResourceTemplate("ui://agentpickup/share-{version}.html", { list: undefined }), { title: "Share agentPickup", mimeType: CARD_MIME_TYPE, _meta: { ui: { prefersBorder: false } } }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: CARD_MIME_TYPE, text: shareCardHtml(VERSION), _meta: { ui: { prefersBorder: false } } }],
+    }));
     server.registerTool("share_agentpickup", {
         title: "Share agentPickup",
         description: "A QR code and link the user can share so friends can add agentPickup to Claude, ChatGPT or Grok and order too. " +
@@ -476,8 +485,9 @@ export function createPickupMcpServer(opts) {
     };
     server.registerTool("start_group_order", {
         title: "Start a group order",
-        description: "Start a group order (a coffee run) at a shop. Returns a code to share: each person's agent joins with it and pays for " +
-            "their own items. When it closes, the shop gets one combined order and the organiser is emailed its pickup QR.",
+        description: "Start a group order (a coffee run) at a shop, when the user wants to order together with others now. Returns a code to " +
+            "share: each person's agent joins with it and pays for their own items. When it closes, the shop gets one combined order " +
+            "and the organiser is emailed its pickup QR. To share agentPickup itself with a friend, use share_agentpickup instead.",
         inputSchema: {
             organiser_name: z.string().min(1).max(60).describe("Who collects, shown to staff"),
             organiser_email: z.string().email().describe("Where the group's pickup QR goes"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentpickup/mcp",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "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",