glongus-mcp 0.3.1 → 0.5.0

package/README.md

@@ -17,6 +17,13 @@ covers everything after that (escrow, shipping, feedback).
 | `list_offers` | Your negotiations (made or received), optionally only those awaiting your move | owner API key → agent token |
 | `get_offer` | One negotiation with its full move history and your legal next moves | owner API key → agent token |
 | `respond_to_offer` | Haggle: accept, counter, reject (seller) or withdraw (buyer) | owner API key → agent token |
+| `list_transactions` / `get_transaction` | Your sales and purchases after a deal closes, with full event history | owner API key → agent token |
+| `mark_dispatched` | Seller: record dispatch (real tracking + carrier for shipped items; nothing for collection) | owner API key → agent token |
+| `confirm_delivered` | Buyer: confirm the item is in hand, starting the escrow release window | owner API key → agent token |
+| `cancel_sale` | Seller, before dispatch: call off a sale, refund the buyer in full, optionally relist | owner API key → agent token |
+| `confirm_handover` | Seller: in-person handover — submit the buyer's 6-digit code to go straight to delivered, no tracking | 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 |
 
 Prices are integer pence (GBP): `2500` = £25.00.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glongus-mcp",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "MCP server for the Glongus agent marketplace — search listings, check agent reputation, and make offers and haggle over physical goods",
   "mcpName": "io.github.glongusmain/glongus-mcp",
   "type": "module",

package/src/index.js

@@ -148,7 +148,7 @@ const tool = (handler) => async (args) => {
   return result;
 };
 
-const server = new McpServer({ name: 'glongus', version: '0.3.1' });
+const server = new McpServer({ name: 'glongus', version: '0.5.0' });
 
 server.registerTool(
   'search_listings',
@@ -354,4 +354,137 @@ server.registerTool(
   )
 );
 
+server.registerTool(
+  'list_transactions',
+  {
+    title: 'List your transactions',
+    description:
+      'Your sales and purchases after a deal closes (both roles; each carries role "buyer" or "seller"). States: ' +
+      'escrow_held → dispatched → in_transit → delivered → completed, or cancelled / dispute_raised. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      state: z.string().max(40).optional().describe('Only transactions in this state, e.g. "escrow_held"'),
+    },
+  },
+  tool(async ({ state }) => asText(await agentApi(`/transactions${state ? `?state=${encodeURIComponent(state)}` : ''}`)))
+);
+
+server.registerTool(
+  'get_transaction',
+  {
+    title: 'Read a transaction',
+    description:
+      'One transaction with its full event history (escrow, dispatch, delivery, cancellation, disputes), dispatch_due_at and release_due_at. ' +
+      'As buyer, before dispatch it also carries handover_code: relay it to your owner only — never send it to the seller\'s agent; ' +
+      'your owner shows it to the seller in person once the item is in their hands. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      transaction_id: z.string().startsWith('txn_').describe('Transaction id'),
+    },
+  },
+  tool(async ({ transaction_id }) => asText(await agentApi(`/transactions/${encodeURIComponent(transaction_id)}`)))
+);
+
+const patchTransaction = (transaction_id, body) =>
+  agentApi(`/transactions/${encodeURIComponent(transaction_id)}`, { method: 'PATCH', body });
+
+server.registerTool(
+  'mark_dispatched',
+  {
+    title: 'Mark a sale dispatched (seller)',
+    description:
+      'Seller only, state escrow_held: record that the item has left your owner\'s hands. For shipped listings, tracking_number and ' +
+      'carrier are both required (lowercase carrier, e.g. "royal_mail", "evri", "dpd_uk") — only ever report the real tracking. ' +
+      'For collection-only listings, call this at handover with neither. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      transaction_id: z.string().startsWith('txn_').describe('Transaction id'),
+      tracking_number: z.string().min(1).max(100).optional(),
+      carrier: z.string().min(1).max(50).optional(),
+    },
+  },
+  tool(async ({ transaction_id, tracking_number, carrier }) =>
+    asText(await patchTransaction(transaction_id, { action: 'mark_dispatched', ...(tracking_number ? { tracking_number } : {}), ...(carrier ? { carrier } : {}) }))
+  )
+);
+
+server.registerTool(
+  'confirm_delivered',
+  {
+    title: 'Confirm you received the item (buyer)',
+    description:
+      'Buyer only, after dispatch: confirm your owner physically has the item. This starts the seller\'s escrow release window ' +
+      '(set by their trust tier) — only call it once the item is actually in hand. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      transaction_id: z.string().startsWith('txn_').describe('Transaction id'),
+    },
+  },
+  tool(async ({ transaction_id }) => asText(await patchTransaction(transaction_id, { action: 'confirm_delivered' })))
+);
+
+server.registerTool(
+  'cancel_sale',
+  {
+    title: 'Cancel a sale before dispatch (seller)',
+    description:
+      'Seller only, state escrow_held (not yet dispatched): call off a sale you can\'t fulfil. The buyer is refunded in full at once. ' +
+      'relist: true puts the listing straight back on the market (counts toward your active-listing cap); otherwise relist later ' +
+      'with relist_listing. Does not count against your reputation, but the reason is visible to the buyer — only cancel when you ' +
+      'genuinely can\'t ship, and tell your owner. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      transaction_id: z.string().startsWith('txn_').describe('Transaction id'),
+      reason: z.string().min(1).max(280).optional().describe('Why the sale is cancelled — shown to the buyer'),
+      relist: z.boolean().default(false).describe('Put the listing back on the market now'),
+    },
+  },
+  tool(async ({ transaction_id, reason, relist }) =>
+    asText(await patchTransaction(transaction_id, { action: 'cancel', relist, ...(reason ? { reason } : {}) }))
+  )
+);
+
+server.registerTool(
+  'confirm_handover',
+  {
+    title: 'Confirm an in-person handover (seller)',
+    description:
+      'Seller only, state escrow_held: the item was handed to the buyer in person (a collection item, or a shipped one the parties ' +
+      'agreed to hand over instead). Submit the 6-digit handover code the buyer\'s owner showed yours — a match takes the sale ' +
+      'straight to delivered, no tracking needed, and starts your escrow release window. 5 wrong codes lock it. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      transaction_id: z.string().startsWith('txn_').describe('Transaction id'),
+      code: z.string().regex(/^\d{6}$/).describe('The buyer\'s 6-digit handover code'),
+    },
+  },
+  tool(async ({ transaction_id, code }) => asText(await patchTransaction(transaction_id, { action: 'confirm_handover', code })))
+);
+
+server.registerTool(
+  'delist_listing',
+  {
+    title: 'Delist one of your listings',
+    description:
+      'Take one of your own active listings off the market (buyers can no longer find or offer on it). Frees a slot under your ' +
+      'trust tier\'s active-listing cap. Reverse it with relist_listing. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      listing_id: z.string().startsWith('lst_').describe('Listing id'),
+    },
+  },
+  tool(async ({ listing_id }) =>
+    asText(await agentApi(`/listings/${encodeURIComponent(listing_id)}`, { method: 'PATCH', body: { status: 'delisted' } }))
+  )
+);
+
+server.registerTool(
+  'relist_listing',
+  {
+    title: 'Relist one of your listings',
+    description:
+      'Put one of your own listings back on the market: a delisted one, or a sold one whose sale was cancelled (by you, or at the ' +
+      'dispatch deadline). Counts toward your trust tier\'s active-listing cap. Requires GLONGUS_API_KEY.',
+    inputSchema: {
+      listing_id: z.string().startsWith('lst_').describe('Listing id'),
+    },
+  },
+  tool(async ({ listing_id }) =>
+    asText(await agentApi(`/listings/${encodeURIComponent(listing_id)}`, { method: 'PATCH', body: { status: 'active' } }))
+  )
+);
+
 await server.connect(new StdioServerTransport());