---
title: "MCP JSON-RPC 2.0 endpoint"
method: POST
path: "/api/mcp"
tags: ["MCP"]
---

# MCP JSON-RPC 2.0 endpoint

`POST /api/mcp`

## Request

- Base URL: `https://www.zestio.de`
- URL: `https://www.zestio.de/api/mcp`
- Auth: API key in header `Authorization`

Model Context Protocol endpoint for AI agent tool calling. Supports `initialize`, `tools/list`, and `tools/call` methods. Enables Claude, Cursor, Windsurf and other MCP-compatible AI hosts to call Zestio tools directly (search listings, CRM, virtual staging, market analysis, etc.).

## Request body

- MCPRequest
  - `jsonrpc` '2.0', required: JSON-RPC version
  - `id` union, required: Request identifier
    - number
    - string
  - `method` 'initialize' | 'tools/list' | 'tools/call', required: MCP method
  - `params` object: Method parameters. For `tools/call`: { name, arguments }

## Response `200`

MCP response (JSON-RPC 2.0)

- MCPResponse
  - `jsonrpc` '2.0', required
  - `id` union, required
    - number
    - string
  - `result` unknown
  - `error` object
    - `code` integer: JSON-RPC error code (-32601 = not found, -32602 = invalid params, -32603 = internal, -32001 = admin restricted)
    - `message` string
    - `data` unknown

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing credentials
- `500`: Internal server error

---

[API](https://skmtc.dev/zestio/apis/zestio-api.md) · [All operations](https://skmtc.dev/zestio/apis/zestio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zestio/apis/zestio-api/revisions/d291848b1175?raw)