Extralingo is an MCP server published by com.extralingo, hosted at www.extralingo.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 17 tools, including search_language_schools, search_destinations, get_school_filters, get_school, list_courses.
Search language schools abroad, compare courses, dates and prices, and request bookings.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | Type | Description |
|---|---|---|
| city | string | Single city slug filter. Prefer cities[] for multiple. |
| limit | integer | Maximum schools to return (1–20). |
| query | string | Free-text search (school name, city, or keyword). Empty returns popular matches for the other filters. |
| cities | array | City slug filters from get_school_filters. |
| locale | string |
None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
| Response language and site context. One of en, nl, da, sv. |
| country | string | Country slug or name filter from get_school_filters. |
| language | string | Language slug filter from get_school_filters (e.g. spanish, english). |
| course_type | string | Course type slug from get_school_filters (e.g. intensive, private). |
{
"name": "search_language_schools",
"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": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Single city slug filter. Prefer cities[] for multiple."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Maximum schools to return (1–20)."
},
"query": {
"type": "string",
"examples": [
"Barcelona intensive Spanish"
],
"description": "Free-text search (school name, city, or keyword). Empty returns popular matches for the other filters."
},
"cities": {
"type": "array",
"items": {
"type": "string",
"description": "City slug."
},
"description": "City slug filters from get_school_filters."
},
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"country": {
"type": "string",
"description": "Country slug or name filter from get_school_filters."
},
"language": {
"type": "string",
"examples": [
"spanish"
],
"description": "Language slug filter from get_school_filters (e.g. spanish, english)."
},
"course_type": {
"type": "string",
"description": "Course type slug from get_school_filters (e.g. intensive, private)."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"data": {
"type": "object",
"description": "Meilisearch-style payload with hits[] (school_id, title, url, city, country, pricing hints).",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Search language schools",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search cities, countries, and school names. Use before search_language_schools to resolve place names to slugs.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum results (1–20). |
| query | string | Destination or school name prefix. Empty returns popular destinations. |
| locale | string | Response language and site context. One of en, nl, da, sv. |
| language | string | Optional language slug to restrict destinations (e.g. spanish). |
{
"name": "search_destinations",
"description": "Search cities, countries, and school names. Use before search_language_schools to resolve place names to slugs.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 8,
"maximum": 20,
"minimum": 1,
"description": "Maximum results (1–20)."
},
"query": {
"type": "string",
"description": "Destination or school name prefix. Empty returns popular destinations."
},
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"language": {
"type": "string",
"description": "Optional language slug to restrict destinations (e.g. spanish)."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"hits": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Destination matches."
},
"query": {
"type": "string"
},
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string"
},
"schools": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Optional school name fallback hits."
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Search destinations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Valid filter values for search_language_schools (languages, countries, cities, course types, and other facets).
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
{
"name": "get_school_filters",
"description": "Valid filter values for search_language_schools (languages, countries, cities, course types, and other facets).",
"inputSchema": {
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"data": {
"type": "object",
"description": "Facet lists keyed by filter name.",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Get school search filters",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| include_hero_image | boolean | When true, structuredContent may include a compressed JPEG in MCP image content; hero_image is stripped from structuredContent after attach. |
{
"name": "get_school",
"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": {
"type": "object",
"required": [
"school_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"include_hero_image": {
"type": "boolean",
"default": true,
"description": "When true, structuredContent may include a compressed JPEG in MCP image content; hero_image is stripped from structuredContent after attach."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"data": {
"type": "object",
"description": "School profile (title, url, city, country, bookings_live, reviews, images[]).",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Get school briefing",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Live course catalogue for a bookings_live school (course ids, weeks, prices). Use returned course ids inside save_trip configuration.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| startDate | string | Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates. |
| country_code | string | Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable. |
{
"name": "list_courses",
"description": "Live course catalogue for a bookings_live school (course ids, weeks, prices). Use returned course ids inside save_trip configuration.",
"inputSchema": {
"type": "object",
"required": [
"school_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"country_code": {
"type": "string",
"examples": [
"NL",
"DE"
],
"description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"school": {
"type": [
"object",
"null"
],
"description": "School metadata from the booking API.",
"additionalProperties": true
},
"success": {
"const": true
},
"currency": {
"type": "string"
},
"start_date": {
"type": "string",
"description": "Effective start date used for pricing (YYYY-MM-DD)."
},
"course_types": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Course types with nested courses[] (course ids, weeks, week prices)."
},
"pricing_rule": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"location_discount": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"busy_school_months": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"has_location_discounts": {
"type": "boolean"
}
},
"additionalProperties": true
},
"annotations": {
"title": "List courses",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Allowed course start dates (typically Mondays) for a school. Use startDate values in list_courses and configuration.startDate.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
{
"name": "list_starting_dates",
"description": "Allowed course start dates (typically Mondays) for a school. Use startDate values in list_courses and configuration.startDate.",
"inputSchema": {
"type": "object",
"required": [
"school_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"dates": {
"type": "array",
"items": {
"type": "string"
},
"description": "Bookable course start dates (typically Mondays, YYYY-MM-DD strings)."
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "List starting dates",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Accommodation groups for a school. Use group ids in save_trip configuration (accommodationGroupId).
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| startDate | string | Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates. |
| country_code | string | Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable. |
{
"name": "list_accommodations",
"description": "Accommodation groups for a school. Use group ids in save_trip configuration (accommodationGroupId).",
"inputSchema": {
"type": "object",
"required": [
"school_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"country_code": {
"type": "string",
"examples": [
"NL",
"DE"
],
"description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"school": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"success": {
"const": true
},
"currency": {
"type": "string"
},
"start_date": {
"type": "string"
},
"location_discount": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"busy_school_months": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"accommodation_groups": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Flat list of accommodation groups (id for get_accommodation_details / configuration)."
},
"has_location_discounts": {
"type": "boolean"
},
"accommodation_categories": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Same groups nested by category for display."
},
"allows_double_room_individual_bookings": {
"type": "boolean"
}
},
"additionalProperties": true
},
"annotations": {
"title": "List accommodations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Details for one course id from list_courses (pricing rows, supplements, metadata).
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| course_id * | string | Course product id from list_courses. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| startDate | string | Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates. |
{
"name": "get_course_details",
"description": "Details for one course id from list_courses (pricing rows, supplements, metadata).",
"inputSchema": {
"type": "object",
"required": [
"course_id",
"school_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"course_id": {
"type": "string",
"description": "Course product id from list_courses."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"course": {
"type": [
"object",
"null"
],
"description": "Single course product with pricing rows and supplements for the requested start date.",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Get course details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| group_id * | string | Accommodation group id from list_accommodations. |
| startDate | string | Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates. |
{
"name": "get_accommodation_details",
"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": {
"type": "object",
"required": [
"group_id"
],
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"group_id": {
"type": "string",
"description": "Accommodation group id from list_accommodations."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"group": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Group id (matches group_id)."
},
"name": {
"type": "string",
"description": "Display name of the accommodation group."
},
"distance": {
"type": [
"string",
"object",
"null"
],
"description": "Distance-to-school summary (string or structured object from the API).",
"additionalProperties": true
},
"location": {
"type": "object",
"description": "Address, distance_to_school, and travel-time hints.",
"additionalProperties": true
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Facilities and highlighted amenities."
},
"occupancy": {
"type": "object",
"description": "Minimum/maximum age and occupancy limits.",
"additionalProperties": true
},
"group_name": {
"type": "string",
"description": "Grouped title when room-type grouping is enabled."
},
"room_types": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Room variants, each with meal_options, stay_length, and week pricing."
},
"stay_length": {
"type": "object",
"description": "Minimum and maximum stay in weeks.",
"additionalProperties": true
},
"meal_options": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Board/meal plans with pricing_for_requested_weeks when not split by room_types."
},
"classification": {
"type": "object",
"description": "Accommodation type, class, and room metadata.",
"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.",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Get accommodation details",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Live checkout quote for a configuration. Not a booking. Call before create_booking and before telling the student a final price.
| Parameter | Type | Description |
|---|---|---|
| locale | string | Response language and site context. One of en, nl, da, sv. |
| trip_id | string | Optional saved trip id; when set, the quote may be stored on that trip. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| country_code | string | Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable. |
| discountCode | string | Optional promotion or discount code. |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
{
"name": "calculate_trip_price",
"description": "Live checkout quote for a configuration. Not a booking. Call before create_booking and before telling the student a final price.",
"inputSchema": {
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"trip_id": {
"type": "string",
"description": "Optional saved trip id; when set, the quote may be stored on that trip."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"country_code": {
"type": "string",
"examples": [
"NL",
"DE"
],
"description": "Visitor country ISO 3166-1 alpha-2 (e.g. NL). Affects fee display where applicable."
},
"discountCode": {
"type": "string",
"description": "Optional promotion or discount code."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"data": {
"type": "object",
"description": "Full pricing breakdown from the booking engine.",
"additionalProperties": true
},
"quote": {
"type": "object",
"description": "Human-oriented price summary.",
"additionalProperties": true
},
"success": {
"const": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Calculate trip price",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| string | Optional student email for anonymous drafts. With OAuth, the verified account email is used. | |
| locale | string | Response language and site context. One of en, nl, da, sv. |
| trip_id | string | Omit to create a new trip. Pass an existing trip_id from save_trip to update the same continue_url. |
| school_id | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
{
"name": "save_trip",
"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": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Optional student email for anonymous drafts. With OAuth, the verified account email is used."
},
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"trip_id": {
"type": "string",
"description": "Omit to create a new trip. Pass an existing trip_id from save_trip to update the same continue_url."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"url": {
"type": "string",
"description": "Legacy alias of continue_url."
},
"note": {
"type": "string"
},
"success": {
"const": true
},
"summary": {
"type": "string",
"description": "Human-readable configuration summary for agents."
},
"trip_id": {
"type": "string",
"description": "Shareable trip id (/s/{id})."
},
"trip_url": {
"type": "string"
},
"school_id": {
"type": "integer",
"description": "Craft school entry id."
},
"school_url": {
"type": "string"
},
"school_name": {
"type": "string"
},
"continue_url": {
"type": "string",
"description": "Shareable Extralingo URL that restores configuration."
},
"configuration": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Save trip draft",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Load a saved trip by trip_id from save_trip. Returns continue_url for website handoff with configuration restored.
| Parameter | Type | Description |
|---|---|---|
| trip_id * | string | trip_id returned by save_trip. |
{
"name": "get_trip",
"description": "Load a saved trip by trip_id from save_trip. Returns continue_url for website handoff with configuration restored.",
"inputSchema": {
"type": "object",
"required": [
"trip_id"
],
"properties": {
"trip_id": {
"type": "string",
"description": "trip_id returned by save_trip."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"url": {
"type": "string",
"description": "Legacy alias of continue_url."
},
"note": {
"type": "string"
},
"success": {
"const": true
},
"summary": {
"type": "string",
"description": "Human-readable configuration summary for agents."
},
"trip_id": {
"type": "string",
"description": "Shareable trip id (/s/{id})."
},
"trip_url": {
"type": "string"
},
"school_id": {
"type": "integer",
"description": "Craft school entry id."
},
"school_url": {
"type": "string"
},
"school_name": {
"type": "string"
},
"continue_url": {
"type": "string",
"description": "Shareable Extralingo URL that restores configuration."
},
"configuration": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "Get saved trip",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | Optional. Must match the verified OAuth account email if sent. The link is always sent to that account. | |
| locale | string | Response language and site context. One of en, nl, da, sv. |
| trip_id * | string | trip_id from save_trip. |
| lastName | string | Optional salutation for the email body. |
| firstName | string | Optional salutation for the email body. |
{
"name": "email_trip",
"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": {
"type": "object",
"required": [
"trip_id"
],
"properties": {
"email": {
"type": "string",
"description": "Optional. Must match the verified OAuth account email if sent. The link is always sent to that account."
},
"locale": {
"enum": [
"en",
"nl",
"da",
"sv"
],
"type": "string",
"examples": [
"en",
"nl",
"da",
"sv"
],
"description": "Response language and site context. One of en, nl, da, sv."
},
"trip_id": {
"type": "string",
"description": "trip_id from save_trip."
},
"lastName": {
"type": "string",
"description": "Optional salutation for the email body."
},
"firstName": {
"type": "string",
"description": "Optional salutation for the email body."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"url": {
"type": "string",
"description": "Legacy alias of continue_url."
},
"message": {
"type": "string"
},
"success": {
"const": true
},
"trip_id": {
"type": "string"
},
"trip_url": {
"type": "string"
},
"emailed_to": {
"type": "string",
"description": "Verified account inbox that received the email."
},
"continue_url": {
"type": "string"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Email trip link",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| phone | string | Student phone number (required). |
| contact | object | Optional first_name, last_name, phone. Email always comes from the verified account; contact.email must match or be omitted. |
| trip_id | string | Optional trip_id from save_trip linking this booking to a draft. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| phoneCountry | string | ISO 3166-1 alpha-2 country for the phone (e.g. NL). |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
| termsAccepted | boolean | Must be true when not using OAuth (OAuth grants record acceptance). |
| idempotencyKey | string | Optional alias of idempotency_key. |
| studentDetails | array | Per-student details aligned with configuration.students (names, dates of birth, etc.). |
| idempotency_key | string | Optional. Same key + same payload within 24 hours replays the original response; conflicting payload returns validation_failed. |
| privacyAccepted | boolean | Must be true when not using OAuth. |
| specialRequests | string | Free-text notes for the school. |
{
"name": "create_booking",
"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": {
"type": "object",
"properties": {
"phone": {
"type": "string",
"description": "Student phone number (required)."
},
"contact": {
"type": "object",
"description": "Optional first_name, last_name, phone. Email always comes from the verified account; contact.email must match or be omitted.",
"additionalProperties": true
},
"trip_id": {
"type": "string",
"description": "Optional trip_id from save_trip linking this booking to a draft."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"phoneCountry": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country for the phone (e.g. NL)."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
},
"termsAccepted": {
"type": "boolean",
"description": "Must be true when not using OAuth (OAuth grants record acceptance)."
},
"idempotencyKey": {
"type": "string",
"description": "Optional alias of idempotency_key."
},
"studentDetails": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Per-student details aligned with configuration.students (names, dates of birth, etc.)."
},
"idempotency_key": {
"type": "string",
"description": "Optional. Same key + same payload within 24 hours replays the original response; conflicting payload returns validation_failed."
},
"privacyAccepted": {
"type": "boolean",
"description": "Must be true when not using OAuth."
},
"specialRequests": {
"type": "string",
"description": "Free-text notes for the school."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"status": {
"type": "string",
"description": "e.g. awaiting_school_confirmation."
},
"success": {
"const": true
},
"bookingId": {
"type": [
"integer",
"null"
],
"description": "Craft booking id when returned by the booking engine."
},
"redirectUrl": {
"type": [
"string",
"null"
]
},
"studentMessage": {
"type": "string"
},
"bookingReference": {
"type": [
"string",
"null"
]
},
"agent_must_tell_the_user": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"annotations": {
"title": "Create unpaid booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| contact | object | Optional first_name, last_name. Email always comes from the verified account. |
| trip_id | string | Optional trip_id from save_trip. |
| comments | string | Student message to the school. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
| idempotencyKey | string | Optional alias of idempotency_key. |
| idempotency_key | string | Optional. Same semantics as create_booking (24 hour replay window). |
{
"name": "request_quote",
"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": {
"type": "object",
"properties": {
"contact": {
"type": "object",
"description": "Optional first_name, last_name. Email always comes from the verified account.",
"additionalProperties": true
},
"trip_id": {
"type": "string",
"description": "Optional trip_id from save_trip."
},
"comments": {
"type": "string",
"description": "Student message to the school."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
},
"idempotencyKey": {
"type": "string",
"description": "Optional alias of idempotency_key."
},
"idempotency_key": {
"type": "string",
"description": "Optional. Same semantics as create_booking (24 hour replay window)."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"kind": {
"enum": [
"quote"
],
"type": "string",
"description": "Lead type on success."
},
"message": {
"type": "string",
"description": "Human-readable confirmation (not a booking confirmation)."
},
"success": {
"const": true
},
"redirectUrl": {
"type": [
"string",
"null"
],
"description": "Extralingo /my URL for the student to follow the request, when available."
},
"newBookingId": {
"type": [
"integer",
"null"
],
"description": "Craft newBookings entry id when created."
}
},
"additionalProperties": true
},
"annotations": {
"title": "Request quote",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| contact | object | Optional first_name, last_name. Email always comes from the verified account. |
| message | string | Student message to the school. |
| trip_id | string | Optional trip_id from save_trip. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
| idempotencyKey | string | Optional alias of idempotency_key. |
| idempotency_key | string | Optional. Same semantics as create_booking (24 hour replay window). |
{
"name": "request_discussion",
"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": {
"type": "object",
"properties": {
"contact": {
"type": "object",
"description": "Optional first_name, last_name. Email always comes from the verified account.",
"additionalProperties": true
},
"message": {
"type": "string",
"description": "Student message to the school."
},
"trip_id": {
"type": "string",
"description": "Optional trip_id from save_trip."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
},
"idempotencyKey": {
"type": "string",
"description": "Optional alias of idempotency_key."
},
"idempotency_key": {
"type": "string",
"description": "Optional. Same semantics as create_booking (24 hour replay window)."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"kind": {
"enum": [
"discussion"
],
"type": "string",
"description": "Lead type on success."
},
"message": {
"type": "string",
"description": "Human-readable confirmation (not a booking confirmation)."
},
"success": {
"const": true
},
"redirectUrl": {
"type": [
"string",
"null"
],
"description": "Extralingo /my URL for the student to follow the request, when available."
},
"newBookingId": {
"type": [
"integer",
"null"
],
"description": "Craft newBookings entry id when created."
}
},
"additionalProperties": true
},
"annotations": {
"title": "Request discussion",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Send a question to the school without a full trip configuration. Requires OAuth requests scope. Optional idempotency_key.
| Parameter | Type | Description |
|---|---|---|
| contact | object | Optional first_name, last_name. Email always comes from the verified account. |
| message * | string | Student message to the school. |
| trip_id | string | Optional trip_id from save_trip. |
| currency | string | ISO 4217 currency for prices in this call. Usually EUR. |
| school_id * | integer | Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID. |
| configuration | object | Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras. |
| idempotencyKey | string | Optional alias of idempotency_key. |
| idempotency_key | string | Optional. Same semantics as create_booking (24 hour replay window). |
{
"name": "ask_school_question",
"description": "Send a question to the school without a full trip configuration. Requires OAuth requests scope. Optional idempotency_key.",
"inputSchema": {
"type": "object",
"required": [
"school_id",
"message"
],
"properties": {
"contact": {
"type": "object",
"description": "Optional first_name, last_name. Email always comes from the verified account.",
"additionalProperties": true
},
"message": {
"type": "string",
"description": "Student message to the school."
},
"trip_id": {
"type": "string",
"description": "Optional trip_id from save_trip."
},
"currency": {
"type": "string",
"default": "EUR",
"examples": [
"EUR"
],
"description": "ISO 4217 currency for prices in this call. Usually EUR."
},
"school_id": {
"type": "integer",
"examples": [
12345
],
"description": "Craft CMS school entry id from search_language_schools hits (field school_id). Not the CRM UUID."
},
"configuration": {
"type": "object",
"properties": {
"mealType": {
"type": "string",
"description": "Meal plan key when accommodation is selected."
},
"students": {
"type": "array",
"items": {
"type": "object",
"properties": {
"weeks": {
"type": "integer",
"minimum": 1,
"description": "Course duration in weeks."
},
"courseId": {
"type": "string",
"description": "Course product id from list_courses for this school."
}
},
"additionalProperties": true
},
"description": "One object per traveller. courseId comes from list_courses."
},
"startDate": {
"type": "string",
"examples": [
"2026-09-07"
],
"description": "Course start calendar date (YYYY-MM-DD). Typically a Monday from list_starting_dates."
},
"accommodationGroupId": {
"type": "string",
"description": "Accommodation group id from list_accommodations (optional)."
}
},
"description": "Same shape as the Extralingo school-page configurator: startDate (YYYY-MM-DD), students[] with courseId, weeks, optional accommodationGroupId, mealType, extras.",
"additionalProperties": true
},
"idempotencyKey": {
"type": "string",
"description": "Optional alias of idempotency_key."
},
"idempotency_key": {
"type": "string",
"description": "Optional. Same semantics as create_booking (24 hour replay window)."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"required": [
"success"
],
"properties": {
"kind": {
"enum": [
"question"
],
"type": "string",
"description": "Lead type on success."
},
"message": {
"type": "string",
"description": "Human-readable confirmation (not a booking confirmation)."
},
"success": {
"const": true
},
"redirectUrl": {
"type": [
"string",
"null"
],
"description": "Extralingo /my URL for the student to follow the request, when available."
},
"newBookingId": {
"type": [
"integer",
"null"
],
"description": "Craft newBookings entry id when created."
}
},
"additionalProperties": true
},
"annotations": {
"title": "Ask school a question",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Extralingo is a language-travel booking platform. Use these tools to search schools, build a trip, and submit it. Finder prices are indicative. Always call calculate_trip_price before telling the student a total. save_trip returns trip_id, url, trip_url, and continue_url (/s/{id}). continue_url restores the saved configuration on Extralingo.com. Reuse trip_id. Write tools (save_trip, email_trip, bookings, quotes, school contact) require OAuth 2.1. See /auth.md. create_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. If bookings_live is false, use request_quote instead of create_booking. school_id is the Craft id from search hits. Pass locale en, nl, da, or sv. Website handoff: Students can explore, configure and, where supported, book their language trip conversationally. If a student prefers to browse or continue on Extralingo.com, provide the appropriate website URL: - Use the school URL when they want to browse the school page. - Use the destination URL when they want to browse a destination. - Once a trip has been configured and saved, prefer continue_url (/s/{trip_id}) because it restores their selections. When 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. If they choose the website, save the current trip first where appropriate and provide continue_url so they do not have to configure everything again. If they choose chat, continue through the MCP booking flow. Do not unnecessarily redirect students to the website during normal discovery, comparison or trip configuration if their request can be handled conversationally.
Names, descriptions and schemas were written by the server and are shown as data.