Whitelist a tool (or update its cap / cost)

PUT

/admin/ai/mcp-clients/{id}/tools/{tool}

• Local development behind nginx (port 8088 by default)

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

tool

required

string

>= 1 characters <= 128 characters

Request Body ^required

PUT payload for /admin/ai/mcp-clients/{id}/tools/{tool}.

object

additional_capability

string

cost_estimate_micros

required

integer format: int64

enabled

required

boolean

Responses

200

Grant upserted

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

401

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"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed