---
title: "List Servers"
method: GET
path: "/api/py/org-mcp-servers"
tags: ["org-mcp-servers"]
---

# List Servers

`GET /api/py/org-mcp-servers`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/api/py/org-mcp-servers`
- Auth: none declared

## Response `200`

Successful Response

- OrgMcpServerList: The organization's live org MCP servers, ordered by name. An organization holds at most 100, so the list is never paged.
  - `servers` OrgMcpServerAdmin[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `server_url` string, required
    - `namespace` string, required
    - `auth_type` 'oauth_client' | 'member_oauth' | 'shared_headers' | 'no_auth', required
    - `oauth_client_id` string, nullable, required
    - `has_client_secret` boolean, required
    - `token_endpoint_auth_method` 'none' | 'client_secret_post' | 'client_secret_basic', required
    - `authorization_server_hosts` string[], required
    - `authorization_issuer` string, nullable, required
    - `shared_header_names` string[], required
    - `icon_bucket_path` string, nullable
    - `icon_url` string, nullable
    - `server_icon_url` string, nullable
    - `approved` boolean, required
    - `created_by_user_id` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

## Changes

- **2026-11-02** `be39c59c13f6`: 3 info
  - added the optional property `servers/items/icon_bucket_path` to the response with the `200` status
  - added the optional property `servers/items/icon_url` to the response with the `200` status
  - added the optional property `servers/items/server_icon_url` to the response with the `200` status
- **2026-10-29** `b4b983695c8d`: 2 warning
  - added the new `member_oauth` enum value to the `servers/items/auth_type` response property for the response status `200`
  - added the new `no_auth` enum value to the `servers/items/auth_type` response property for the response status `200`
- **2026-10-23** `c5d087c22ef0`: 1 breaking, 2 warning, 1 info
  - the `auth_type` response property const value `oauth_client` was removed for the status `200`
  - added the new `oauth_client` enum value to the `servers/items/auth_type` response property for the response status `200`
  - added the new `shared_headers` enum value to the `servers/items/auth_type` response property for the response status `200`
  - added the required property `servers/items/shared_header_names` to the response with the `200` status
- **2026-10-09** `7a88193131f1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/api/py/org-mcp-servers/get.md)

---

[API](https://skmtc.dev/getauctor/apis/getauctor-api.md) - [All operations](https://skmtc.dev/getauctor/apis/getauctor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getauctor/apis/getauctor-api/revisions/be39c59c13f6?raw)