List MCP connections

GET

/api/mcp-connections

Production

Returns all registered MCP server connections for the tenant. MCP connections represent external servers that expose tools for your AI agents to interact with business systems (order management, CRM, inventory, etc.).

Authorizations

bearerAuth

Responses

200

All MCP connections for the tenant.

List of registered MCP server connections for the tenant.

Array<object>

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