---
title: "Streamable HTTP JSON-RPC endpoint for remote MCP clients."
method: POST
path: "/mcp"
tags: ["MCP"]
---

# Streamable HTTP JSON-RPC endpoint for remote MCP clients.

`POST /mcp`

## Headers

- `Accept` string, required
- `MCP-Protocol-Version` string
- `Origin` string

## Request body

- McpJsonRpcRequest
  - `jsonrpc` '2.0', required
  - `id` union
    - string, nullable
    - number
  - `method` string, required — MCP request or notification method, including initialize, tools/list, tools/call, and notifications/initialized.
  - `params` object

## Response `200`

JSON-RPC response.

- McpJsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union
    - string, nullable
    - number
  - `result` object
  - `error` object

## Other responses

- `202` — Notification accepted. The response has no body.
- `400` — MCP transport/header failure or top-level request validation failure.
- `401` — Invalid, expired, revoked, or wrong-audience MCP OAuth token. Response includes a WWW-Authenticate challenge with resource metadata.
- `403` — Browser Origin is not allowed for MCP.
- `429` — Customer API rate limit exceeded. Retry after the delay in the Retry-After header.

---

[API](https://skmtc.net/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) · [All operations](https://skmtc.net/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill-growth/traxy-customer-api-and-mcp-v1/revisions/5ea23c14f8cf/schema)
