Create an MCP server

POST/v1/mcp-servers

Create an MCP server.

Creates a workspace's endpoint on a connector. Agents and MCP clients reach it at the returned url (https://mcp.vectoraxis.ai/s/{slug}); it uses the connector's URL, credentials and capabilities, and can only narrow them. People may use it by default (default_user_access: ALLOW).

Requires an organization admin key, or a workspace admin key for workspace_id. Returns 403 when the connector is not available to the workspace, 404 when the connector does not exist, 409 when it is disabled, 400 for an unknown guardrail or one of another workspace. Returns 402 when the organization's plan does not include the MCP Gateway.

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.

Request body application/json

the server to create

organizationstringrequired
The organization's identifier (slug).
At least 1 characters
workspace_idstring<uuid>required
The workspace the server belongs to (UUID).
integration_slugstringrequired
The slug of the connector to serve (mcpi-...). It must be active and available to the workspace.
At least 1 characters
namestringrequired
Display name, up to 255 characters.
At least 0 characters · At most 255 characters
descriptionstring
Optional free-text description.
guardrail_slugsstring[]
Guardrails run on every call through this server, in order, after the connector's own, at most 10. Each must be an organization-level guardrail or one of this workspace's.
At most 10 items

Responses

201application/json

Created

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 POST "https://api.vectoraxis.ai/v1/mcp-servers" \
  -H "Authorization: Bearer $VECTORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "organization": "string",
  "workspace_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b8c9a01",
  "integration_slug": "string",
  "name": "string"
}'

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