Developers / MCP Tools
book_consultation
The only writing tool. Submits a booking request for a specific slot; a human confirms it, so the result reports requires_confirmation: true with a booking_id. Chain get_services → get_availability → book_consultation.
write · human-confirmed · endpoint: https://www.plateaucandy.de/api/mcp
Arguments
| event_type_id | number | Service ID from get_services |
| start | string | Slot start time exactly as returned by get_availability |
| name | string | Attendee name |
| string | Attendee email | |
| notes | string | Context for the conversation (optional) |
Result
submitted, booking_id, requires_confirmation and the booking_url fallback. Every tool declares an outputSchema; results arrive as structuredContent alongside the text rendering. Errors set isError: true.
Call it
curl -X POST https://www.plateaucandy.de/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"book_consultation","arguments":{"event_type_id":1,"start":"2026-12-01T10:00:00+01:00","name":"Ada Example","email":"ada@example.com"}}}'Or from the terminal: npx plateaucandy-mcp book · Server card: server-card.json
All tools
- → get_profile — Studio profile — what Plateau Candy does, expertise, clients and contact.
- → get_services — Available consultation services with the event type IDs needed for booking.
- → get_availability — Available time slots for a consultation (Europe/Berlin).
- → book_consultation — Book a consultation — requires a slot from get_availability; manually confirmed.
- → get_capabilities — Detailed capabilities, problem types addressed, and what Plateau Candy does not do.