---
title: "Send an MCP JSON-RPC request"
method: POST
path: "/mcp"
tags: ["mcp"]
---

# Send an MCP JSON-RPC request

`POST /mcp`

Streamable HTTP transport endpoint for the Superset MCP server (also served at the legacy alias /api/v2/agent/mcp). Send `initialize`, then `tools/list` to enumerate the available tools, then `tools/call` to act on the authenticated user's tasks, workspaces, agents, automations, terminals, hosts, and projects. Responses are `application/json` or `text/event-stream` depending on the request's Accept header. Rate limit: 600 requests per 60 seconds per credential, reported in RateLimit-* headers; over the limit returns 429 with Retry-After. A plain GET without `Accept: text/event-stream` returns a JSON description of the server instead of opening a stream.

## Request body

- JsonRpcRequest — A JSON-RPC 2.0 request as defined by the Model Context Protocol.
  - `jsonrpc` '2.0', required
  - `id` union — Request id. Omitted for notifications.
    - string
    - number
  - `method` string, required — MCP method, e.g. initialize, tools/list, tools/call.
  - `params` object — Method parameters. For tools/call: { name, arguments }.

## Response `200`

JSON-RPC response (or SSE stream of responses).

- JsonRpcResponse — A JSON-RPC 2.0 response from the MCP server.
  - `jsonrpc` '2.0', required
  - `id` union
    - string
    - number
  - `result` object
  - `error` object
    - `code` integer, required
    - `message` string, required
    - `data` unknown

## Other responses

- `401` — Missing, expired, or revoked credential. The WWW-Authenticate header points at the RFC 9728 protected resource metadata to bootstrap OAuth discovery.
- `429` — Too many requests for this credential in the current window. Wait Retry-After seconds and retry.

---

[API](https://skmtc.dev/superset/apis/superset-api.md) · [All operations](https://skmtc.dev/superset/apis/superset-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superset/superset-api/revisions/dee6e20fae0d/schema)