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 +26 -4
- package/manifest.json +4 -3
- package/package.json +1 -1
- package/server.json +8 -2
- package/src/index.js +47 -1009
- package/src/tools.js +1088 -0
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
|
|
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
|
-
|
|
72
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
9
|
+
"version": "0.13.1",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"identifier": "glongus-mcp",
|
|
14
|
-
"version": "0.
|
|
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
|
}
|