Skip to content
API referenceGet an MCP server

Get an MCP server

GET/v1/mcp-servers/{slug}

Get an MCP server.

Requires an organization admin key, or a key of the server's workspace (any role). Returns 404 when the server does not exist in the organization.

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.

Path parameters

  • slugstringrequired

    The MCP server's slug (mcps-...).

Query parameters

  • organizationstringrequired

    The organization's identifier (slug).

Responses

200application/json
  • 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.

NVIDIA Inception Program member

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