Skip to main content
GET
/
api
/
servers
List MCP servers
curl --request GET \
  --url https://{organization_id}.platform.barndoor.ai/api/servers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Salesforce Production",
      "slug": "salesforce",
      "connection_status": "connected",
      "provider": "salesforce",
      "url": "https://api.salesforce.com/mcp"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "pages": 123,
    "previous_page": 123,
    "next_page": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.barndoor.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

JWT token obtained through Auth0 OAuth 2.0 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.

Query Parameters

page
integer
default:1

Page number (1-based)

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

Number of items per page (max 100)

Required range: 1 <= x <= 100

Search servers by name or slug

status
enum<string>

Filter by server status

Available options:
pending,
active,
error
connection_status
enum<string>

Filter by connection status. not_connected expands to pending, error, and available.

Available options:
available,
pending,
connected,
error,
not_connected

Response

Paginated list of MCP servers

data
object[]
required

Array of servers for current page

pagination
PaginationMeta · object
required

Pagination metadata