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

# MCP endpoint

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

## Request

- Base URL: `https://api.smithery.ai`
- URL: `https://api.smithery.ai/connect/{namespace}/{connectionId}/mcp`
- Auth: HTTP bearer

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-10-16** `17463ce9a13a`: 1 info
  - endpoint added
- **2026-04-24** `3f57836881dd`: 1 breaking
  - api path removed without deprecation
- **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

[Operation 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/17463ce9a13a?raw)