MCP Documentation
DIONYS finds venues for group events in Germany and sends booking inquiries to them. The MCP server makes that available inside AI assistants such as ChatGPT and Claude: search venues, see a venue's rooms and packages with its own prices, send an inquiry, and follow the offer.
Server URL: https://mcp.dionys.ai/mcp
Transport: Streamable HTTP (JSON-RPC 2.0)
Authentication: none
Support: contact details in our imprint
Privacy: see "Nutzung von DIONYS über KI-Plattformen" in our data protection statement
Connecting
ChatGPT — Settings › Apps & Connectors › Create, enter https://mcp.dionys.ai/mcp, authentication "No authentication".
Claude — Settings › Connectors › Add custom connector, same URL.
Other MCP clients — add the URL as a remote MCP server. No key and no account needed.
What the server can do
Four tools. Three only read data, one sends an inquiry to a venue.
search_venues (read-only)
Finds venues for a group event: event location, private or separate room, restaurant or bar area, rooftop, beer garden, loft, hotel or meeting space.
| Parameter | Type | Notes |
|---|---|---|
| city | string | Required. Spelling variants and the metro area are matched. |
| area | string | District, e.g. Schwabing, Gärtnerplatz. Matched via the venue's postal code; venues in the district come first, nearby ones follow and are flagged. |
| venue_type | string | rooftop, bar, restaurant, loft — or a venue name. |
| guest_count | integer | Only venues with a room for that many guests. |
| occasion | string | team dinner, Weihnachtsfeier, wedding, … |
| budget_min_spend | number | Highest acceptable minimum spend in EUR. |
| limit | integer | 1–10, default 5. |
Returns venues with district, capacity, minimum spend, rooms and images. Each result carries a tier: dionys for venues on DIONYS, request for venues that are not.
get_venue_packages (read-only)
The food, drinks and equipment packages a venue offers for a concrete event, priced with the venue's own price rules including VAT — the same rules the offer uses.
| Parameter | Type | Notes |
|---|---|---|
| venue_id | string | Required, from search_venues. |
| guest_count | integer | Required. Picks the fitting room and the matching packages. |
| event_date | string | YYYY-MM-DD. Makes prices and seasonal availability exact. |
| event_time_start / event_time_end | string | HH:MM, default 18:00–23:00. |
| room_id | string | A specific room of the venue. |
In assistants that render MCP user interfaces, the result appears as selectable package cards with an inquiry form for date, time, guest count, name and e-mail.
submit_inquiry (writes, sends e-mail)
Sends a booking inquiry. For a venue on DIONYS the request is created in the venue's account, the offer is generated immediately and e-mailed to the guest, and the venue is notified. A venue that is not on DIONYS receives the inquiry by e-mail.
| Parameter | Type | Notes |
|---|---|---|
| venue_id | string | Required. |
| contact_name, contact_email | string | Required. Passed to the venue so it can prepare the offer. |
| contact_phone, company | string | Optional. |
| event_date | string | Required, YYYY-MM-DD, in the future. |
| event_time_start / event_time_end | string | HH:MM, default 18:00–23:00. |
| guest_count | integer | Required. |
| event_type, message | string | Occasion and wishes for the venue. |
| packages | array | Chosen packages: package_id, optional quantity and dish_ids. |
| skip_packages | boolean | true when the guest wants no packages. |
Nothing in the chat is binding. The answer contains a link to the guest's own DIONYS booking page.
get_inquiry_status (read-only)
State of an inquiry sent in the same conversation: whether the venue replied, the offer and its total, and the links to view, adjust or accept the offer.
Rules that protect guests and venues
- No binding booking in the chat. Guests accept the offer, and pay a deposit where the venue asks for one, on their own DIONYS booking page.
- No inquiry without real contact details. Name and e-mail are required; placeholder data is rejected.
- No duplicates. An identical inquiry — same e-mail address, venue and event date — is not sent twice within 24 hours.
- Daily limits. At most 5 inquiries per e-mail address and 10 per venue within 24 hours.
- Only public venue data. The server reads a fixed set of public endpoints; partner and admin data is never reachable through it.
Coverage
Venues in Germany. Munich is covered in full detail with rooms, packages and prices; Berlin, Hamburg and Frankfurt partially; other cities return no results. Prompts work in German and English.
Data passed on
Search inputs such as city, district, guest count, occasion and date are processed transiently. When an inquiry is sent, the guest's name and e-mail address, optionally phone number and company, together with the event details, are stored at DIONYS and passed to the venue so it can prepare an offer. Legal bases and retention periods are in our privacy policy.
Example prompts
- Find a venue on DIONYS in Munich for a birthday dinner with 20 people.
- Which DIONYS venues near Gärtnerplatz work for 20 guests with a minimum spend under 3000 EUR?
- What food and drinks can we book at AMARi for 20 guests on 10 December 2026 from 19:00 to 23:00?
- What does the offer cost and how do I accept it?