List MCP servers

GET/v1/mcp-servers

List MCP servers.

With workspace_id, the servers of that workspace; without, every server in the organization. Paginated.

With workspace_id, requires an organization admin key or a key of that workspace; without, an organization admin key.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Query parameters

organizationstringrequired
The organization's identifier (slug).
workspace_idstring<uuid>
Only this workspace's servers (UUID).
pageinteger<int32>
The page number, starting at 1. Default 1.
page_sizeinteger<int32>
Servers per page. Default 20, at most 100.

Responses

200application/json

dataobject[]
The servers.
Child attributes
- idstring<uuid>
  The server's ID (UUID).
- slugstring
  The server's slug (mcps- followed by 16 characters), used in its URL and the API paths.
- organizationstring
  The organization that owns it.
- workspace_idstring<uuid>
  The workspace it belongs to (UUID).
- integration_slugstring
  The connector it serves. Absent if the connector is gone.
- integration_namestring
  The connector's name.
- namestring
  Display name.
- descriptionstring
  Description.
- statusenum<string>
  ACTIVE or DISABLED.
  One of "ACTIVE", "DISABLED"
- default_user_accessenum<string>
  ALLOW or DENY: whether a person with no explicit entry may use it (see the user access endpoint).
  One of "ALLOW", "DENY"
- integration_accessibleboolean
  false when the workspace has lost access to the connector, or the connector is disabled: the server stays registered but cannot be used.
- created_bystring
  The user who created it.
- created_atstring<date-time>
  When it was created (ISO 8601).
- updated_atstring<date-time>
  When it was last changed (ISO 8601).
- urlstring
  The gateway URL to configure in an MCP client, for example https://mcp.vectoraxis.ai/s/{slug}.
- guardrail_slugsstring[]
  Guardrails run on every call through this server, after the connector's own. Empty when there are none.
pageinteger<int32>
The page number.
page_sizeinteger<int32>
Servers per page.
totalinteger<int64>
Matching servers across all pages.

VectorAxis is built by GK Labs, a member of NVIDIA Inception.