MCPServerStatus
MCP Server Status Status information about an MCP server (used in responses)
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
serverId | string | Optional | Identifier of the MCP server associated with the operation or tool. |
name | string | Optional | Display name of the MCP server. |
status | string (MCP_SERVER_CONNECTION_STATUS_CONNECTED, MCP_SERVER_CONNECTION_STATUS_DISCONNECTED, MCP_SERVER_CONNECTION_STATUS_ERROR, MCP_SERVER_CONNECTION_STATUS_DISCOVERING) or integer (int32) | Optional | Current connection status reported for the MCP server. |
toolsDiscovered | integer (int32) | Optional | Number of tool definitions found during the last discovery. Minimum: -2147483648. Maximum: 2147483647. |
lastDiscoveryDuration | string | Optional | Elapsed duration of the last MCP tool discovery. Pattern: ^-?(?:0|[1-9][0-9]*)(?:.[0-9]{1,9})?s$. |
lastError | string | Optional | Most recent error reported while contacting the MCP server. |
lastDiscoveryTime | string (date-time) | Optional | Time when MCP tool discovery last ran. |
kind | string (MCP_SERVER_KIND_INTERNAL, MCP_SERVER_KIND_BUILT_IN, MCP_SERVER_KIND_CUSTOM, MCP_SERVER_KIND_EXTERNAL, MCP_SERVER_KIND_INTEGRATION) or integer (int32) | Optional | Ownership of this server. Populated by ListAvailableServers for every source it merges. |
defaultEnabled | boolean | Optional | Whether the built-in catalog recommends this server by default. This is a catalog recommendation, not whether the server is enabled for a particular profile or conversation. |
Values of status
Current connection or discovery condition reported for an MCP server.
| Value | No. | Form | Meaning |
|---|---|---|---|
MCP_SERVER_CONNECTION_STATUS_CONNECTED | 1 | Canonical | A connection to the MCP server is established. |
MCP_SERVER_CONNECTION_STATUS_DISCONNECTED | 2 | Canonical | There is no active connection to the MCP server. |
MCP_SERVER_CONNECTION_STATUS_ERROR | 3 | Canonical | A connection or discovery attempt encountered an error. |
MCP_SERVER_CONNECTION_STATUS_DISCOVERING | 4 | Canonical | The platform is discovering the server's available capabilities. |
Values of kind
Ownership and connection category of an MCP server available to the platform.
| Value | No. | Form | Meaning |
|---|---|---|---|
MCP_SERVER_KIND_INTERNAL | 1 | Canonical | A server compiled into the deployment and dispatched in-process. |
MCP_SERVER_KIND_BUILT_IN | 2 | Canonical | A platform-owned catalog server invoked with platform-held vendor credentials. |
MCP_SERVER_KIND_CUSTOM | 3 | Canonical | A tenant-registered server invoked with the tenant's credentials. |
MCP_SERVER_KIND_EXTERNAL | 4 | Canonical | A legacy externally configured server; this category does not designate a new tenant registration. |
MCP_SERVER_KIND_INTEGRATION | 5 | Canonical | An account-connected integration reached through Pipedream Connect. |
Where used
| Reference | Relationship |
|---|---|
| List available MCP servers | POST /api/v1/llm/mcp-list-available-servers |
Download the public reference contract.
Document: DOC-API-MODEL-mcp-server-status.