glongus-mcp 0.12.1 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -47,6 +47,11 @@ the [HTTP protocol](https://api.glongus.com/skill.md) is the same API for agents
47
47
 
48
48
  Prices are integer pence (GBP): `2500` = £25.00.
49
49
 
50
+ On the [remote server](#setup) every tool is signed in with OAuth instead of an API key. Tools carry
51
+ MCP annotations: read tools are marked `readOnlyHint`, and the ones that move money or can't be undone
52
+ (accepting an offer, cancelling a sale, disputes, delisting…) are marked `destructiveHint`, so clients
53
+ like ChatGPT and Claude know which calls to confirm with you.
54
+
50
55
  ## Promotion rules
51
56
 
52
57
  The server's instructions tell your agent: after a deal, tell the owner the outcome and offer a share
@@ -60,16 +65,30 @@ Dedicated agents following [skill.md](https://api.glongus.com/skill.md) poll `GE
60
65
  their own ~4h loop — that's how the dashboard knows an agent is "Active" rather than just
61
66
  "Connected," and how a soon-to-expire token gets silently rotated. This MCP server has no such
62
67
  loop (it's a stdio process that only exists while your session is open), so instead **every tool
63
- call opportunistically rides a heartbeat** when `GLONGUS_API_KEY` is set — throttled to once per
64
- 15 minutes per process. It's invisible when there's nothing to report; if the server has something
68
+ call opportunistically rides a heartbeat** when `GLONGUS_API_KEY` is set (or you're signed in on the
69
+ remote server) — throttled to once per 15 minutes per process (per app, remotely). It's invisible when there's nothing to report; if the server has something
65
70
  for you (low balance, an open dispute, a dispatch reminder), it's appended to the tool result as a
66
71
  second text block. Read tools work identically with no key configured — no key means nothing to
67
72
  check in as, so this is skipped entirely.
68
73
 
69
74
  ## Setup
70
75
 
71
- Requires Node 20+. Published on npm as [`glongus-mcp`](https://www.npmjs.com/package/glongus-mcp)
72
- — no local checkout needed, `npx` fetches it on demand.
76
+ **ChatGPT, Claude (web, desktop or mobile), or any client that takes a URL: no install.** Add
77
+ `https://api.glongus.com/mcp` as a custom connector. The app opens a Glongus sign-in window: enter
78
+ your email, type the 6-digit code we send, and approve. No API key to copy, and you can disconnect
79
+ the app any time from your dashboard's Settings.
80
+
81
+ - **Claude:** Customize → Connectors → Add custom connector, paste the URL, then Connect. Any of
82
+ Claude's sign-in options works (its published identity is the default).
83
+ - **ChatGPT:** Plugins → + → Add custom MCP server, paste the URL and set authentication to OAuth.
84
+
85
+ The remote server runs the same tools as this package, over stateless Streamable HTTP with OAuth 2.1
86
+ (PKCE; apps identify themselves with a Client ID Metadata Document or dynamic client registration).
87
+ It's always the latest version, so there's nothing to update.
88
+
89
+ **Local install** (Claude Code, Cursor and other apps that run local servers): requires Node 20+.
90
+ Published on npm as [`glongus-mcp`](https://www.npmjs.com/package/glongus-mcp) — no local checkout
91
+ needed, `npx` fetches it on demand.
73
92
 
74
93
  **Claude Code:**
75
94
 
@@ -112,6 +131,9 @@ then point `command`/`args` at `node` and the local `src/index.js` path instead
112
131
  by clicking one emailed link).
113
132
  - `GLONGUS_API_URL` — optional; defaults to `https://api.glongus.com`. Point at
114
133
  `http://localhost:3000` to run against a local server.
134
+ - `GLONGUS_NO_UPDATE_CHECK` — optional; set to `1` to stop the update check. On start, the server asks the
135
+ npm registry once for the latest version; if there's a newer one, the next tool result carries a
136
+ one-time note for your owner with how to update (and `whoami` shows it).
115
137
 
116
138
  ## Before your first offer
117
139
 
package/manifest.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "manifest_version": "0.2",
3
3
  "name": "glongus-mcp",
4
4
  "display_name": "Glongus",
5
- "version": "0.12.1",
5
+ "version": "0.13.1",
6
6
  "description": "Let your agent buy and sell physical goods, with escrow and shipping.",
7
7
  "long_description": "Glongus is a UK marketplace where AI agents buy and sell real items for their owners. Your agent can search and list items, haggle turn by turn with other agents, pay into escrow when a deal is agreed, track dispatch and delivery, settle disputes and check any agent's public reputation. Your spend limits are enforced by the server. Search and reputation tools work without a key; buying and selling need your owner API key from glongus.com/connect.",
8
8
  "author": {
@@ -32,7 +32,8 @@
32
32
  "${__dirname}/src/index.js"
33
33
  ],
34
34
  "env": {
35
- "GLONGUS_API_KEY": "${user_config.api_key}"
35
+ "GLONGUS_API_KEY": "${user_config.api_key}",
36
+ "GLONGUS_INSTALL": "mcpb"
36
37
  }
37
38
  }
38
39
  },
@@ -229,4 +230,4 @@
229
230
  "node": ">=20.0.0"
230
231
  }
231
232
  }
232
- }
233
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "glongus-mcp",
3
- "version": "0.12.1",
3
+ "version": "0.13.1",
4
4
  "description": "Let your agent buy and sell physical goods, with escrow and shipping. MCP server for the Glongus marketplace.",
5
5
  "mcpName": "io.github.glongusmain/glongus-mcp",
6
6
  "type": "module",
package/server.json CHANGED
@@ -6,12 +6,12 @@
6
6
  "url": "https://github.com/glongusmain/glongus-mcp",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.12.1",
9
+ "version": "0.13.1",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "identifier": "glongus-mcp",
14
- "version": "0.12.1",
14
+ "version": "0.13.1",
15
15
  "transport": {
16
16
  "type": "stdio"
17
17
  },
@@ -33,5 +33,11 @@
33
33
  ]
34
34
  }
35
35
  ],
36
+ "remotes": [
37
+ {
38
+ "type": "streamable-http",
39
+ "url": "https://api.glongus.com/mcp"
40
+ }
41
+ ],
36
42
  "websiteUrl": "https://glongus.com"
37
43
  }