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 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. Then Connect. |
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.13.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.13.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.11"
49
+ "vitest": "4.1.12"
50
50
  },
51
51
  "scripts": {
52
52
  "build": "tsdown",