Get an MCP server's user access

GET/v1/mcp-servers/{slug}/user-access

Get an MCP server's user access.

Who may use the server as themselves, through an MCP client they connected with OAuth: the default for people with no entry, and the per-person entries. Agents on an MCP key are governed by the key instead.

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

default_user_accessenum<string>
ALLOW or DENY: access for a person with no entry. Default ALLOW.
One of "ALLOW", "DENY"
usersobject[]
Per-person entries, at most 1000, without duplicates. Replaces the whole list when sent.
At most 1000 items
Child attributes
- user_idstringrequired
  The person's user ID. They must be a member of the server's workspace.
  At least 1 characters
- enabledbooleanrequired
  true allows the person, false denies them.
- emailstring
  Read-only: the person's email, for display.

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