---
title: "MCP server (JSON-RPC 2.0, Streamable HTTP)"
method: POST
path: "/api/mcp"
tags: ["mcp"]
---

# MCP server (JSON-RPC 2.0, Streamable HTTP)

`POST /api/mcp`

## Request

- Base URL: `https://konfigurator.suorigo.cz`
- URL: `https://konfigurator.suorigo.cz/api/mcp`
- Auth: none declared

Model Context Protocol server se stejnými schopnostmi jako REST: `initialize`, `tools/list`, `tools/call`, `ping`.
10 nástrojů: list_products, get_quote, create_design, quote_order, find_pickup_points, lookup_company, create_order, get_payment_link, get_order_status, cancel_order (parametry odpovídají REST schématům výše; přesné popisy vrací `tools/list`).
Tělo je jedna JSON-RPC zpráva, nebo pole zpráv (dávka) — nejvýš 10 položek, každá se počítá do limitu zvlášť.
Chyby nástroje (422 e-mail, 429 limit, 409 idempotence…) se vracejí jako běžný výsledek s `isError: true` a HTTP 200; HTTP 429 přijde jen při překročení limitu celého požadavku.
Registrace: registry.modelcontextprotocol.io → `cz.suorigo.konfigurator/server`.

## Request body

- union
  - object: JSON-RPC 2.0 zpráva
  - object[]: dávka zpráv

## Response `200`

JSON-RPC odpověď

- object

## Other responses

- `202`: Notifikace bez odpovědi
- `400`: Neplatný JSON / dávka nad limit
- `429`: Překročen limit (per IP, per e-mail, globální nebo denní). Text v `error` říká, co se stalo a co dělat; typicky počkej nebo odkaž zákazníka na https://konfigurator.suorigo.cz.

---

[API](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty.md) · [All operations](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/llms.txt) · [OpenAPI document](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/revisions/08c6a3ef2349?raw)