---
title: "List the caller's MCP connectors"
method: GET
path: "/mcp/connectors"
tags: ["MCP Connectors"]
---

# List the caller's MCP connectors

`GET /mcp/connectors`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/mcp/connectors`
- Auth: one of:
  - HTTP basic
  - API key in header `X-Internal-Service-ID` and API key in header `X-Internal-Service-Token`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/mcp/connectors/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the MCP connectors the **authenticated tenant** may reach,
with their health status. Deployment-shared connectors (those
registered under the wildcard tenancy `*`) are included for every
tenant; another tenant's connectors are not
(`platform/agent/mcp_handler.go:612-620`).

Connectors provide access to external data sources:
- PostgreSQL
- Cassandra
- Salesforce
- Snowflake
- Amadeus (travel API)
- Slack

**Authentication.** Wrapped in `apiAuthMiddleware`
(`platform/agent/mcp_handler.go:581`); the tenancy comes from the
credential, never from a caller-supplied header or path segment.
Registered for `GET` only — `apiAuthMiddleware` forwards CORS
preflights unauthenticated, so registering `OPTIONS` would reach the
handler with no identity in context.

*(Behaviour change in #3067: this route was previously registered
with no auth middleware and returned every tenant's connector names,
types, versions, capabilities, health and raw driver error strings to
an anonymous caller.)*

## Response `200`

List of connectors

- ConnectorListResponse
  - `connectors` object[]
    - `name` string
    - `type` string
    - `version` string
    - `healthy` boolean
    - `latency_ms` integer
    - `capabilities` string[]
    - `error` string
  - `count` integer

## Other responses

- `401`: Missing or invalid authentication. Handler-written 401s use the `{success, error}` envelope; 401s written by the auth middleware use the `{"error": {"code", "message"}}` envelope (JSONError).
- `503`: MCP registry not initialized

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)