mcpspan-mcp 0.14.0 → 0.15.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
@@ -156,6 +156,7 @@ 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. |
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.",
@@ -412,7 +434,7 @@ async function answer(work) {
412
434
  //#endregion
413
435
  //#region src/version.ts
414
436
  /** This package's version, as its server names itself to clients. Kept in step by the release script. */
415
- const VERSION = "0.14.0";
437
+ const VERSION = "0.15.1";
416
438
  //#endregion
417
439
  //#region src/server.ts
418
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.14.0",
3
+ "version": "0.15.1",
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",