Skip to main content
PATCH
Update MCP config

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id
string
required

ID of the app.

Body

application/json

The MCP config keys to change.

auth
enum<string> | null

How clients authenticate. Either "oauth", where clients sign in, or "none", where anyone can call the entity read tools without signing in. Leave it out to keep the current mode.

Available options:
none,
oauth
Example:

"oauth"

tools
Tools · object | null

The whole tools object, which replaces the stored one. excluded_agents lists agents to hold back. entity_overrides maps an entity name to the operations to serve, where an empty list holds the entity back. functions lists the custom tools, and one with disabled set to true is held back. Leave it out to keep the current tools.

Example:

Response

The config as saved, and its tools.

The app's editable MCP config and the tools it resolves to.

config
Config · object | null

The editable config, or null when the app has no MCP server. It has auth, login_path, consent_path, and the tools object that Update MCP config replaces.

Example:
tools
AppMcpToolRow · object[]

Every tool the config can serve, and whether it does.

pending_removal
AppMcpLiveToolRow · object[]

Tools the live server still serves that the config no longer produces. The next publish removes them.