Get MCP connection by ID

GET

/api/mcp-connections/{id}

Production

Retrieves a single MCP connection by its unique identifier, including its current health status and the timestamp of the last health check.

Authorizations

bearerAuth

Parameters

Path Parameters

required

string format: uuid

The unique identifier of the MCP connection to retrieve.

Responses

200

The MCP connection was found and returned.

An MCP (Model Context Protocol) connection represents a registered external MCP server that your AI agents can interact with. MCP servers expose tools that let agents query your business systems — for example, looking up order status, checking inventory, or creating quotes. Connections are configured with authentication credentials stored securely in Infisical.

object

required

Unique identifier for the connection.

string format: uuid

Example

mc1a2b3c-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this connection belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

name

required

Human-readable name identifying this connection.

string

Example

Order Management System

serverUrl

required

The URL of the MCP server endpoint.

string

Example

https://mcp.example.com/oms

authType

required

Authentication method used to connect to the MCP server. ‘bearer’ sends a token in the Authorization header. ‘none’ means no authentication.

string

Example

bearer

status

required

Current health status of the connection. ‘active’ means the last health check passed. ‘error’ means the server is unreachable or returned an error. ‘unknown’ means no health check has been performed.

string

Example

active

instructions

Instructions provided by the MCP server that help agents understand when and how to use its tools. These are included in the agent’s system prompt when the connection is assigned.

string | null

Example

Use this server to look up order status, shipping details, and return eligibility. Always pass the order_id as a string.

lastHealthCheckAt

Timestamp of the last successful or failed health check. Null if never tested.

string | null format: date-time

Example

2026-03-25T12:00:00.000Z

createdAt

required

Timestamp when the connection was registered.

string format: date-time

Example

2026-01-10T14:00:00.000Z

updatedAt

required

Timestamp when the connection was last updated.

string format: date-time

Example

2026-03-25T12:00:00.000Z

404

No MCP connection exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found