Skip to main content
GET
List connections to a server

Authorizations

Authorization
string
header
required

JWT token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE.

The token should be included in the Authorization header: Authorization: Bearer <your-jwt-token>

Use the Barndoor SDK's loginInteractive() function to obtain tokens automatically.

Path Parameters

server_id
string<uuid>
required

The MCP server whose connections to list

Query Parameters

status
string

Comma-separated stored connection statuses to include: pending, connected, error. Omit for all. Only stored values are accepted — available is computed per-caller and never persisted, so passing it returns 400 rather than silently matching nothing.

owner
string

Comma-separated owner classes to include: user, agent, service_account. Omit for all. Use owner=user for a notify list.

page
integer
default:1

Page number (1-based)

Required range: x >= 1
limit
integer
default:10

Number of items per page. The maximum is 100 — a larger value returns 422, so page through the results rather than raising it.

Required range: 1 <= x <= 100

Response

Paginated roster of connections to this server. pagination.total is the headcount.

data
object[]
required

Connections for the current page

pagination
PaginationMeta · object
required

Pagination metadata