list_mcp_server_user_access
Read-onlyIdempotent
Audit per-user access for an MCP server by returning default access mode, override flags, and connection status to identify users who can access it.
Instructions
List per-user access for an MCP server. Returns the default access mode, override flags, and connection status so you can audit who can use it; use before update_mcp_server_user_access.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The MCP server ID or slug |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool call succeeded and returned structured data | |
| data | No | Structured success payload when ok is true | |
| error | No | Structured error payload when ok is false |
Implementation Reference
- src/tools/mcp-servers.tools.ts:332-357 (handler)The MCP tool handler that registers and executes 'list_mcp_server_user_access'. It calls service.mcpServers.listMcpServerUserAccess(params.id) and formats the response.
server.tool( "list_mcp_server_user_access", "List per-user access for an MCP server. Returns the default access mode, override flags, and connection status so you can audit who can use it; use before update_mcp_server_user_access.", MCP_SERVERS_TOOL_SCHEMAS.listMcpServerUserAccess, async (params) => { const result = await service.mcpServers.listMcpServerUserAccess( params.id, ); return { content: [ { type: "text", text: JSON.stringify( { default_user_access: result.default_user_access, total: result.total, users: result.data.map(formatMcpServerUserAccess), }, null, 2, ), }, ], }; }, ); - src/tools/mcp-servers.tools.ts:72-74 (schema)Zod schema for the 'list_mcp_server_user_access' tool input: requires an 'id' (string) field describing the MCP server ID or slug.
listMcpServerUserAccess: { id: z.string().describe("The MCP server ID or slug"), }, - src/tools/mcp-servers.tools.ts:332-357 (registration)Registration of the tool via server.tool() with name 'list_mcp_server_user_access', description, schema, and handler.
server.tool( "list_mcp_server_user_access", "List per-user access for an MCP server. Returns the default access mode, override flags, and connection status so you can audit who can use it; use before update_mcp_server_user_access.", MCP_SERVERS_TOOL_SCHEMAS.listMcpServerUserAccess, async (params) => { const result = await service.mcpServers.listMcpServerUserAccess( params.id, ); return { content: [ { type: "text", text: JSON.stringify( { default_user_access: result.default_user_access, total: result.total, users: result.data.map(formatMcpServerUserAccess), }, null, 2, ), }, ], }; }, ); - Formatting helper 'formatMcpServerUserAccess' used to transform McpServerUserAccess objects for the response.
function formatMcpServerUserAccess(user: McpServerUserAccess): { user_id: string; name: string; enabled: boolean; has_override: boolean; connection_status: string; } { return { user_id: user.user_id, name: formatFullName(user.first_name, user.last_name), enabled: user.enabled, has_override: user.has_override, connection_status: user.connection_status, }; } - Service method 'listMcpServerUserAccess' that makes a GET request to /mcp-servers/{id}/user-access and returns the strongly-typed response.
async listMcpServerUserAccess( id: string, ): Promise<ListMcpServerUserAccessResponse> { return this.get<ListMcpServerUserAccessResponse>( `/mcp-servers/${this.encodePathSegment(id)}/user-access`, ); }