Server definition

Hash: sha256:1de5eee537395907f3d67e2c85785bc4c345c3116a1f8565e32eaee6e6554084
What it is: What a remote MCP server returned when asked what it offers: 17 tools

The blob, as servednamed by its sha256

{
  "instructions": "Extralingo is a language-travel booking platform. Use these tools to search schools, build a trip, and submit it.\nFinder prices are indicative. Always call calculate_trip_price before telling the student a total.\nsave_trip returns trip_id, url, trip_url, and continue_url (/s/{id}). continue_url restores the saved configuration on Extralingo.com. Reuse trip_id.\nWrite tools (save_trip, email_trip, bookings, quotes, school contact) require OAuth 2.1. See /auth.md.\ncreate_booking is unpaid. The school still confirms. Extralingo emails the student. Payment is only via Extralingo after confirmation, within 5 days. Never say the trip is confirmed or paid.\nIf bookings_live is false, use request_quote instead of create_booking.\nschool_id is the Craft id from search hits. Pass locale en, nl, da, or sv.\n\nWebsite handoff:\nStudents can explore, configure and, where supported, book their language trip conversationally.\nIf a student prefers to browse or continue on Extralingo.com, provide the appropriate website URL:\n- Use the school URL when they want to browse the school page.\n- Use the destination URL when they want to browse a destination.\n- Once a trip has been configured and saved, prefer continue_url (/s/{trip_id}) because it restores their selections.\nWhen the student reaches the point where they want to proceed with an actual booking, and both conversational booking and website booking are available, do not assume which interface they prefer. Ask whether they would like to continue the booking here in the chat or on Extralingo.com.\nIf they choose the website, save the current trip first where appropriate and provide continue_url so they do not have to configure everything again.\nIf they choose chat, continue through the MCP booking flow.\nDo not unnecessarily redirect students to the website during normal discovery, comparison or trip configuration if their request can be handled conversationally.",
  "tools": [
    {
      "description": "Send a question to the school without a full trip configuration. Requires OAuth requests scope. Optional idempotency_key.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "contact": {
            "additionalProperties": true,
            "description": "Optional first_name, last_name. Email always comes from the verified account.",
            "type": "object"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "idempotencyKey": {
            "description": "Optional alias of idempotency_key.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional. Same semantics as create_booking (24 hour replay window).",
            "type": "string"
          },
          "message": {
            "description": "Student message to the school.",
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "trip_id": {
            "description": "Optional trip_id from save_trip.",
            "type": "string"
          }
        },
        "required": [
          "school_id",
          "message"
        ],
        "type": "object"
      },
      "name": "ask_school_question",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "kind": {
            "description": "Lead type on success.",
            "enum": [
              "question"
            ],
            "type": "string"
          },
          "message": {
            "description": "Human-readable confirmation (not a booking confirmation).",
            "type": "string"
          },
          "newBookingId": {
            "description": "Craft newBookings entry id when created.",
            "type": [
              "integer",
              "null"
            ]
          },
          "redirectUrl": {
            "description": "Extralingo /my URL for the student to follow the request, when available.",
            "type": [
              "string",
              "null"
            ]
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Live checkout quote for a configuration. Not a booking. Call before create_booking and before telling the student a final price.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "country_code": {
            "description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable.",
            "examples": [
              "NL",
              "DE"
            ],
            "type": "string"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "discountCode": {
            "description": "Optional promotion or discount code.",
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "trip_id": {
            "description": "Optional saved trip id; when set, the quote may be stored on that trip.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "calculate_trip_price",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "data": {
            "additionalProperties": true,
            "description": "Full pricing breakdown from the booking engine.",
            "type": "object"
          },
          "quote": {
            "additionalProperties": true,
            "description": "Human-oriented price summary.",
            "type": "object"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Submit an unpaid booking for a bookings_live school (same path as the website Book now flow). The school still confirms availability; Extralingo emails the student; down payment is due within 5 days of school confirmation via Extralingo only. Never tell the user they are confirmed or paid. Requires OAuth bookings scope (Bearer token). Optional idempotency_key replays the same payload within 24 hours.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "contact": {
            "additionalProperties": true,
            "description": "Optional first_name, last_name, phone. Email always comes from the verified account; contact.email must match or be omitted.",
            "type": "object"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "idempotencyKey": {
            "description": "Optional alias of idempotency_key.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional. Same key + same payload within 24 hours replays the original response; conflicting payload returns validation_failed.",
            "type": "string"
          },
          "phone": {
            "description": "Student phone number (required).",
            "type": "string"
          },
          "phoneCountry": {
            "description": "ISO 3166-1 alpha-2 country for the phone (e.g. NL).",
            "type": "string"
          },
          "privacyAccepted": {
            "description": "Must be true when not using OAuth.",
            "type": "boolean"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "specialRequests": {
            "description": "Free-text notes for the school.",
            "type": "string"
          },
          "studentDetails": {
            "description": "Per-student details aligned with configuration.students (names, dates of birth, etc.).",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "termsAccepted": {
            "description": "Must be true when not using OAuth (OAuth grants record acceptance).",
            "type": "boolean"
          },
          "trip_id": {
            "description": "Optional trip_id from save_trip linking this booking to a draft.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "create_booking",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "agent_must_tell_the_user": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "bookingId": {
            "description": "Craft booking id when returned by the booking engine.",
            "type": [
              "integer",
              "null"
            ]
          },
          "bookingReference": {
            "type": [
              "string",
              "null"
            ]
          },
          "redirectUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "description": "e.g. awaiting_school_confirmation.",
            "type": "string"
          },
          "studentMessage": {
            "type": "string"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Email continue_url (/s/{id}) to the verified account inbox. Requires OAuth trips scope. Rate-limited. Not a booking; you can share continue_url without emailing.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "email": {
            "description": "Optional. Must match the verified OAuth account email if sent. The link is always sent to that account.",
            "type": "string"
          },
          "firstName": {
            "description": "Optional salutation for the email body.",
            "type": "string"
          },
          "lastName": {
            "description": "Optional salutation for the email body.",
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "trip_id": {
            "description": "trip_id from save_trip.",
            "type": "string"
          }
        },
        "required": [
          "trip_id"
        ],
        "type": "object"
      },
      "name": "email_trip",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "continue_url": {
            "type": "string"
          },
          "emailed_to": {
            "description": "Verified account inbox that received the email.",
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "success": {
            "const": true
          },
          "trip_id": {
            "type": "string"
          },
          "trip_url": {
            "type": "string"
          },
          "url": {
            "description": "Legacy alias of continue_url.",
            "type": "string"
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "One group from list_accommodations (group_id): type, room_types, meal/board options, distance, amenities, age and min-stay rules, and week prices for startDate and currency. Use after list_accommodations, before save_trip or calculate_trip_price, or to answer questions about one option. Week prices are indicative; call calculate_trip_price for a checkout total.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "group_id": {
            "description": "Accommodation group id from list_accommodations.",
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "startDate": {
            "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
            "examples": [
              "2026-09-07"
            ],
            "type": "string"
          }
        },
        "required": [
          "group_id"
        ],
        "type": "object"
      },
      "name": "get_accommodation_details",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "group": {
            "additionalProperties": true,
            "description": "Accommodation group from GET /v3/accommodations/{id} (v2 grouping): labels, classification, room and meal options, facilities, rules, and pricing hints for the requested start date.",
            "properties": {
              "amenities": {
                "description": "Facilities and highlighted amenities.",
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              "classification": {
                "additionalProperties": true,
                "description": "Accommodation type, class, and room metadata.",
                "type": "object"
              },
              "distance": {
                "additionalProperties": true,
                "description": "Distance-to-school summary (string or structured object from the API).",
                "type": [
                  "string",
                  "object",
                  "null"
                ]
              },
              "group_name": {
                "description": "Grouped title when room-type grouping is enabled.",
                "type": "string"
              },
              "id": {
                "description": "Group id (matches group_id).",
                "type": "string"
              },
              "location": {
                "additionalProperties": true,
                "description": "Address, distance_to_school, and travel-time hints.",
                "type": "object"
              },
              "meal_options": {
                "description": "Board/meal plans with pricing_for_requested_weeks when not split by room_types.",
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              "name": {
                "description": "Display name of the accommodation group.",
                "type": "string"
              },
              "occupancy": {
                "additionalProperties": true,
                "description": "Minimum/maximum age and occupancy limits.",
                "type": "object"
              },
              "room_types": {
                "description": "Room variants, each with meal_options, stay_length, and week pricing.",
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              "stay_length": {
                "additionalProperties": true,
                "description": "Minimum and maximum stay in weeks.",
                "type": "object"
              }
            },
            "type": "object"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Details for one course id from list_courses (pricing rows, supplements, metadata).",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "course_id": {
            "description": "Course product id from list_courses.",
            "type": "string"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "startDate": {
            "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
            "examples": [
              "2026-09-07"
            ],
            "type": "string"
          }
        },
        "required": [
          "course_id",
          "school_id"
        ],
        "type": "object"
      },
      "name": "get_course_details",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "course": {
            "additionalProperties": true,
            "description": "Single course product with pricing rows and supplements for the requested start date.",
            "type": [
              "object",
              "null"
            ]
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "School briefing: profile, cancellation policy, reviews, image URLs, bookings_live flag, and optional hero image for chat UI. Requires school_id from search_language_schools.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "include_hero_image": {
            "default": true,
            "description": "When true, structuredContent may include a compressed JPEG in MCP image content; hero_image is stripped from structuredContent after attach.",
            "type": "boolean"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          }
        },
        "required": [
          "school_id"
        ],
        "type": "object"
      },
      "name": "get_school",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "data": {
            "additionalProperties": true,
            "description": "School profile (title, url, city, country, bookings_live, reviews, images[]).",
            "type": "object"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Valid filter values for search_language_schools (languages, countries, cities, course types, and other facets).",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_school_filters",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "data": {
            "additionalProperties": true,
            "description": "Facet lists keyed by filter name.",
            "type": "object"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Load a saved trip by trip_id from save_trip. Returns continue_url for website handoff with configuration restored.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "trip_id": {
            "description": "trip_id returned by save_trip.",
            "type": "string"
          }
        },
        "required": [
          "trip_id"
        ],
        "type": "object"
      },
      "name": "get_trip",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "type": "object"
          },
          "continue_url": {
            "description": "Shareable Extralingo URL that restores configuration.",
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "school_id": {
            "description": "Craft school entry id.",
            "type": "integer"
          },
          "school_name": {
            "type": "string"
          },
          "school_url": {
            "type": "string"
          },
          "success": {
            "const": true
          },
          "summary": {
            "description": "Human-readable configuration summary for agents.",
            "type": "string"
          },
          "trip_id": {
            "description": "Shareable trip id (/s/{id}).",
            "type": "string"
          },
          "trip_url": {
            "type": "string"
          },
          "url": {
            "description": "Legacy alias of continue_url.",
            "type": "string"
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Accommodation groups for a school. Use group ids in save_trip configuration (accommodationGroupId).",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "country_code": {
            "description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable.",
            "examples": [
              "NL",
              "DE"
            ],
            "type": "string"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "startDate": {
            "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
            "examples": [
              "2026-09-07"
            ],
            "type": "string"
          }
        },
        "required": [
          "school_id"
        ],
        "type": "object"
      },
      "name": "list_accommodations",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "accommodation_categories": {
            "description": "Same groups nested by category for display.",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "accommodation_groups": {
            "description": "Flat list of accommodation groups (id for get_accommodation_details / configuration).",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "allows_double_room_individual_bookings": {
            "type": "boolean"
          },
          "busy_school_months": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "has_location_discounts": {
            "type": "boolean"
          },
          "location_discount": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "school": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "start_date": {
            "type": "string"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Live course catalogue for a bookings_live school (course ids, weeks, prices). Use returned course ids inside save_trip configuration.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "country_code": {
            "description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable.",
            "examples": [
              "NL",
              "DE"
            ],
            "type": "string"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "startDate": {
            "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
            "examples": [
              "2026-09-07"
            ],
            "type": "string"
          }
        },
        "required": [
          "school_id"
        ],
        "type": "object"
      },
      "name": "list_courses",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "busy_school_months": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "course_types": {
            "description": "Course types with nested courses[] (course ids, weeks, week prices).",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "currency": {
            "type": "string"
          },
          "has_location_discounts": {
            "type": "boolean"
          },
          "location_discount": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "pricing_rule": {
            "additionalProperties": true,
            "type": [
              "object",
              "null"
            ]
          },
          "school": {
            "additionalProperties": true,
            "description": "School metadata from the booking API.",
            "type": [
              "object",
              "null"
            ]
          },
          "start_date": {
            "description": "Effective start date used for pricing (YYYY-MM-DD).",
            "type": "string"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Allowed course start dates (typically Mondays) for a school. Use startDate values in list_courses and configuration.startDate.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          }
        },
        "required": [
          "school_id"
        ],
        "type": "object"
      },
      "name": "list_starting_dates",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "dates": {
            "description": "Bookable course start dates (typically Mondays, YYYY-MM-DD strings).",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Trip discussion: trip_id or school_id+configuration plus message. ask_school_question: question without a trip. request_quote: personal quote (comments) when not booking. School gets the config; Extralingo emails the verified account and coordinates replies. Returns kind, newBookingId, redirectUrl, message (not a booking). OAuth scope requests. Optional idempotency_key.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "contact": {
            "additionalProperties": true,
            "description": "Optional first_name, last_name. Email always comes from the verified account.",
            "type": "object"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "idempotencyKey": {
            "description": "Optional alias of idempotency_key.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional. Same semantics as create_booking (24 hour replay window).",
            "type": "string"
          },
          "message": {
            "description": "Student message to the school.",
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "trip_id": {
            "description": "Optional trip_id from save_trip.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "request_discussion",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "kind": {
            "description": "Lead type on success.",
            "enum": [
              "discussion"
            ],
            "type": "string"
          },
          "message": {
            "description": "Human-readable confirmation (not a booking confirmation).",
            "type": "string"
          },
          "newBookingId": {
            "description": "Craft newBookings entry id when created.",
            "type": [
              "integer",
              "null"
            ]
          },
          "redirectUrl": {
            "description": "Extralingo /my URL for the student to follow the request, when available.",
            "type": [
              "string",
              "null"
            ]
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Ask the school for a personal quote when bookings_live is false or the student is not ready to book. Requires OAuth requests scope. Optional idempotency_key.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "comments": {
            "description": "Student message to the school.",
            "type": "string"
          },
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "contact": {
            "additionalProperties": true,
            "description": "Optional first_name, last_name. Email always comes from the verified account.",
            "type": "object"
          },
          "currency": {
            "default": "EUR",
            "description": "ISO 4217 currency for prices in this call. Usually EUR.",
            "examples": [
              "EUR"
            ],
            "type": "string"
          },
          "idempotencyKey": {
            "description": "Optional alias of idempotency_key.",
            "type": "string"
          },
          "idempotency_key": {
            "description": "Optional. Same semantics as create_booking (24 hour replay window).",
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "trip_id": {
            "description": "Optional trip_id from save_trip.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "request_quote",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "kind": {
            "description": "Lead type on success.",
            "enum": [
              "quote"
            ],
            "type": "string"
          },
          "message": {
            "description": "Human-readable confirmation (not a booking confirmation).",
            "type": "string"
          },
          "newBookingId": {
            "description": "Craft newBookings entry id when created.",
            "type": [
              "integer",
              "null"
            ]
          },
          "redirectUrl": {
            "description": "Extralingo /my URL for the student to follow the request, when available.",
            "type": [
              "string",
              "null"
            ]
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Create or update a server-side trip draft. Returns trip_id, url, trip_url, and continue_url (/s/{id}) so the student can restore selections on Extralingo.com. Not a booking. Requires OAuth trips scope (Bearer token).",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
            "properties": {
              "accommodationGroupId": {
                "description": "Accommodation group id from list_accommodations (optional).",
                "type": "string"
              },
              "mealType": {
                "description": "Meal plan key when accommodation is selected.",
                "type": "string"
              },
              "startDate": {
                "description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates.",
                "examples": [
                  "2026-09-07"
                ],
                "type": "string"
              },
              "students": {
                "description": "One object per traveller. courseId comes from list_courses.",
                "items": {
                  "additionalProperties": true,
                  "properties": {
                    "courseId": {
                      "description": "Course product id from list_courses for this school.",
                      "type": "string"
                    },
                    "weeks": {
                      "description": "Course duration in weeks.",
                      "minimum": 1,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "email": {
            "description": "Optional student email for anonymous drafts. With OAuth, the verified account email is used.",
            "type": "string"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "school_id": {
            "description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID.",
            "examples": [
              12345
            ],
            "type": "integer"
          },
          "trip_id": {
            "description": "Omit to create a new trip. Pass an existing trip_id from save_trip to update the same continue_url.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "save_trip",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "configuration": {
            "additionalProperties": true,
            "type": "object"
          },
          "continue_url": {
            "description": "Shareable Extralingo URL that restores configuration.",
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "school_id": {
            "description": "Craft school entry id.",
            "type": "integer"
          },
          "school_name": {
            "type": "string"
          },
          "school_url": {
            "type": "string"
          },
          "success": {
            "const": true
          },
          "summary": {
            "description": "Human-readable configuration summary for agents.",
            "type": "string"
          },
          "trip_id": {
            "description": "Shareable trip id (/s/{id}).",
            "type": "string"
          },
          "trip_url": {
            "type": "string"
          },
          "url": {
            "description": "Legacy alias of continue_url.",
            "type": "string"
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Search cities, countries, and school names. Use before search_language_schools to resolve place names to slugs.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "language": {
            "description": "Optional language slug to restrict destinations (e.g. spanish).",
            "type": "string"
          },
          "limit": {
            "default": 8,
            "description": "Maximum results (1–20).",
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "query": {
            "description": "Destination or school name prefix. Empty returns popular destinations.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_destinations",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "hits": {
            "description": "Destination matches.",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "locale": {
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "schools": {
            "description": "Optional school name fallback hits.",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    },
    {
      "description": "Search and rank language schools. Returns school_id, url, indicative from-price, and reviews. Prices are not a booking quote; call calculate_trip_price before quoting a total.",
      "inputSchema": {
        "additionalProperties": true,
        "properties": {
          "cities": {
            "description": "City slug filters from get_school_filters.",
            "items": {
              "description": "City slug.",
              "type": "string"
            },
            "type": "array"
          },
          "city": {
            "description": "Single city slug filter. Prefer cities[] for multiple.",
            "type": "string"
          },
          "country": {
            "description": "Country slug or name filter from get_school_filters.",
            "type": "string"
          },
          "course_type": {
            "description": "Course type slug from get_school_filters (e.g. intensive, private).",
            "type": "string"
          },
          "language": {
            "description": "Language slug filter from get_school_filters (e.g. spanish, english).",
            "examples": [
              "spanish"
            ],
            "type": "string"
          },
          "limit": {
            "default": 5,
            "description": "Maximum schools to return (1–20).",
            "maximum": 20,
            "minimum": 1,
            "type": "integer"
          },
          "locale": {
            "description": "Response language and site context. One of en, nl, da, sv.",
            "enum": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "examples": [
              "en",
              "nl",
              "da",
              "sv"
            ],
            "type": "string"
          },
          "query": {
            "description": "Free-text search (school name, city, or keyword). Empty returns popular matches for the other filters.",
            "examples": [
              "Barcelona intensive Spanish"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_language_schools",
      "outputSchema": {
        "additionalProperties": true,
        "properties": {
          "data": {
            "additionalProperties": true,
            "description": "Meilisearch-style payload with hits[] (school_id, title, url, city, country, pricing hints).",
            "type": "object"
          },
          "success": {
            "const": true
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:1de5eee537395907f3d67e2c85785bc4c345c3116a1f8565e32eaee6e6554084 | sha256sum