Skip to main content

MCP server

The MCP server (Model Context Protocol) integrates My Playrooms with AI assistants.

Endpoint​

The MCP endpoint is POST https://api.my-playrooms.de/mcp. Read-only tools may be called without authentication. Booking and payment tools require X-API-Key.

Authentication​

curl -X POST https://api.my-playrooms.de/mcp \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json"

Available tools​

ToolDescriptionKey permission
search_playroomsSearch playroomsnone
get_playroomGet playroom detailsnone
get_booking_optionsGet booking optionsnone
create_bookingCreate a bookingbookings.create
get_bookingGet booking detailsbookings.read
create_payment_sessionCreate a payment sessionbookings.payment.create

The tools apply the same permission checks as the REST API (see Authentication). A key without the required effective permission receives a tool error.