MCP-Server

Vila Madalena

io.github.junoventures/vilamadalena-sampa-br
Commerce & Retail Karten & Standort Reisen & Hospitality Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Provides a neighborhood directory for local places, restaurants, menus, events, offers, services, reservations, bookings, and purchases.

create_booking
Book an appointment slot at a venue (Wix Bookings). NOTHING IS BOOKED UNTIL THE CUSTOMER PAYS: this returns a checkout URL, and the booking stays off the venue's calendar until a human opens that URL and completes payment on the venue's own site. Tell the user they must open the link. Call get_availability immediately before this — the slot is re-validated server-side and a taken slot is rejected. The contact email is NOT verified at this step; the checkout is what confirms it.
Eingabeschema
{'type': 'object', 'required': ['place_slug', 'serviceId', 'startDate', 'endDate', 'contact'], 'properties': {'contact': {'type': 'object', 'required': ['name', 'email', 'phone'], 'properties': {'name': {'type': 'string', 'description': 'Full name.'}, 'email': {'type': 'string', 'description': 'Email address.'}, 'phone': {'type': 'string', 'description': 'Phone number, at least 10 digits. Any formatting is accepted.'}}, 'description': 'Who the booking is for. All three are required by the venue to confirm or reschedule.'}, 'endDate': {'type': 'string', 'description': 'Slot end as an ISO instant, exactly as returned by get_availability.'}, 'serviceId': {'type': 'string', 'description': 'Service ID from list_booking_services (called with the same place_slug).'}, 'startDate': {'type': 'string', 'description': 'Slot start as an ISO instant, exactly as returned by get_availability.'}, 'place_slug': {'type': 'string', 'description': 'Venue place slug from search_places.'}, 'resourceId': {'type': 'string', 'description': 'Optional staff/resource ID from the slot, when the user picked a specific professional.'}}}
create_checkout
Create a direct checkout URL for one or more store products (Wix Stores). The user clicks the URL to complete payment on the site — no login required on the AI agent side.
Eingabeschema
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['productId'], 'properties': {'quantity': {'type': 'number', 'description': 'Quantity (default 1).'}, 'productId': {'type': 'string', 'description': 'Product ID from list_products.'}}}, 'description': 'Products to add to cart.'}}}
get_availability
Get available time slots for a bookable service on a given date (Wix Bookings). Pass the serviceId from list_booking_services and a date in YYYY-MM-DD. Pass the same `place_slug` you used there — slot times are returned in the VENUE's timezone, which is not necessarily the directory's.
Eingabeschema
{'type': 'object', 'required': ['serviceId', 'date'], 'properties': {'date': {'type': 'string', 'description': 'Date in YYYY-MM-DD format (e.g. "2026-06-25").'}, 'serviceId': {'type': 'string', 'description': 'Service ID from list_booking_services.'}, 'place_slug': {'type': 'string', 'description': 'Venue place slug — use the same one passed to list_booking_services.'}}}
get_event_tickets
Get ticket types and prices for a specific event (Wix Events). Pass the event slug from list_events. Returns ticket names, prices, sale status, and how many are left.
Eingabeschema
{'type': 'object', 'required': ['event_slug'], 'properties': {'event_slug': {'type': 'string', 'description': 'Event slug from list_events.'}}}
get_loyalty_info
Get the loyalty/rewards program details for this site (Wix Loyalty). Returns program name, points currency name, and tier structure with required points per tier.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}}
get_place
Get full details for a specific place by its URL slug, including opening hours, a precomputed `open_now` boolean, amenity `attributes` (slugs), a `delivery` array of curated delivery-app deep-links (ifood, rappi, uber-eats — each `{ platform, url }`), ratings, address, and neighborhood.
Eingabeschema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'URL slug of the place, e.g. "cafe-example".'}}}
get_restaurant_menus
Get the food menu for a specific restaurant on this site. Returns menus with their sections, dishes, descriptions, prices, and dietary labels (vegan, gluten-free, etc). Use search_places or list_categories first to find the restaurant's place_slug.
Eingabeschema
{'type': 'object', 'required': ['place_slug'], 'properties': {'place_slug': {'type': 'string', 'description': 'The slug of the restaurant, e.g. "bar-do-ze" (from search_places or a place URL).'}}}
get_reviews
Get published reviews for this site (Wix Reviews). Returns reviewer name, rating, title, and content.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max reviews to return (default 10, max 50).'}}}
get_showtimes
Get showtimes for a specific movie at cinemas in this neighborhood, for a given date. Returns each cinema with session times, format (e.g. "Laser", "3D"), and language (Dublado/Legendado). Requires movies_enabled on this site.
Eingabeschema
{'type': 'object', 'required': ['movie_slug'], 'properties': {'date': {'type': 'string', 'description': 'Date in YYYY-MM-DD format. Defaults to today (BRT).'}, 'movie_slug': {'type': 'string', 'description': 'Movie slug from list_movies (e.g. "o-corvo-1016084").'}}}
get_site_info
Returns basic information about this neighborhood directory: name, locale, domain, description, canonical URLs for key sections, plus the current LOCAL TIME and CURRENT WEATHER at the neighborhood (temperature, condition). Use this for any "what time is it there" or "what's the weather like" context.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}}
list_blog_posts
List recent published blog posts for this site (Wix Blog). Returns title, excerpt, author, published date, reading time, categories, and the post URL.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max posts to return (default 10, max 50).'}, 'category': {'type': 'string', 'description': 'Filter by category label. Case-insensitive substring match.'}}}
list_booking_services
List a venue's services — what it offers, with price and duration. Pass `place_slug` (from search_places) to list the services of a specific VENUE — a salon, clinic or studio listed in this directory; that is what you want in almost every case, and it is the only form whose serviceId works with create_booking. Omitting `place_slug` lists the directory site's own services instead, which most sites do not have. Returns name, description, price, duration in minutes, and `bookableViaMcp`. Services are listed for EVERY venue, including those with no online booking system — check `bookableViaMcp`: when it is false, `id` is null and you cannot book through create_booking, so point the user at `bookingUrl` or the venue's page instead.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'place_slug': {'type': 'string', 'description': "Venue place slug from search_places. Strongly recommended — without it you get the directory's own services, not a venue's."}}}
list_categories
Returns the full category taxonomy of this directory site: top-level groups with their subcategories, localized labels, schema.org types, and live place counts.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}}
list_events
List upcoming events in this neighborhood with date, venue, price, and URL. Events within the next 7 days include a weatherForecast (condition + min/max temperature) for the event day — use it to tell users e.g. "the event is at X and it will be raining". Pass `filter` to narrow by time or price; `filter: "agora"` answers "what can I go to right now" and is resolved live on every call, which no cached page can do.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max events to return (default 20, max 50).'}, 'filter': {'enum': ['agora', 'hoje', 'amanha', 'fim-de-semana', 'gratis'], 'type': 'string', 'description': 'Narrow the list: "agora" = on stage at this exact moment (season runs and day-granular sources are excluded, because their stored window says nothing about whether a session is on right now); "hoje"/"amanha"/"fim-de-semana" = running on those days, including multi-day runs; "gratis" = free to attend, including externally-ticketed events priced at 0.'}, 'upcoming_only': {'type': 'boolean', 'description': 'Only return upcoming or in-progress events (default true).'}}}
list_faqs
Get all FAQ questions and answers for this site (Wix FAQ). Grouped by category. Use this to answer common questions about the site — opening hours, parking, policies, etc.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}}
list_forms
List available contact/signup forms on this site (Wix Forms). Returns form name, ID, and field definitions (label, type, required). Use before submit_form to discover which fields to fill.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {}}
list_guides
List curated editorial guides ("best of" lists) published by this site — ranked places with editorial notes. The best source for "best X in this neighborhood" questions.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max guides to return (default 20, max 50).'}}}
list_movies
List movies available in this neighborhood (only on sites with movies_enabled). Returns now-showing films (with actual showtimes at local cinemas), coming-soon films, and streaming availability. Includes title, genres, TMDB rating, runtime, and detail URL.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max movies to return (default 20, max 100).'}, 'status': {'enum': ['now_showing', 'coming_soon', 'streaming', 'all'], 'type': 'string', 'description': 'Filter by status. "now_showing" = films with upcoming showtimes at local cinemas. "coming_soon" = unreleased or not yet playing locally. "streaming" = available on streaming services in Brazil. "all" = full catalog (default).'}}}
list_offers
List active promotions and deals available in this neighborhood directory. Returns discount label, promo code (if any), CTA link, validity window, and which business/place it belongs to. FLASH offers have a countdown deadline.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'kind': {'enum': ['STANDARD', 'FLASH'], 'type': 'string', 'description': 'Filter by offer kind. FLASH = time-limited flash sale with countdown. Omit to return all active offers.'}, 'limit': {'type': 'number', 'description': 'Max offers to return (default 20, max 60).'}}}
list_pricing_plans
List membership or subscription plans (Wix Pricing Plans). Pass `place_slug` (from search_places) to list the plans of a specific VENUE — a gym, studio or clinic listed in this directory (e.g. its monthly/annual membership); that is what you want in almost every case. Omitting `place_slug` lists the directory site's own plans instead, which most sites do not have. Returns plan name, description, price, billing cycle, perks, and a direct checkout URL.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'place_slug': {'type': 'string', 'description': "Venue place slug from search_places. Strongly recommended — without it you get the directory's own plans, not a venue's."}}}
list_products
List products in this site's store (Wix Stores). Returns name, price, stock status, and product type.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'description': 'Optional search term matched against product name.'}, 'limit': {'type': 'number', 'description': 'Max products to return (default 20, max 100).'}}}
list_profiles
List solo service-provider profiles on this site — businesses without a fixed physical location (e.g. dog walkers, tutors, personal trainers). Returns name, profile URL, category, and any available metadata (age, height, etc.).
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max profiles to return (default 50).'}}}
request_reservation
Request a table at a restaurant. THE RESTAURANT IS NOT NOTIFIED YET: the request is held and a confirmation email is sent to the address you provide, and only when that person clicks the link does the restaurant receive it. Tell the user to check their inbox — the link expires in 24 hours. Use a real address belonging to the person you are acting for; the confirmation link is deliberately not returned to you. This is a request, not a confirmed booking: the restaurant confirms out of band.
Eingabeschema
{'type': 'object', 'required': ['place_slug', 'name', 'email', 'partySize', 'requestedAt'], 'properties': {'name': {'type': 'string', 'description': 'Name the table is under.'}, 'email': {'type': 'string', 'description': "The guest's own email — the confirmation link is sent here."}, 'phone': {'type': 'string', 'description': 'Optional phone number for the restaurant to reach the guest.'}, 'message': {'type': 'string', 'description': 'Optional note (occasion, dietary needs, seating preference).'}, 'partySize': {'type': 'number', 'description': 'Number of people (1–30).'}, 'place_slug': {'type': 'string', 'description': 'Restaurant place slug from search_places.'}, 'requestedAt': {'type': 'string', 'description': 'Desired date and time as an ISO instant. Must be in the future.'}}}
reserve_event_tickets
Hold tickets for an event sold through this site (Wix Events) and return a checkout URL. THE HOLD IS TEMPORARY AND NOTHING IS PAID: the tickets are not the user's until a human opens the URL and completes checkout, and the hold expires on its own if they don't. Max 10 tickets and 10 ticket types per reservation. Only works for events this site sells directly — for events sold elsewhere (Sympla, Ingresse, Sesc), use the event's own ticketUrl instead.
Eingabeschema
{'type': 'object', 'required': ['event_slug', 'tickets'], 'properties': {'tickets': {'type': 'array', 'items': {'type': 'object', 'required': ['ticketDefinitionId', 'quantity'], 'properties': {'quantity': {'type': 'number', 'description': 'How many of this type (at least 1).'}, 'ticketDefinitionId': {'type': 'string', 'description': 'Ticket type ID from get_event_tickets.'}}}, 'description': 'Ticket types and quantities to hold.'}, 'event_slug': {'type': 'string', 'description': 'Event slug from list_events.'}}}
rsvp_event
RSVP to a free event on this site (Wix Events). NOBODY IS ON THE GUEST LIST YET: a confirmation email goes to the address you provide, and the RSVP is only submitted when that person clicks the link (expires in 24 hours). Tell the user to check their inbox. Use a real address belonging to the person you are acting for — the confirmation link is deliberately not returned to you.
Eingabeschema
{'type': 'object', 'required': ['event_slug', 'firstName', 'lastName', 'email'], 'properties': {'email': {'type': 'string', 'description': "The guest's own email — the confirmation link is sent here."}, 'lastName': {'type': 'string', 'description': 'Guest last name.'}, 'firstName': {'type': 'string', 'description': 'Guest first name.'}, 'event_slug': {'type': 'string', 'description': 'Event slug from list_events.'}}}
search_dishes
Find which restaurants serve a dish in this neighborhood. Searches every menu item across all restaurants on the site, grouped by dish — e.g. query "feijoada" returns each restaurant serving it with price, description, dietary labels, and the place URL. Omit the query to list the most-served dishes. Use this for any "where can I eat X" question.
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Max dishes to return (default 20, max 50).'}, 'query': {'type': 'string', 'description': 'Dish name or part of it, e.g. "feijoada", "pizza margherita". Omit to list top dishes.'}}}
search_places
Search for places (restaurants, cafes, shops, etc.) in this neighborhood. The `q` match is accent-insensitive and typo-tolerant ("acai" finds "Açaí", "restaurnt" finds "Restaurante"), ranked by relevance. Compose filters for multi-condition queries: `category`, `neighborhood`, `open_now` (true = open at this exact moment), and `attributes` (amenity slugs, ALL must match). Each result includes a precomputed `open_now` boolean, an `attributes` array (amenity slugs), a `delivery` array of curated delivery-app deep-links (ifood, rappi, 99food, uber-eats — each `{ platform, url }`), rating, and structured `hours` (Google Maps periods: day 0=Sun–6=Sat, time "HHMM"). Common amenity slugs: wifi, outdoor-seating, wheelchair, dog-friendly, delivery, takeaway, reservations, live-music, vegan, gluten-free (availability varies per place).
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'description': 'Free-text term matched against place name and address — accent-insensitive and typo-tolerant.'}, 'limit': {'type': 'number', 'description': 'Max results to return (default 20, max 100).'}, 'category': {'type': 'string', 'description': 'Filter by category label (e.g. "Café"). Case-insensitive substring match.'}, 'open_now': {'type': 'boolean', 'description': 'When true, return only places open at the current local time (computed server-side from their opening hours).'}, 'attributes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Amenity slugs a place must ALL have, e.g. ["wifi","outdoor-seating"]. Common slugs: wifi, outdoor-seating, wheelchair, dog-friendly, delivery, takeaway, reservations, live-music, vegan, gluten-free.'}, 'neighborhood': {'type': 'string', 'description': 'Filter by neighborhood name. Case-insensitive substring match.'}}}
submit_form
Submit a form on behalf of the user (Wix Forms). Call list_forms first to get the formId and field keys. Returns a submissionId on success.
Eingabeschema
{'type': 'object', 'required': ['formId', 'fields'], 'properties': {'fields': {'type': 'object', 'description': 'Key-value pairs matching the field keys from list_forms. Example: { "field_1": "João", "field_2": "joao@email.com" }', 'additionalProperties': {'type': 'string'}}, 'formId': {'type': 'string', 'description': 'Form ID from list_forms.'}}}
Hinzugefügt
get_showtimes
17. September 2026 12:42
Hinzugefügt
list_movies
17. September 2026 12:42
Hinzugefügt
list_profiles
17. September 2026 12:42
Hinzugefügt
list_offers
17. September 2026 12:42
Hinzugefügt
get_loyalty_info
17. September 2026 12:42
Hinzugefügt
submit_form
17. September 2026 12:42
Hinzugefügt
list_forms
17. September 2026 12:42
Hinzugefügt
list_faqs
17. September 2026 12:42
Hinzugefügt
list_blog_posts
17. September 2026 12:42
Hinzugefügt
get_reviews
17. September 2026 12:42
Hinzugefügt
list_pricing_plans
17. September 2026 12:42
Hinzugefügt
search_dishes
17. September 2026 12:42
Hinzugefügt
get_restaurant_menus
17. September 2026 12:42
Hinzugefügt
create_checkout
17. September 2026 12:42
Hinzugefügt
list_products
17. September 2026 12:42
Hinzugefügt
get_event_tickets
17. September 2026 12:42
Hinzugefügt
rsvp_event
17. September 2026 12:42
Hinzugefügt
request_reservation
17. September 2026 12:42
Hinzugefügt
reserve_event_tickets
17. September 2026 12:42
Hinzugefügt
create_booking
17. September 2026 12:42
Hinzugefügt
get_availability
17. September 2026 12:42
Hinzugefügt
list_booking_services
17. September 2026 12:42
Hinzugefügt
list_guides
17. September 2026 12:42
Hinzugefügt
list_events
17. September 2026 12:42
Hinzugefügt
get_place
17. September 2026 12:42
Hinzugefügt
search_places
17. September 2026 12:42
Hinzugefügt
list_categories
17. September 2026 12:42
Hinzugefügt
get_site_info
17. September 2026 12:42