DOC-API-MODEL-schema-ou7clc4l5s#overview
MCPServerStatus
Status information returned for an MCP server.
Meaning and usage
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#meaning
See the definition above.
Usage profiles
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#fields
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#response
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-serveridSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-serveridserverId | string | Optional | Identifier of the MCP server whose status is reported. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-nameSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-namename | string | Optional | Display name of the MCP server. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-statusSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-statusstatus | 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; explicit presence | Current connection status reported for the MCP server. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-toolsdiscoveredSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-toolsdiscoveredtoolsDiscovered | string (int64) | Optional | Number of tool definitions found during the last discovery. Pattern: ^-?\d+$. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-lastdiscoverydurationSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-lastdiscoverydurationlastDiscoveryDuration | string | Optional | Elapsed duration of the last MCP tool discovery. Pattern: ^-?(?:0|[1-9][0-9]*)(?:\.[0-9]{1,9})?s$. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-lasterrorSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-lasterrorlastError | string | Optional | Most recent error reported while contacting the MCP server. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-lastdiscoverytimeSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-lastdiscoverytimelastDiscoveryTime | string (date-time) | Optional | Time when MCP tool discovery last ran. |
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#field-kindSection ID: DOC-API-MODEL-schema-ou7clc4l5s#response-field-kindkind | 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; explicit presence | Ownership of this server. Populated by ListAvailableServers for every source it merges. |
Values of status
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#response-values-status
Current connection or discovery condition reported for an MCP server.
| Value | No. | Form | Meaning |
|---|---|---|---|
MCP_SERVER_CONNECTION_STATUS_CONNECTED | 0 | Canonical | A connection to the MCP server is established. |
MCP_SERVER_CONNECTION_STATUS_DISCONNECTED | 1 | Canonical | There is no active connection to the MCP server. |
MCP_SERVER_CONNECTION_STATUS_ERROR | 2 | Canonical | A connection or discovery attempt encountered an error. |
MCP_SERVER_CONNECTION_STATUS_DISCOVERING | 3 | Canonical | The platform is discovering the server's available capabilities. |
Values of kind
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#response-values-kind
Ownership and connection category of an MCP server available to the platform. INTERNAL servers use fully qualified server IDs; BUILT_IN IDs start with built-in:, CUSTOM with custom:, and INTEGRATION with pipedream:. EXTERNAL identifies existing externally configured servers with unprefixed IDs. Use this category when displaying or filtering the server catalog.
| Value | No. | Form | Meaning |
|---|---|---|---|
MCP_SERVER_KIND_INTERNAL | 0 | Canonical | See meaning below. |
MCP_SERVER_KIND_BUILT_IN | 1 | Canonical | See meaning below. |
MCP_SERVER_KIND_CUSTOM | 2 | Canonical | See meaning below. |
MCP_SERVER_KIND_EXTERNAL | 3 | Canonical | An existing externally configured server. New entries are not supported in this category; it does not designate a new tenant registration. |
MCP_SERVER_KIND_INTEGRATION | 4 | Canonical | See meaning below. |
MCP_SERVER_KIND_INTERNAL
A server compiled into the deployment and dispatched in-process.
Compiled into the deployment and dispatched in-process. No vendor cost.
MCP_SERVER_KIND_BUILT_IN
A platform-owned catalog server invoked with platform-held vendor credentials.
Platform-owned catalog entry, called with a platform-held vendor key and no end-user identity. Metered per call.
MCP_SERVER_KIND_CUSTOM
A tenant-registered server invoked with the tenant's credentials.
Registered by a tenant, called with the tenant's own credential.
MCP_SERVER_KIND_INTEGRATION
An account-connected integration reached through Pipedream Connect.
Account-bound integration reached through Pipedream Connect.
Where used
Section ID: DOC-API-MODEL-schema-ou7clc4l5s#where-used
| Reference | Relationship |
|---|---|
| List available MCP servers | POST /api/v1/llm/mcp-list-available-servers |
Download the public reference contract.
Document ID: DOC-API-MODEL-schema-ou7clc4l5s