DOC-API-MODEL-schema-1ipatl4liq#overview
MCPServerInfo
Detailed server information
Meaning and usage
Section ID: DOC-API-MODEL-schema-1ipatl4liq#meaning
See the definition above.
Usage profiles
Section ID: DOC-API-MODEL-schema-1ipatl4liq#fields
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
Section ID: DOC-API-MODEL-schema-1ipatl4liq#response
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-serveridSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-serveridserverId | string | Optional | Identifier of the MCP server associated with the operation or tool. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-nameSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-namename | string | Optional | Display name of the MCP server. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-versionSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-versionversion | string | Optional | Version of the resource represented by this message. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-capabilitiesSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-capabilitiescapabilities | Array of string | Optional | Capabilities reported by the MCP server. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-metadataSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-metadatametadata | Map from string to string | Optional | Additional attributes associated with the resource. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-statusSection ID: DOC-API-MODEL-schema-1ipatl4liq#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-1ipatl4liq#field-availabletoolsSection ID: DOC-API-MODEL-schema-1ipatl4liq#response-field-availabletoolsavailableTools | Array of ToolDefinition | Optional | Tool definitions currently reported by the MCP server. |
Section ID: DOC-API-MODEL-schema-1ipatl4liq#field-kindSection ID: DOC-API-MODEL-schema-1ipatl4liq#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 category of the MCP server definition. |
Values of status
Section ID: DOC-API-MODEL-schema-1ipatl4liq#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-1ipatl4liq#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-1ipatl4liq#where-used
| Reference | Relationship |
|---|---|
| Get detailed MCP server info | POST /api/v1/llm/mcp-get-server-info |
Download the public reference contract.
Document ID: DOC-API-MODEL-schema-1ipatl4liq