What changed between two snapshots
const url = 'https://beta-api.plune.ai/v1/mcp-servers/example/snapshots/diff?from=1&to=1';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://beta-api.plune.ai/v1/mcp-servers/example/snapshots/diff?from=1&to=1' \ --header 'Authorization: Bearer <token>'The changes between two snapshots of ONE server, tool by tool, each breaking, non-breaking or informational, in either order. A tool that is gone and a new required parameter are breaking. A description that changed is informational and carries signal: security. A change no rule knows is informational and unclassified, never called safe. Two snapshots with no tool are not-measured, not unchanged. Anyone in the project.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The server’s id
Query Parameters
Section titled “Query Parameters ”The number of the earlier snapshot
The number of the later snapshot
Responses
Section titled “ Responses ”The diff
object
object
object
changed - a tool differs. unchanged - both snapshots list tools and the tools are the same. not-measured - neither lists a tool: there is nothing to compare, which is not the same as nothing having changed
Why state is not-measured, or that one snapshot lists no tool
One entry a tool that came, went or differs, by name
object
The worst class among fields
object
tool when it came or went, else what changed: description, title, annotations.<hint>, a schema path such as inputSchema.filter.kind
One sentence
The change is to what a model reads (a description) or is allowed to do (a hint): a reason to look, whatever the class
No rule knew the change: it is informational because it could not be called safe or breaking
object
The worst class among the changes; none without changes
Sections other than the tools that differ: said, not classified
Example
{ "serverId": "6f1c2b3a-0000-4000-8000-000000002458", "from": { "id": "6f1c2b3a-0000-4000-8000-000000002460", "number": 1, "hash": "b7e2c4a19d3f58601a4c9e7d2b5f8031c6a9d4e7f1b2035a8c6d9e0f3a41b72c" }, "to": { "id": "6f1c2b3a-0000-4000-8000-000000002460", "number": 2, "hash": "b7e2c4a19d3f58601a4c9e7d2b5f8031c6a9d4e7f1b2035a8c6d9e0f3a41b72c" }, "state": "changed", "changes": [ { "tool": "get_order", "kind": "changed", "class": "breaking", "fields": [ { "field": "inputSchema.region", "class": "breaking", "reason": "A new required parameter: every existing call now fails without it." } ] } ], "summary": { "breaking": 1, "non-breaking": 0, "informational": 0, "overall": "breaking" }, "otherSections": []}from and to are not the numbers of two snapshots
object
Example generated
{ "error": "example"}No / invalid token or session
No such server in your project, or a snapshot that is not on it
object
Example generated
{ "error": "example"}