Update an MCP server

PUT/v1/mcp-servers/{slug}

Update an MCP server.

A partial update: absent fields are left unchanged. Sending guardrail_slugs replaces the list.

Requires an organization admin key, or a workspace admin key for the server's workspace. Returns 400 for an unknown guardrail or one of another workspace. Returns 402 when the organization's plan does not include the MCP Gateway. 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).

Request body application/json

the fields to change

namestring
New display name, up to 255 characters. A blank value is ignored.
At least 0 characters · At most 255 characters
descriptionstring
New description.
statusenum<string>
ACTIVE or DISABLED.
One of "ACTIVE", "DISABLED"
guardrail_slugsstring[]
Replaces the server's guardrails (in order, at most 10); an empty list removes them all.
At most 10 items

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.

Request

curl -X PUT "https://api.vectoraxis.ai/v1/mcp-servers/{slug}?organization=string" \
  -H "Authorization: Bearer $VECTORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "string",
  "status": "ACTIVE",
  "guardrail_slugs": [
    "string"
  ]
}'

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