mcpspan-mcp 0.13.0 → 0.15.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 +3 -1
- package/dist/index.mjs +57 -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"}}}` |
|
|
@@ -156,9 +156,11 @@ account has one) and a window: `days` back from now (7 when left out), or
|
|
|
156
156
|
| `list_unknown_tools` | Tools agents asked for that the server lacks, the closest one it has, and what the agent did next. |
|
|
157
157
|
| `list_clients` | Each client's calls, error rate and response times. |
|
|
158
158
|
| `compare_versions` | The server's releases side by side. |
|
|
159
|
+
| `get_release_report` | Did a release make things worse: a version against the one before it, tool by tool. |
|
|
159
160
|
| `get_tool_listing` | What agents were shown: tools never used, and what their definitions cost. |
|
|
160
161
|
| `list_sessions` | Recent sessions, with failures and repeated calls. |
|
|
161
162
|
| `get_session` | One session's calls, in order. |
|
|
163
|
+
| `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
164
|
|
|
163
165
|
A token can be revoked at any time under **Settings → Read tokens**, and an app
|
|
164
166
|
disconnected under **Settings → Connected apps**; either loses access at once.
|
package/dist/index.mjs
CHANGED
|
@@ -223,6 +223,28 @@ function registerTools(mcp, api) {
|
|
|
223
223
|
const result = await api.get("/v1/dashboard/versions", at.query({ clientType: args.client }));
|
|
224
224
|
return at.describe(pick(result, ["versions", "unversionedCalls"]));
|
|
225
225
|
}));
|
|
226
|
+
mcp.registerTool("get_release_report", {
|
|
227
|
+
title: "Release report",
|
|
228
|
+
description: "Did a release make things worse: one server version against the one before it. The new version's calls from its first one (releasedAt), for up to 7 days or until a newer version came, against the previous version's calls over a period as long right before it. verdict is worse, same, better, too-early (under 50 calls on a side) or first (no earlier version); worse means errors rose by more than a point and more than chance, or p95 slowed by a quarter. Also: tools with their numbers either side, worst change first (definitionChanged when the description or schema changed with it; refused counts calls whose arguments the schema refused), newFailures (kinds of failure the previous version did not have), agents (what became of sessions either side), clients (share of calls either side; clientsShifted when the mix moved enough to change the numbers), and otherVersionCalls (calls after the release from another version).",
|
|
229
|
+
inputSchema: z.object({
|
|
230
|
+
server,
|
|
231
|
+
client,
|
|
232
|
+
version: z.string().optional().describe("The version to report on, as compare_versions gives it. The newest when left out.")
|
|
233
|
+
}),
|
|
234
|
+
annotations: READ_ONLY
|
|
235
|
+
}, (args) => answer(async () => {
|
|
236
|
+
const { servers } = await api.get("/v1/servers");
|
|
237
|
+
const chosen = pickServer(servers, args.server);
|
|
238
|
+
const result = await api.get("/v1/dashboard/release", {
|
|
239
|
+
serverId: chosen.id,
|
|
240
|
+
clientType: args.client,
|
|
241
|
+
version: args.version
|
|
242
|
+
});
|
|
243
|
+
return {
|
|
244
|
+
server: chosen.name,
|
|
245
|
+
...result
|
|
246
|
+
};
|
|
247
|
+
}));
|
|
226
248
|
mcp.registerTool("get_tool_listing", {
|
|
227
249
|
title: "What agents are shown",
|
|
228
250
|
description: "Every tool as agents were shown it when they listed the tools: in how many sessions, how many of those called it, and how large its definition is. Finds tools agents see but never use, and definitions that cost context.",
|
|
@@ -268,6 +290,40 @@ function registerTools(mcp, api) {
|
|
|
268
290
|
sampled: result.sampled
|
|
269
291
|
});
|
|
270
292
|
}));
|
|
293
|
+
mcp.registerTool("get_where_agents_get_lost", {
|
|
294
|
+
title: "Where agents get lost",
|
|
295
|
+
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.",
|
|
296
|
+
inputSchema: z.object({
|
|
297
|
+
...scope,
|
|
298
|
+
client,
|
|
299
|
+
tool: z.string().optional().describe("Only this tool, split by client. The tool's name, as list_tools gives it.")
|
|
300
|
+
}),
|
|
301
|
+
annotations: READ_ONLY
|
|
302
|
+
}, (args) => answer(async () => {
|
|
303
|
+
const at = await locate(api, args);
|
|
304
|
+
if (args.tool !== void 0) {
|
|
305
|
+
const result = await api.get("/v1/dashboard/lost/tool", at.query({ toolName: args.tool }));
|
|
306
|
+
return at.describe(result.tool === null ? {
|
|
307
|
+
toolName: args.tool,
|
|
308
|
+
note: "Agents never got stuck at this tool in this window."
|
|
309
|
+
} : {
|
|
310
|
+
toolName: args.tool,
|
|
311
|
+
...result.tool,
|
|
312
|
+
clients: result.clients,
|
|
313
|
+
sampled: result.sampled
|
|
314
|
+
});
|
|
315
|
+
}
|
|
316
|
+
const result = await api.get("/v1/dashboard/lost", at.query({
|
|
317
|
+
clientType: args.client,
|
|
318
|
+
limit: 20
|
|
319
|
+
}));
|
|
320
|
+
return at.describe({
|
|
321
|
+
sessions: result.sessions,
|
|
322
|
+
tools: result.tools,
|
|
323
|
+
more: result.hasMore,
|
|
324
|
+
sampled: result.sampled
|
|
325
|
+
});
|
|
326
|
+
}));
|
|
271
327
|
mcp.registerTool("get_session", {
|
|
272
328
|
title: "Session",
|
|
273
329
|
description: "One session's calls in the order the agent made them, with each call's outcome and error.",
|
|
@@ -378,7 +434,7 @@ async function answer(work) {
|
|
|
378
434
|
//#endregion
|
|
379
435
|
//#region src/version.ts
|
|
380
436
|
/** This package's version, as its server names itself to clients. Kept in step by the release script. */
|
|
381
|
-
const VERSION = "0.
|
|
437
|
+
const VERSION = "0.15.0";
|
|
382
438
|
//#endregion
|
|
383
439
|
//#region src/server.ts
|
|
384
440
|
/** 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.15.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",
|