MCP-Server

opplevagent-mcp

io.github.slookisen/opplevagent-mcp
Commerce & Retail Reisen & Hospitality Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Discovers Norwegian activities and farm-sale producers using location and experience filters and submits pending booking requests.

book_gardssalg
Request a gårdssalg booking (pending — email confirmation required)
Submit a booking REQUEST for a Norwegian gårdssalg (farm-sale) producer discovered via discover_gardssalg. Send inn en reservasjonsforespørsel for et gårdssalg-besøk. IMPORTANT: this NEVER creates a confirmed booking — it creates a PENDING request, exactly like the producer's own website form. The PRODUCER reviews the request and responds (confirms, proposes another time, or declines); guest_email only receives a read-only status link, never anything that can finalize the booking. No payment is involved (pickup/visit, pay on arrival, as today). Only producers with an active booking status (see discover_gardssalg's booking.live field) can be booked — a paused/not-yet-onboarded producer is rejected with a clear message, never a silent failure. VIKTIG: oppretter ALDRI en bekreftet booking — kun en avventende forespørsel; produsenten mottar forespørselen og svarer (bekrefter, foreslår nytt tidspunkt eller avslår). ONE-SENTENCE FLOW («book et møte hos X fredag 20. oktober kl. 10 for 4 personer»): call this ONCE with provider_query='X' (the producer's name — no discover_gardssalg round-trip needed), slot_at, party_size, guest_name, guest_email and requested_weekday='fredag'. The tool resolves X to exactly one producer (or returns candidates / not-found with NO booking created), checks that the date really is a Friday (or returns weekday_mismatch:true with the nearest Fridays, NO booking created), then submits the request and notifies the producer by email. guest_name and guest_email are the HUMAN guest's own — ask the guest for them if you do not have them; never invent or reuse someone else's. Required: provider_id OR provider_query, slot_at (requested date/time, 'YYYY-MM-DDTHH:MM' Europe/Oslo), party_size, guest_name, guest_email. Optional: requested_weekday, experience_id, guest_phone, notes, confirm_outside_hours. The requested slot_at is ALWAYS hard-rejected if it's in the past or too far ahead. If the producer has stated opening hours and slot_at falls outside them, this returns outside_hours:true (not an error) instead of creating the booking — retry once with confirm_outside_hours:true if the exact requested time should be kept anyway. On success the response carries the resolved producer (provider.navn) and slot_at_local (e.g. 'fredag 23. oktober 2026 kl. 10:00') — read both back to the guest. Example: provider_query 'Fjordgard Bryggeri', slot_at '2026-10-23T10:00', requested_weekday 'fredag', party_size 4, guest_name 'Kari Nordmann', guest_email 'kari@example.no'.
Destruktiv Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slot_at', 'party_size', 'guest_name', 'guest_email'], 'properties': {'notes': {'type': 'string', 'description': 'Optional free-text note to the producer (e.g. dietary needs, arrival details).'}, 'slot_at': {'type': 'string', 'description': "Requested visit date/time, local (Europe/Oslo), format 'YYYY-MM-DDTHH:MM'. Example: '2026-08-15T13:00'. This is a REQUEST â\x80\x94 the producer may confirm, suggest another time, or decline."}, 'guest_name': {'type': 'string', 'description': "Full name of the person the reservation is for. Example: 'Kari Nordmann'"}, 'party_size': {'type': 'number', 'description': 'Number of people in the group (1-50). Example: 4'}, 'guest_email': {'type': 'string', 'description': "Guest's email address â\x80\x94 REQUIRED. Receives a confirmation-of-request email plus a read-only status link; the booking stays pending until the PRODUCER responds (confirms, proposes another time, or declines) â\x80\x94 the guest's link cannot finalize anything. Example: 'kari@example.no'"}, 'guest_phone': {'type': 'string', 'description': 'Optional guest phone number.'}, 'provider_id': {'type': 'string', 'description': "The gÃ¥rdssalg producer's id â\x80\x94 the `id` field of a discover_gardssalg result (NOT the profile slug). Example: '3f1b2c4d-...'. Either provider_id or provider_query is required; provider_id wins when both are given."}, 'experience_id': {'type': 'string', 'description': 'Optional experience UUID if this booking is for a specific listed experience rather than a general gÃ¥rdssalg visit.'}, 'provider_query': {'type': 'string', 'maxLength': 200, 'description': "Alternative to provider_id: the producer's name as the guest said it, optionally with a place, e.g. 'Fjordgard Bryggeri' or 'Egge gÃ¥rd Steinkjer'. Resolved to exactly ONE producer; if several match, the tool returns the candidates (no booking created) so you can ask the guest which one; if none match, it says so."}, 'requested_weekday': {'type': 'string', 'maxLength': 20, 'description': "Safety check â\x80\x94 the weekday the guest actually said, e.g. 'fredag' or 'Friday'. If slot_at does not fall on that weekday (Europe/Oslo) the tool returns weekday_mismatch:true with the nearest dates that do, instead of booking the wrong day. Always pass it when the guest named a weekday."}, 'confirm_outside_hours': {'type': 'boolean', 'description': "Set to true only when RETRYING after a previous call to this tool returned outside_hours:true and the requested time should be kept anyway, despite falling outside the producer's stated opening hours. Omit on a first attempt."}}}
discover_experiences
Discover Norwegian experiences
Search the opplevagent.no curated marketplace of Norwegian experiences and activities. Filtrer på fylke (county), kategori, vær, sesong, innendørs/utendørs, gruppestørrelse, pris og varighet. / Filter by county, category, weather, season, indoor/outdoor, group size, price, and duration. Also supports near-me search via lat/lng (+ optional radius_km): when given, results include a rounded distance_km and a geo_precision flag ('address' = exact, 'kommune' = approximate municipality centroid) and are sorted nearest-first. Returns title, category, location (fylke/kommune), description, and booking URL if available. Only verified experiences from active providers (Brreg-checked) are returned. Examples: 'hva kan vi finne på i Troms om vinteren?', 'outdoor activities in Oslo for 4 people', 'experiences within 50km of lat 69.65 / lng 18.95'.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'age': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Age of the youngest participant. Filters out experiences with a minimum-age requirement above this. Example: 8'}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Origin latitude for a near-me search (decimal degrees). Must be given together with lng. Example: 69.65 (Tromsø)'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Origin longitude for a near-me search (decimal degrees). Must be given together with lat. Example: 18.95 (Tromsø)'}, 'sort': {'enum': ['distance'], 'type': 'string', 'description': "'distance' â\x80\x94 sort results ascending by distance from lat/lng. Already the default whenever lat/lng are given; this makes the request explicit."}, 'fylke': {'type': 'string', 'description': "Norwegian county (fylke). Examples: 'Oslo', 'Vestland', 'Troms', 'Rogaland'"}, 'limit': {'type': 'number', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Max results (default 20, max 50)'}, 'season': {'type': 'string', 'description': "Season filter: 'summer', 'winter', 'spring' or 'autumn' (the Norwegian words sommer/vinter/vÃ¥r/høst work too). Year-round experiences are always included."}, 'kommune': {'type': 'string', 'description': "Norwegian municipality (kommune). Examples: 'Tromsø', 'Bergen', 'Stavanger'"}, 'weather': {'enum': ['rain', 'snow', 'clear', 'any'], 'type': 'string', 'description': "Weather suitability filter. 'rain'/'snow' prefers indoor + weather-independent experiences. Examples: 'rain', 'clear'"}, 'category': {'type': 'string', 'description': "Experience category slug â\x80\x94 one of: 'kultur_historie' (culture/history, museums), 'natur_friluft' (nature/outdoors), 'adrenalin_action', 'sightseeing_transport' (sightseeing, cruises, cable cars), 'overnatting_opplevelse' (stays), 'dyreliv_safari' (wildlife, whale/moose safaris, dog sledding), 'vinter_sno' (winter & snow), 'mat_drikke' (food & drink), 'velvaere_spa' (wellness/spa). Call list_experience_categories for live counts."}, 'language': {'type': 'string', 'description': "Required language for the experience. Examples: 'no', 'en'"}, 'max_price': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Maximum price per person in Norwegian kroner (NOK). Example: 500', 'exclusiveMinimum': 0}, 'radius_km': {'type': 'number', 'maximum': 5000, 'description': 'Max distance from lat/lng in kilometers. Only applies when lat/lng are given. Example: 50', 'exclusiveMinimum': 0}, 'group_size': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Number of people in the group. Used to filter experiences by min/max group capacity. Example: 4', 'exclusiveMinimum': 0}, 'duration_max': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Maximum duration in minutes. Example: 120 (2 hours)', 'exclusiveMinimum': 0}, 'indoor_outdoor': {'enum': ['indoor', 'outdoor', 'both'], 'type': 'string', 'description': "Indoor/outdoor preference. Examples: 'indoor', 'outdoor', 'both'"}}}
discover_gardssalg
Discover Norwegian farm-sale drink producers (gårdssalg)
Search opplevagent.no's gårdssalg (farm-sale) vertical — Brreg-registered Norwegian drink producers (bryggeri/cideri/vingård/destilleri/gårdskafé/mjød/seltzeri) selling directly from the farm. Finn norske gårdssalg-produsenter (drikkeprodusenter som selger direkte fra gården) etter fylke, kommune og produsenttype. / Filter by county (fylke), municipality (kommune), and producer type. Also supports near-me search via lat/lng (+ optional radius_km): when given, results include a rounded distance_km and are sorted nearest-first, and rows with no geocoded location are excluded (never a fabricated distance). Returns id (the provider_id for book_gardssalg), name, location, producer type, and an honest booking status (live direct booking vs. a dark-launch 'coming soon' note — never overclaims booking availability). To look up ONE specific producer by name (e.g. when the guest says 'book hos Fjordgard Bryggeri'), pass `query`. Examples: 'gårdssalg i Vestland', 'cideri near lat 60.4 / lng 5.3', 'bryggeri med booking', query: 'Fjordgard Bryggeri'.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Origin latitude for a near-me search (decimal degrees). Must be given together with lng. Example: 69.65 (Tromsø)'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Origin longitude for a near-me search (decimal degrees). Must be given together with lat. Example: 18.95 (Tromsø)'}, 'fylke': {'type': 'string', 'description': "Norwegian county (fylke) of the producer. Examples: 'Oslo', 'Vestland', 'Troms', 'Rogaland'"}, 'limit': {'type': 'number', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Max results (default 20, max 50)'}, 'query': {'type': 'string', 'maxLength': 200, 'description': "Free-text lookup of a specific producer by name and/or place, e.g. 'Fjordgard Bryggeri', 'Egge gÃ¥rd', 'sideri Hardanger'. Every word must match the producer's name, URL slug, place (poststed) or municipality; exact name matches rank first. Use this to get the `id` (provider_id) for book_gardssalg when the guest names a producer."}, 'kommune': {'type': 'string', 'description': "Norwegian municipality (kommune) of the producer. Examples: 'Tromsø', 'Bergen', 'Stavanger'"}, 'radius_km': {'type': 'number', 'maximum': 5000, 'description': 'Max distance from lat/lng in kilometers. Only applies when lat/lng are given. Example: 50', 'exclusiveMinimum': 0}, 'booking_live': {'type': 'boolean', 'description': 'When true, only return producers that currently accept direct bookings. Omit to include producers regardless of booking status.'}, 'producer_type': {'type': 'string', 'description': "Type of drink producer â\x80\x94 one of the six canonical drink venue kinds: 'bryggeri' (brewery), 'cideri' (cidery), 'vingÃ¥rd' (winery), 'destilleri' (distillery), 'gÃ¥rdskafé' (farm café), 'mjød'/'mjøderi' (meadery). 'seltzeri' also occurs in the data."}}}
get_experience
Get full details for a Norwegian experience
Fetch complete details for a single experience from opplevagent.no by its UUID. Henter fullstendig informasjon om en opplevelse via UUID. Returns title, full description, category, location (fylke/kommune/meeting point), indoor/outdoor, season, weather suitability, group size limits, age suitability, price, duration, languages, booking URL, and booking type. Obtain the UUID from discover_experiences results. Example: id 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "UUID of the experience to fetch. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'"}}}
list_experience_categories
List Norwegian experience categories
List all experience categories available on opplevagent.no, along with the number of verified experiences in each category. Henter alle kategorier med antall verifiserte opplevelser. Use this to understand what kinds of experiences are available before calling discover_experiences with a specific category filter. Example question: 'hvilke typer opplevelser finnes i Norge?', 'what categories are available?'.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Geändert
book_gardssalg
27. September 2026 02:49
Geändert
discover_gardssalg
27. September 2026 02:49
Geändert
get_experience
27. September 2026 02:49
Geändert
discover_experiences
27. September 2026 02:49
Geändert
discover_gardssalg
21. September 2026 02:56
Hinzugefügt
book_gardssalg
17. September 2026 12:52
Hinzugefügt
discover_gardssalg
17. September 2026 12:52
Hinzugefügt
get_experience
17. September 2026 12:52
Hinzugefügt
list_experience_categories
17. September 2026 12:52
Hinzugefügt
discover_experiences
17. September 2026 12:52