mcpspan-mcp 0.13.0 → 0.14.0
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 +2 -1
- package/dist/index.mjs +35 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -39,7 +39,7 @@ The address is `https://api.mcpspan.com/mcp`.
|
|
|
39
39
|
|
|
40
40
|
| Agent | How |
|
|
41
41
|
|---|---|
|
|
42
|
-
| claude.ai, Claude Desktop, the Claude apps | Settings → Connectors → Add custom connector, with the address.
|
|
42
|
+
| claude.ai, Claude Desktop, the Claude apps | Settings → Connectors → Browse connectors, find mcpspan, and Connect. Or Add custom connector, with the address. |
|
|
43
43
|
| ChatGPT | In its connector settings (developer mode), a new connector with the address, signing in with OAuth. |
|
|
44
44
|
| Claude Code | `claude mcp add --transport http mcpspan https://api.mcpspan.com/mcp`, then `/mcp` in Claude Code to sign in. |
|
|
45
45
|
| Cursor | In `mcp.json`: `{"mcpServers": {"mcpspan": {"url": "https://api.mcpspan.com/mcp"}}}` |
|
|
@@ -159,6 +159,7 @@ account has one) and a window: `days` back from now (7 when left out), or
|
|
|
159
159
|
| `get_tool_listing` | What agents were shown: tools never used, and what their definitions cost. |
|
|
160
160
|
| `list_sessions` | Recent sessions, with failures and repeated calls. |
|
|
161
161
|
| `get_session` | One session's calls, in order. |
|
|
162
|
+
| `get_where_agents_get_lost` | What came of each session, the tools agents got stuck at and what they did next; for one tool, by client. |
|
|
162
163
|
|
|
163
164
|
A token can be revoked at any time under **Settings → Read tokens**, and an app
|
|
164
165
|
disconnected under **Settings → Connected apps**; either loses access at once.
|
package/dist/index.mjs
CHANGED
|
@@ -268,6 +268,40 @@ function registerTools(mcp, api) {
|
|
|
268
268
|
sampled: result.sampled
|
|
269
269
|
});
|
|
270
270
|
}));
|
|
271
|
+
mcp.registerTool("get_where_agents_get_lost", {
|
|
272
|
+
title: "Where agents get lost",
|
|
273
|
+
description: "Where agents got stuck and what they did about it. A time stuck is a failed tool call and the retries of the same tool straight after it; each ends recovered (the tool then worked, with meanRetries retries on average), wentElsewhere (the agent called something else, insteadMostOften), endedOnIt (the session stopped there, nothing for 30 minutes) or undecided (too recent to tell); looped counts those where a retry repeated the same arguments. Without a tool: every session by the worst that happened in it (clean, recovered, wentElsewhere, looped, endedOnFailure, undecided) and the tools agents got stuck at, worst first. With a tool: that tool's times stuck, as a whole and by client.",
|
|
274
|
+
inputSchema: z.object({
|
|
275
|
+
...scope,
|
|
276
|
+
client,
|
|
277
|
+
tool: z.string().optional().describe("Only this tool, split by client. The tool's name, as list_tools gives it.")
|
|
278
|
+
}),
|
|
279
|
+
annotations: READ_ONLY
|
|
280
|
+
}, (args) => answer(async () => {
|
|
281
|
+
const at = await locate(api, args);
|
|
282
|
+
if (args.tool !== void 0) {
|
|
283
|
+
const result = await api.get("/v1/dashboard/lost/tool", at.query({ toolName: args.tool }));
|
|
284
|
+
return at.describe(result.tool === null ? {
|
|
285
|
+
toolName: args.tool,
|
|
286
|
+
note: "Agents never got stuck at this tool in this window."
|
|
287
|
+
} : {
|
|
288
|
+
toolName: args.tool,
|
|
289
|
+
...result.tool,
|
|
290
|
+
clients: result.clients,
|
|
291
|
+
sampled: result.sampled
|
|
292
|
+
});
|
|
293
|
+
}
|
|
294
|
+
const result = await api.get("/v1/dashboard/lost", at.query({
|
|
295
|
+
clientType: args.client,
|
|
296
|
+
limit: 20
|
|
297
|
+
}));
|
|
298
|
+
return at.describe({
|
|
299
|
+
sessions: result.sessions,
|
|
300
|
+
tools: result.tools,
|
|
301
|
+
more: result.hasMore,
|
|
302
|
+
sampled: result.sampled
|
|
303
|
+
});
|
|
304
|
+
}));
|
|
271
305
|
mcp.registerTool("get_session", {
|
|
272
306
|
title: "Session",
|
|
273
307
|
description: "One session's calls in the order the agent made them, with each call's outcome and error.",
|
|
@@ -378,7 +412,7 @@ async function answer(work) {
|
|
|
378
412
|
//#endregion
|
|
379
413
|
//#region src/version.ts
|
|
380
414
|
/** This package's version, as its server names itself to clients. Kept in step by the release script. */
|
|
381
|
-
const VERSION = "0.
|
|
415
|
+
const VERSION = "0.14.0";
|
|
382
416
|
//#endregion
|
|
383
417
|
//#region src/server.ts
|
|
384
418
|
/** The MCP server, answering from one mcpspan account through its read token. */
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcpspan-mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"description": "Ask your AI agent about your MCP servers: which tools fail, how a release compares, what clients look for and do not find. Reads from mcpspan with a read token.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
"pg": "^8.23.0",
|
|
47
47
|
"tsdown": "^0.23.0",
|
|
48
48
|
"typescript": "^6.0.3",
|
|
49
|
-
"vitest": "4.1.
|
|
49
|
+
"vitest": "4.1.12"
|
|
50
50
|
},
|
|
51
51
|
"scripts": {
|
|
52
52
|
"build": "tsdown",
|