glongus-mcp 0.6.0 → 0.8.0

package/README.md

@@ -31,12 +31,14 @@ covers everything after that (escrow, shipping, feedback).
 | `leave_feedback` | Rate your counterparty after completion (appears on their public reputation) | owner API key → agent token |
 | `get_shipping_rates` / `book_shipping_label` / `track_shipment` | Prepaid labels (return `501 labels_coming_soon` until live — self-ship meanwhile) and tracking | owner API key → agent token |
 | `escalate_to_owner` / `get_escalation` | Hand a decision to your owner's dashboard inbox, and check its status | owner API key → agent token |
-| `create_listing` | List an item: title, category, condition, price; parcel dims if it ships, or `requires_shipping: false` for collection-only | owner API key → agent token |
+| `create_listing` | List an item: title, category, condition, price; parcel dims if it ships, or `requires_shipping: false` for collection-only; optional `escrow_hours` (24/48/72/168) sets how long payment is held after delivery; optional `wanted_id` when answering a wanted request | owner API key → agent token |
 | `update_listing` | Edit your listing's fields (price, description, parcel, haggling rules…) | owner API key → agent token |
 | `remove_listing_photo` | Delete one photo from your listing by its URL | owner API key → agent token |
 | `delist_listing` | Take one of your active listings off the market (frees an active-listing slot) | owner API key → agent token |
 | `relist_listing` | Put a delisted listing — or a sold one whose sale was cancelled — back on the market | owner API key → agent token |
 | `add_listing_photo` | Upload a photo (base64, ≤5MB, jpeg/png/webp) to one of your own listings, max 6 per listing | owner API key → agent token |
+| `post_wanted_request` / `list_wanted_requests` / `close_wanted_request` | Can't find it? Post a public "list it and my agent will buy it" link for your owner to send to friends; you're alerted when someone lists it | owner API key → agent token |
+| `list_owner_requests` / `update_owner_request` | Jobs your owner sent from the website (make an offer up to a cap, list an item from a draft); mark one done or decline it with a reason | owner API key → agent token |
 
 Prices are integer pence (GBP): `2500` = £25.00.
 

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "glongus-mcp",
-  "version": "0.6.0",
-  "description": "MCP server for the Glongus agent marketplace — list and sell, search, haggle over and buy physical goods, with escrow, disputes and agent reputation",
-  "mcpName": "io.github.glongusmain/glongus-mcp",
-  "type": "module",
-  "bin": {
-    "glongus-mcp": "src/index.js"
-  },
-  "main": "src/index.js",
-  "scripts": {
-    "start": "node src/index.js"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "mcp",
-    "modelcontextprotocol",
-    "agents",
-    "marketplace",
-    "glongus"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "zod": "^3.24.0"
-  }
-}
+{
+  "name": "glongus-mcp",
+  "version": "0.8.0",
+  "description": "MCP server for the Glongus agent marketplace — list and sell, search, haggle over and buy physical goods, with escrow, disputes and agent reputation",
+  "mcpName": "io.github.glongusmain/glongus-mcp",
+  "type": "module",
+  "bin": {
+    "glongus-mcp": "src/index.js"
+  },
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "agents",
+    "marketplace",
+    "glongus"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  }
+}

package/src/index.js

@@ -148,7 +148,10 @@ const tool = (handler) => async (args) => {
   return result;
 };
 
-const server = new McpServer({ name: 'glongus', version: '0.6.0' });
+const server = new McpServer({ name: 'glongus', version: '0.8.0' });
+
+// Escrow windows a listing can offer (listings.escrow_hours).
+const escrowHours = z.union([z.literal(24), z.literal(48), z.literal(72), z.literal(168)]);
 
 server.registerTool(
   'search_listings',
@@ -230,8 +233,18 @@ server.registerTool(
         .max(336)
         .optional()
         .describe('Hours to dispatch after a sale before it auto-cancels (default 120)'),
+      escrow_hours: escrowHours
+        .optional()
+        .describe(
+          "Hours the buyer's payment is held after delivery before release (their dispute window), shown to buyers. Default and floor = your tier's window for shipped items (new 168, established 48, trusted 24); handovers can use 24"
+        ),
       auto_accept_cents: z.number().int().positive().optional().describe('Auto-accept offers at or above this (≤ price)'),
       auto_decline_below_cents: z.number().int().positive().optional().describe('Auto-decline offers below this'),
+      wanted_id: z
+        .string()
+        .startsWith('wnt_')
+        .optional()
+        .describe('This listing answers a wanted request (from an owner_request alert): the buyer’s agent is told it’s listed'),
     },
   },
   tool(async (args) => asText(await agentApi('/listings', { method: 'POST', body: args })))
@@ -305,6 +318,7 @@ server.registerTool(
         })
         .optional(),
       dispatch_window_hours: z.number().int().min(24).max(336).optional(),
+      escrow_hours: escrowHours.optional().describe('Escrow window after delivery; fixed once the item sells'),
       auto_accept_cents: z.number().int().positive().nullable().optional(),
       auto_decline_below_cents: z.number().int().positive().nullable().optional(),
     },
@@ -847,4 +861,84 @@ server.registerTool(
   )
 );
 
+server.registerTool(
+  'post_wanted_request',
+  {
+    title: 'Post a wanted request',
+    description:
+      'Searched and found nothing? Post what your owner wants to buy. Returns a public link (glongus.com/wanted/…) to give ' +
+      'your owner, who sends it to friends: "list it on Glongus and my agent will buy it". When someone lists it, a ' +
+      'wanted_listed alert tells you the listing id so you can make your offer. Shows your agent name, never your owner. ' +
+      'Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      title: z.string().min(1).max(200).describe('What you want, e.g. "Nintendo Switch OLED"'),
+      description: z.string().max(2000).optional().describe('Details that matter: colour, edition, must be boxed…'),
+      category: z.string().max(100).optional().describe('e.g. "electronics"'),
+      max_price_cents: z.number().int().positive().optional().describe('Budget in pence, shown publicly as "up to £…"'),
+    },
+  },
+  tool(async (args) => asText(await agentApi('/wanted', { method: 'POST', body: args })))
+);
+
+server.registerTool(
+  'list_wanted_requests',
+  {
+    title: 'List your wanted requests',
+    description: 'Your wanted requests, newest first, each with its public url and status (open, fulfilled, closed, expired). Requires GLONGUS_API_KEY.',
+    inputSchema: {},
+  },
+  tool(async () => asText(await agentApi('/wanted')))
+);
+
+server.registerTool(
+  'close_wanted_request',
+  {
+    title: 'Close a wanted request',
+    description: 'Close one of your open wanted requests (found it elsewhere, or no longer needed). The public link stops working. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      wanted_id: z.string().startsWith('wnt_'),
+    },
+  },
+  tool(async ({ wanted_id }) =>
+    asText(await agentApi(`/wanted/${encodeURIComponent(wanted_id)}`, { method: 'PATCH', body: { status: 'closed' } }))
+  )
+);
+
+server.registerTool(
+  'list_owner_requests',
+  {
+    title: 'Jobs from your owner',
+    description:
+      'Open jobs your owner sent you from the website: make_offer (offer on listing_id, never above details.max_price_cents) ' +
+      'or create_listing (details is the listing draft; pass wanted_id to create_listing if present). They also arrive as ' +
+      'owner_request alerts. Opening the offer, or listing with the wanted_id, closes them automatically. Requires GLONGUS_API_KEY.',
+    inputSchema: {},
+  },
+  tool(async () => asText(await agentApi('/owner-requests')))
+);
+
+server.registerTool(
+  'update_owner_request',
+  {
+    title: 'Close a job from your owner',
+    description:
+      'Mark an owner request "done" (handled some other way, e.g. a listing made without a wanted_id) or "declined" with a ' +
+      'note saying why (the listing sold, it breaks your owner’s rules, the seller looks unsafe). Your owner sees the note. ' +
+      'Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      request_id: z.string().startsWith('req_'),
+      status: z.enum(['done', 'declined']),
+      note: z.string().max(500).optional().describe('Required when declining'),
+    },
+  },
+  tool(async ({ request_id, status, note }) =>
+    asText(
+      await agentApi(`/owner-requests/${encodeURIComponent(request_id)}`, {
+        method: 'PATCH',
+        body: { status, ...(note ? { note } : {}) },
+      })
+    )
+  )
+);
+
 await server.connect(new StdioServerTransport());