McpServer
An MCP server registration (1.60.0), with its allowed tools and their pins.
An object with 18 fields.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
allowed_tools | array of UpstreamToolName | yes | The tools a Member with mcp:write approved; a tool not listed is never offered to any Agent. |
auth | McpServerAuth | yes | |
authorization_server | string or null | yes | The issuer the client discovered for oauth (RFC 9728, RFC 8414); null before discovery or for other auth. |
connection_id | ConnectionId | yes | The Connection the registration created for its credential. |
created_at | Timestamp | yes | |
default_timeout_ms | integer | yes | |
drift_count | integer | no | How many pinned tools the latest listing found changed or removed (1.61.0): above 0 exactly while status is drift_pending; absent from an api before 1.61.0. |
endpoint | McpEndpoint | yes | |
id | McpServerId | yes | |
last_listed_at | Timestamp or null | yes | |
name | McpServerName | yes | |
object | "mcp_server" | yes | |
organization_id | OrganizationId | yes | |
pins | array of McpToolPin | yes | |
protocol_version | string or null | yes | The negotiated MCP revision; null before the first listing. |
revision | integer | yes | |
status | McpServerStatus | yes | |
updated_at | Timestamp | yes |
Used by
The operations whose parameters, request body or responses name this shape directly.