Skip to content

What changed between two snapshots

GET
/v1/mcp-servers/{id}/snapshots/diff
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.

id
required
string

The server’s id

from
required
integer
>= 1

The number of the earlier snapshot

to
required
integer
>= 1

The number of the later snapshot

The diff

Media type application/json
object
serverId
required
string
from
required
object
id
required
string
number
required
integer
hash
required
string
to
required
object
id
required
string
number
required
integer
hash
required
string
state
required

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

string
Allowed values: changed unchanged not-measured
reason

Why state is not-measured, or that one snapshot lists no tool

string
changes
required

One entry a tool that came, went or differs, by name

Array<object>
object
tool
required
string
kind
required
string
Allowed values: added removed changed
class
required

The worst class among fields

string
Allowed values: breaking non-breaking informational
fields
required
Array<object>
object
field
required

tool when it came or went, else what changed: description, title, annotations.<hint>, a schema path such as inputSchema.filter.kind

string
class
required
string
Allowed values: breaking non-breaking informational
reason
required

One sentence

string
signal

The change is to what a model reads (a description) or is allowed to do (a hint): a reason to look, whatever the class

string
Allowed values: security
unclassified

No rule knew the change: it is informational because it could not be called safe or breaking

boolean
summary
required
object
breaking
required
integer
non-breaking
required
integer
informational
required
integer
overall
required

The worst class among the changes; none without changes

string
Allowed values: none breaking non-breaking informational
otherSections
required

Sections other than the tools that differ: said, not classified

Array<string>
Allowed values: server instructions capabilities prompts resources resourceTemplates
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

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid token or session

No such server in your project, or a snapshot that is not on it

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}