Skip to content

List a server's tool whitelist (with per-tool capability + cost)

GET
/admin/ai/mcp-clients/{id}/tools
id
required
string format: uuid

Grants

Array<object>

One whitelisted tool on an MCP server. Per-tool capability is the gate ON TOP of the umbrella mcp.client.use; empty means “umbrella cap is sufficient”. Cost estimate is the operator-declared per-call cost in USD micros (0 for free / local tools).

object
server_id
required
string format: uuid
tool_name
required
string
>= 1 characters <= 128 characters
additional_capability
string
nullable
cost_estimate_micros
required
integer format: int64
enabled
required
boolean

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed