Skip to content

The tools of an MCP server

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

Every tool a snapshot of the server has listed, by name, each with how many live cases test it. A tool the server stopped listing stays, with listed: false, so its cases and history are kept. Anyone in the project.

id
required
string

The server’s id

The tools

Media type application/json
object
tools
required

By name

Array<object>
object
id
required
string
projectId
required
string
serverId
required
string
name
required

The tool’s own name, case-sensitive: its identity within the server

string
source
required

How it came into the catalog: snapshot - a snapshot of the server listed it

string
Allowed values: snapshot manual
trust
required

confirmed - the server itself listed it; derived - inferred, not listed

string
Allowed values: confirmed derived
listed
required

The latest snapshot lists it. A tool the server stopped listing stays, with its cases

boolean
lastSeenAt
required

When a snapshot last listed it

string format: date-time
nullable
lastSeenEnvironment
required

Where that snapshot was taken

string
nullable
createdBy
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
coverage
required

How many live cases test it

integer
Example
{
"tools": [
{
"id": "6f1c2b3a-0000-4000-8000-000000002459",
"projectId": "u-shop::default",
"serverId": "6f1c2b3a-0000-4000-8000-000000002458",
"name": "get_order",
"source": "snapshot",
"trust": "confirmed",
"listed": true,
"lastSeenAt": "2026-11-13T09:00:00.000Z",
"lastSeenEnvironment": "beta",
"createdBy": "6f1c2b3a-0000-4000-8000-0000000000a2",
"createdAt": "2026-11-13T09:00:00.000Z",
"updatedAt": "2026-11-13T09:00:00.000Z",
"coverage": 1
}
]
}

No / invalid token or session

No such MCP server in your project

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