---
title: "Mcp Endpoint"
method: POST
path: "/teams/{team_id}/mcp"
tags: ["mcp"]
---

# Mcp Endpoint

`POST /teams/{team_id}/mcp`

Per-team MCP resource-server entry point.

Verifies the caller's token, then dispatches the JSON-RPC message. Only the
Legacy handshake is answered today (empty tool surface); team scoping and
permissions are W4/C1, not here.

Args:
    team_id: The team the caller is acting for (from the path). Scoping and
        permissions are enforced by W4, not here.
    request: The incoming HTTP request.

Returns:
    A 401 challenge when the token is missing or invalid; a JSON-RPC
    response for a request; or an empty ``202`` for a notification.

## Path parameters

- `team_id` string, required

## Response `200`

Successful Response

- unknown

## 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/post.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)