---
title: "MCP endpoint"
method: POST
path: "/connect/{namespace}/{connectionId}/mcp"
tags: ["connect.mcp"]
---

# MCP endpoint

`POST /connect/{namespace}/{connectionId}/mcp`

Stateless MCP endpoint using Streamable HTTP transport. Accepts JSON-RPC requests and notifications. Session management is handled internally by Connect—clients should not send mcp-session-id headers. Requires service token with mcp scope.

## Path parameters

- `namespace` string, required
- `connectionId` string, required

## Response `200`

JSON-RPC response

- JsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union, required
    - string
    - number
  - `result` unknown

## Other responses

- `202` — Notification accepted
- `400` — Invalid request
- `401` — Authorization required
- `404` — Connection not found
- `405` — Method not allowed (stateless mode)
- `409` — Input required
- `500` — Internal error
- `502` — Upstream error

## Changes

- **2026-04-12** `01f97a60fd96` — 1 info
  - added the non-success response with the status `409`
- **2026-01-31** `5903efad445d` — 1 breaking
  - removed the request body
- **2026-01-27** `12e546828dc5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/connect/:namespace/:connectionId/mcp/post.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/01f97a60fd96?raw)