---
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`

## Request

- Base URL: `https://api.traxy.ai/api/v1`
- URL: `https://api.traxy.ai/api/v1/mcp`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/docs/mcp/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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 or rate-limit enforcement is temporarily unavailable. Retry after the delay in Retry-After.

## Changes

- **2026-07-13** `e60dfaf3c445`: 8 breaking, 3 info
  - the request property `id` became not nullable
  - removed the enum value `initialize` of the request property `method`
  - removed the enum value `tools/call` of the request property `method`
  - removed the enum value `tools/list` of the request property `method`
  - …7 more

[Operation history](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/changes/mcp/post.md)

---

[API](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) - [All operations](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/revisions/765b1a6a3abd?raw)