Skip to main content
PATCH
Update Mcp

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Path Parameters

mcp_id
string
required

Body

application/json

The body of a library edit. Omitted fields are left alone.

name
string | null

A new name. Must match [a-zA-Z0-9_-]+ and stay unique for this user.

values
Values · object | null

New answers to the card's inputs_schema, merged over the stored ones — send only the keys that changed. The config is re-rendered from the card, so this needs the originating hub to still be registered and reachable.

enabled
boolean | null

Whether the MCP is turned on.

Response

Successful Response

One installed MCP, as shown in the user's library.

The rendered mcp_config is deliberately left out: it carries the inputs the user filled in at install time, API keys included, and nothing on this screen needs them.

id
string
required

The installed-MCP record id.

name
string
required

The MCP name, unique for this user.

is_stateful
boolean
required

Whether it needs a session.

enabled
boolean
required

Whether the user has it turned on.

display_name
string | null

The card's user-facing name at install time.

description
string
default:""

The card's description at install time.

tags
string[]

The card's tags at install time.

author
string | null

Who published the MCP, at install time.

icon_url
string | null

The card's icon at install time.

url
string | null

The MCP's page on the hub's website.

hub_id
string | null

The hub it came from, or null when added by hand.

card_id
string | null

The card's id on that hub.

version
string | null

The card version installed.