---
title: "Update Access Mode"
method: PUT
path: "/teams/{team_id}/mcp/access-mode"
tags: ["mcp-access"]
---

# Update Access Mode

`PUT /teams/{team_id}/mcp/access-mode`

Set the team's MCP access mode. Requires ``MANAGE_TEAM``.

## Path parameters

- `team_id` string, required

## Request body

- SetMCPAccessModeRequest — Request to change a team's MCP access mode.
  - `mode` 'off' | 'admin_approval' | 'member_self_confirm', required — Team policy for confirming MCP client bindings. ``OFF`` is where every team starts: the MCP endpoint records no pending binding at all. ``ADMIN_APPROVAL`` requires a ``MANAGE_TEAM`` human to confirm each client. ``MEMBER_SELF_CONFIRM`` lets an existing member confirm a client for themselves.

## Response `200`

Successful Response

- MCPAccessModeResponse — The team's current MCP access mode plus whether the caller may change it.
  - `mode` 'off' | 'admin_approval' | 'member_self_confirm', required — Team policy for confirming MCP client bindings. ``OFF`` is where every team starts: the MCP endpoint records no pending binding at all. ``ADMIN_APPROVAL`` requires a ``MANAGE_TEAM`` human to confirm each client. ``MEMBER_SELF_CONFIRM`` lets an existing member confirm a client for themselves.
  - `can_manage` boolean, required
  - `endpoint_url` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `1cffaad2a921` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pioneer/apis/brain-api/changes/teams/:team_id/mcp/access-mode/put.md)

---

[API](https://skmtc.dev/pioneer/apis/brain-api.md) · [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/1cffaad2a921?raw)