Skip to content

One snapshot with its contract

GET
/v1/mcp-servers/{id}/snapshots/{number}
curl --request GET \
--url https://beta-api.plune.ai/v1/mcp-servers/example/snapshots/1 \
--header 'Authorization: Bearer <token>'

The snapshot of that number, with the contract it holds. Anyone in the project.

id
required
string

The server’s id

number
required
integer
>= 1

The snapshot’s number within the server

The snapshot

Media type application/json

A snapshot of a server’s contract. Never changed after it is written.

object
id
required
string
projectId
required
string
serverId
required
string
number
required

Counts from 1 within the server

integer
>= 1
hash
required

SHA-256 of the canonical JSON of the contract (keys sorted at every level): the same contract has the same hash

string
environment
required

Where the server was running when it answered. Not part of the contract and not of its hash

string
nullable
tools
required

Tools listed; null when the server declares no tool list. 0 is a list that holds nothing

integer
nullable
createdBy
required
string
createdAt
required
string format: date-time
content
required

The contract as stored: every section present, null where the server declares none; the entities of each list in the order of their key

object
server
required
object
instructions
required
string
nullable
capabilities
required
object
tools
required
Array<object>
nullable
object
resources
required
Array<object>
nullable
object
resourceTemplates
required
Array<object>
nullable
object
prompts
required
Array<object>
nullable
object
Example
{
"id": "6f1c2b3a-0000-4000-8000-000000002460",
"projectId": "u-shop::default",
"serverId": "6f1c2b3a-0000-4000-8000-000000002458",
"number": 1,
"hash": "b7e2c4a19d3f58601a4c9e7d2b5f8031c6a9d4e7f1b2035a8c6d9e0f3a41b72c",
"environment": "beta",
"tools": 2,
"createdBy": "6f1c2b3a-0000-4000-8000-0000000000a2",
"createdAt": "2026-11-13T09:00:00.000Z",
"content": {
"server": {
"name": "shop-mcp",
"version": "1.4.0"
},
"instructions": null,
"capabilities": {
"tools": {
"listChanged": false
}
},
"tools": [
{
"name": "get_order",
"description": "Read one order by its id.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"annotations": {
"readOnlyHint": true
}
},
{
"name": "list_orders",
"description": "List the latest orders.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer"
}
}
}
}
],
"resources": null,
"resourceTemplates": null,
"prompts": null
}
}

No / invalid token or session

No such snapshot on a server of your project

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