Skip to content

The coverage of an MCP server’s tools

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

Every tool the server lists now (listed: true) by name, with its live cases (an explicit link, PUT /v1/mcp-tools/{id}/cases; never a match by name), the newest result of each, and the requirements those cases are linked to. A tool with no case is uncovered; one whose cases have no result is notRun, never a pass. A case of a tool that the newest snapshot pair changed (breaking, or changed) is «May be out of date» until a person takes the mark off for that snapshot. A tool the newest snapshot no longer lists is neither shown nor counted: it stays in the catalog, unlisted, with its cases. Anyone in the project.

id
required
string

The server’s id

The coverage

Media type application/json

Counts, no percentage: a server whose tools have no case is covered: 0, never 100%.

object
serverId
required
string
snapshot
required

The newest snapshot; null - none taken

object
id
required
string
number
required
integer
summary
required
object
tools
required
integer
covered
required

Tools with at least one live case

integer
uncovered
required

Tools with no live case

integer
notRun
required

Tools whose cases have no result yet

integer
mayBeOutOfDate
required

Live cases still marked «May be out of date», summed over all tools (a tool with two marked cases counts 2)

integer
tools
required

By name; the order a page shows them in is its own

Array<object>
object
toolId
required
string
name
required
string
listed
required
boolean
state
required

uncovered - no live case; notRun - its cases have no result yet (not a pass, not 0%); otherwise the counted status of the newest result among its cases

string
Allowed values: uncovered notRun passed failed broken blocked skipped muted
lastResultAt
required
string format: date-time
nullable
change
required

The change of the newest snapshot pair that marks its cases: a breaking class, or a changed tool. null - none

object
snapshotId
required
string
snapshotNumber
required
integer
kind
required
string
Allowed values: added removed changed
class
required
string
Allowed values: breaking non-breaking informational
cases
required
Array<object>
object
id
required
string
title
required
string
latestStatus
required
string
nullable
Allowed values: passed failed broken blocked skipped muted
lastResultAt
required
string format: date-time
nullable
mayBeOutOfDate
required

The tool’s change marks it and nobody took the mark off for that snapshot. Advice: no gate reads it, and the case is not changed

boolean
requirements
required

The requirements its cases are linked to

Array<object>
object
id
required
string
key
required
string
title
required
string
Example
{
"serverId": "6f1c2b3a-0000-4000-8000-000000002458",
"snapshot": {
"id": "6f1c2b3a-0000-4000-8000-000000002460",
"number": 2
},
"summary": {
"tools": 2,
"covered": 1,
"uncovered": 1,
"notRun": 0,
"mayBeOutOfDate": 1
},
"tools": [
{
"toolId": "6f1c2b3a-0000-4000-8000-000000002459",
"name": "get_order",
"listed": true,
"state": "passed",
"lastResultAt": "2026-11-13T09:00:00.000Z",
"change": {
"snapshotId": "6f1c2b3a-0000-4000-8000-000000002460",
"snapshotNumber": 2,
"kind": "changed",
"class": "breaking"
},
"cases": [
{
"id": "6f1c2b3a-0000-4000-8000-0000000000c1",
"title": "Read an order",
"latestStatus": "passed",
"lastResultAt": "2026-11-13T09:00:00.000Z",
"mayBeOutOfDate": true
}
],
"requirements": [
{
"id": "6f1c2b3a-0000-4000-8000-0000000000f5",
"key": "REQ-1",
"title": "Order lookup"
}
]
}
]
}

No / invalid token or session

No such MCP server in your project

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