@curless/clubmed-demo 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# @curless/clubmed-demo
+
+A demo "Club Med Europe" storefront MCP server. Browses European Club Med
+resorts and books them through [agentbank](https://gitlab.com/robin-ruan/agentbank)
+acquiring (ACP). For demos/testing only.
+
+## Use (Claude Desktop / any MCP client)
+
+```json
+{
+  "mcpServers": {
+    "clubmed": {
+      "command": "npx",
+      "args": ["-y", "@curless/clubmed-demo"],
+      "env": {
+        "AGENTBANK_API_URL": "http://localhost:3000",
+        "AGENTBANK_AGENT_TOKEN": "agb_test_..."
+      }
+    }
+  }
+}
+```
+
+`AGENTBANK_AGENT_TOKEN` is an agentbank agent key (`agb_...`) with `agent:execute`.
+
+## Tools
+
+- `list_clubmed_resorts` — browse resorts (filter by country / ski|sun); shows
+  list price + the demo test price (1% of list).
+- `get_clubmed_resort` — one resort by sku.
+- `book_clubmed_resort` — book via an ACP checkout (moves money on the configured
+  rail; sandbox default token `pm_card_visa`).
+
+Env: `AGENTBANK_API_URL` (default `http://localhost:3000`),
+`CLUBMED_MERCHANT_ID` (default `curless_mch_clubmed_eu`).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+// @curless/clubmed-demo — a SIMULATED "Club Med Europe" storefront MCP. It
+// browses European Club Med resorts + prices and books them through agentbank's
+// acquiring (收单) over ACP. The resort catalog + its demo test pricing live in
+// the agentbank merchant `curless_mch_clubmed_eu`; this server reads that
+// catalog and books via an ACP checkout.
+//
+// Run (Claude Desktop / any MCP client):
+//   npx -y @curless/clubmed-demo
+// with env:
+//   AGENTBANK_API_URL   (default http://localhost:3000)
+//   AGENTBANK_AGENT_TOKEN  an agentbank agent key (agb_...) with agent:execute
+//   CLUBMED_MERCHANT_ID    (default curless_mch_clubmed_eu)
+//
+// IMPORTANT: only JSON-RPC may be written to stdout (the MCP stdio transport).
+// Never console.log here — diagnostics go to stderr.
+const API_BASE = process.env.AGENTBANK_API_URL ?? 'http://localhost:3000';
+const TOKEN = process.env.AGENTBANK_AGENT_TOKEN;
+const MERCHANT = process.env.CLUBMED_MERCHANT_ID ?? 'curless_mch_clubmed_eu';
+const api = async (path, init = {}) => {
+    const res = await fetch(`${API_BASE}${path}`, {
+        ...init,
+        headers: {
+            'content-type': 'application/json',
+            ...(TOKEN ? { authorization: `Bearer ${TOKEN}` } : {}),
+            ...(init.headers ?? {}),
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`agentbank ${path} -> ${res.status}: ${await res.text().catch(() => '')}`);
+    }
+    return (await res.json());
+};
+const eur = (minor) => `€${(minor / 100).toLocaleString('en-IE', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+const view = (it) => {
+    const list = it.attributes.listPriceMinor ?? it.price;
+    return {
+        sku: it.sku,
+        name: it.name,
+        country: it.attributes.country,
+        kind: it.attributes.kind,
+        description: it.description,
+        currency: it.currency,
+        listPrice: eur(list),
+        price: eur(it.price), // demo test charge = 1% of list
+        note: 'demo test price = 1% of list (so sandbox charges stay tiny)',
+        available: it.available,
+    };
+};
+const loadCatalog = async () => {
+    const { items } = await api(`/v1/merchants/${encodeURIComponent(MERCHANT)}/catalog`);
+    return items;
+};
+const TOOLS = [
+    {
+        name: 'list_clubmed_resorts',
+        description: 'Browse Club Med Europe resorts — shows the list price + the demo test price (1% of list, so sandbox charges stay tiny). Optional country (FR/IT/ES/PT) or kind (ski|sun) filter.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                country: { type: 'string', description: 'ISO-2, e.g. FR / IT / ES / PT' },
+                kind: { type: 'string', enum: ['ski', 'sun'] },
+            },
+        },
+    },
+    {
+        name: 'get_clubmed_resort',
+        description: 'Get one Club Med Europe resort by its sku (from list_clubmed_resorts).',
+        inputSchema: {
+            type: 'object',
+            required: ['sku'],
+            properties: { sku: { type: 'string' } },
+        },
+    },
+    {
+        name: 'book_clubmed_resort',
+        description: 'Book a Club Med Europe resort — this MOVES MONEY through agentbank acquiring (ACP). Creates a checkout session for the resort and pays it with a delegated token (sandbox default pm_card_visa). Returns the order. The charged amount is the demo test price (1% of list).',
+        inputSchema: {
+            type: 'object',
+            required: ['sku'],
+            properties: {
+                sku: { type: 'string' },
+                quantity: { type: 'integer', description: 'number of guests/weeks (default 1)' },
+                paymentToken: { type: 'string', description: "delegated token; default 'pm_card_visa'" },
+            },
+        },
+    },
+];
+const text = (value) => ({
+    content: [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+});
+const server = new Server({ name: 'clubmed-europe', version: '0.1.0' }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const args = (req.params.arguments ?? {});
+    try {
+        if (req.params.name === 'list_clubmed_resorts') {
+            const country = typeof args.country === 'string' ? args.country.toUpperCase() : undefined;
+            const kind = typeof args.kind === 'string' ? args.kind : undefined;
+            const resorts = (await loadCatalog())
+                .filter((it) => (country ? it.attributes.country === country : true))
+                .filter((it) => (kind ? it.attributes.kind === kind : true))
+                .map(view);
+            return text({ merchant: MERCHANT, currency: 'EUR', count: resorts.length, resorts });
+        }
+        if (req.params.name === 'get_clubmed_resort') {
+            const sku = String(args.sku ?? '');
+            const it = (await loadCatalog()).find((r) => r.sku === sku);
+            if (!it) {
+                return { content: [{ type: 'text', text: `no resort with sku ${sku}` }], isError: true };
+            }
+            return text(view(it));
+        }
+        if (req.params.name === 'book_clubmed_resort') {
+            const sku = String(args.sku ?? '');
+            const quantity = Math.max(Number(args.quantity) || 1, 1);
+            const token = typeof args.paymentToken === 'string' ? args.paymentToken : 'pm_card_visa';
+            const base = `/acp/${encodeURIComponent(MERCHANT)}/checkout_sessions`;
+            const session = await api(base, {
+                method: 'POST',
+                body: JSON.stringify({ items: [{ id: sku, quantity }] }),
+            });
+            const order = await api(`${base}/${encodeURIComponent(session.id)}/complete`, {
+                method: 'POST',
+                body: JSON.stringify({ payment_data: { token, provider: 'stripe' } }),
+            });
+            return text({ booked: true, order });
+        }
+        return { content: [{ type: 'text', text: `unknown tool: ${req.params.name}` }], isError: true };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+});
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@curless/clubmed-demo",
+  "version": "0.1.0",
+  "description": "Demo Club Med Europe storefront MCP — browse resorts and book them through agentbank acquiring (ACP).",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "clubmed-demo": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "clubmed",
+    "agentbank",
+    "demo",
+    "claude",
+    "acp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/robin-ruan/agentbank.git",
+    "directory": "packages/clubmed-demo"
+  },
+  "author": "robin",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}