Salsa Vida
Find Salsa and Bachata events and destination guides worldwide.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.salsavida.com/mcp"
}
}
}Remote endpoints
https://mcp.salsavida.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢search_events(location, date_from, date_to, dance, event_type, ...)
Find published salsa/bachata events for a location and dates. Defaults to UTC today through 13 days later; for today/tonight pass the user-local date. Supports up to one year, 50 results/page and 10 pages. response_size_limited means the page was shortened to fit; follow next_cursor. Narrow filters when pagination_limit_reached is true.
Input Schema
{
"type": "object",
"properties": {
"location": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Salsa Vida source location ID, slug, or location name. Use search_locations to disambiguate."
},
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
},
"dance": {
"type": "string",
"enum": [
"salsa",
"bachata"
]
},
"event_type": {
"type": "string",
"enum": [
"social",
"lesson",
"festival"
]
},
"salsa_style": {
"type": "string",
"enum": [
"linear-salsa",
"salsa-on1",
"salsa-on2",
"cuban-salsa",
"salsa-rueda",
"salsa-calena",
"afro-cuban"
],
"description": "Filter recorded Salsa style tags. Many events have no recorded style, so an empty result does not prove the style is absent. linear-salsa includes salsa-on1/salsa-on2; cuban-salsa includes salsa-rueda."
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"ja",
"de",
"fr",
"fr-fr",
"it",
"nl",
"pt",
"ka",
"pl",
"tr"
]
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"location"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"calendar_basis": {
"type": "string",
"const": "event_local_calendar_dates"
},
"default_window_basis": {
"type": "string",
"const": "UTC today through UTC today plus 13 calendar dates; pass explicit user-local dates for today or tonight."
},
"source": {
"type": "string",
"const": "Salsa Vida"
},
"coverage": {
"type": "object",
"properties": {
"from": {
"type": [
"string",
"null"
]
},
"through": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"through"
],
"additionalProperties": false
},
"source_checked_at": {
"type": [
"string",
"null"
]
},
"changes_checked_at": {
"type": [
"string",
"null"
]
},
"dates_are_local": {
"type": "boolean",
"const": true
},
"freshness": {
"type": "string",
"enum": [
"unknown",
"fresh",
"delayed",
"degraded"
]
},
"freshness_warning": {
"type": [
"string",
"null"
]
},
"location": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"additionalProperties": false
},
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date_verification": {
"type": "string",
"const": "scheduled_from_recorded_data_not_organizer_confirmed"
},
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"visit_url": {
"type": "string",
"format": "uri"
},
"returned_language": {
"type": "string"
},
"locale_fallback": {
"type": "boolean"
},
"event_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"social",
"lesson",
"festival"
]
}
},
"dances": {
"type": "array",
"items": {
"type": "string",
"enum": [
"salsa",
"bachata"
]
}
},
"salsa_styles": {
"type": "array",
"items": {
"type": "string"
}
},
"venue": {
"type": "string"
},
"address": {
"type": "string"
},
"price": {
"type": "string"
},
"time_mode": {
"type": "string",
"enum": [
"fixed",
"varies",
"tba"
]
},
"start_time": {
"type": [
"string",
"null"
]
},
"end_time": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"source_modified_at": {
"type": [
"string",
"null"
]
},
"occurrence_id": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
}
},
"required": [
"date_verification",
"event_id",
"title",
"summary",
"canonical_url",
"visit_url",
"returned_language",
"locale_fallback",
"event_types",
"dances",
"salsa_styles",
"venue",
"address",
"price",
"time_mode",
"start_time",
"end_time",
"timezone",
"source_modified_at",
"occurrence_id",
"start_date",
"end_date"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"pagination_limit_reached": {
"type": "boolean"
},
"response_size_limited": {
"type": "boolean"
}
},
"required": [
"calendar_basis",
"default_window_basis",
"source",
"coverage",
"source_checked_at",
"changes_checked_at",
"dates_are_local",
"freshness",
"freshness_warning",
"location",
"date_from",
"date_to",
"results",
"next_cursor",
"pagination_limit_reached",
"response_size_limited"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_event(event_id, language, date_from, date_to)
Read public event facts and dated occurrences within a requested window (default UTC today through 13 days later; pass user-local dates for today/tonight). Unknown timezones remain null. Inactive/private events are unavailable.
Input Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"ja",
"de",
"fr",
"fr-fr",
"it",
"nl",
"pt",
"ka",
"pl",
"tr"
]
},
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"calendar_basis": {
"type": "string",
"const": "event_local_calendar_dates"
},
"default_window_basis": {
"type": "string",
"const": "UTC today through UTC today plus 13 calendar dates; pass explicit user-local dates for today or tonight."
},
"source": {
"type": "string",
"const": "Salsa Vida"
},
"coverage": {
"type": "object",
"properties": {
"from": {
"type": [
"string",
"null"
]
},
"through": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"through"
],
"additionalProperties": false
},
"source_checked_at": {
"type": [
"string",
"null"
]
},
"changes_checked_at": {
"type": [
"string",
"null"
]
},
"dates_are_local": {
"type": "boolean",
"const": true
},
"freshness": {
"type": "string",
"enum": [
"unknown",
"fresh",
"delayed",
"degraded"
]
},
"freshness_warning": {
"type": [
"string",
"null"
]
},
"date_verification": {
"type": "string",
"const": "scheduled_from_recorded_data_not_organizer_confirmed"
},
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"visit_url": {
"type": "string",
"format": "uri"
},
"returned_language": {
"type": "string"
},
"locale_fallback": {
"type": "boolean"
},
"event_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"social",
"lesson",
"festival"
]
}
},
"dances": {
"type": "array",
"items": {
"type": "string",
"enum": [
"salsa",
"bachata"
]
}
},
"salsa_styles": {
"type": "array",
"items": {
"type": "string"
}
},
"venue": {
"type": "string"
},
"address": {
"type": "string"
},
"price": {
"type": "string"
},
"time_mode": {
"type": "string",
"enum": [
"fixed",
"varies",
"tba"
]
},
"start_time": {
"type": [
"string",
"null"
]
},
"end_time": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"source_modified_at": {
"type": [
"string",
"null"
]
},
"date_from": {
"type": "string"
},
"date_to": {
"type": "string"
},
"occurrences": {
"type": "array",
"items": {
"type": "object",
"properties": {
"occurrence_id": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
}
},
"required": [
"occurrence_id",
"start_date",
"end_date"
],
"additionalProperties": false
}
}
},
"required": [
"calendar_basis",
"default_window_basis",
"source",
"coverage",
"source_checked_at",
"changes_checked_at",
"dates_are_local",
"freshness",
"freshness_warning",
"date_verification",
"event_id",
"title",
"summary",
"canonical_url",
"visit_url",
"returned_language",
"locale_fallback",
"event_types",
"dances",
"salsa_styles",
"venue",
"address",
"price",
"time_mode",
"start_time",
"end_time",
"timezone",
"source_modified_at",
"date_from",
"date_to",
"occurrences"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢search_locations(query, language, limit, cursor)
Find Salsa Vida cities, regions and countries by name, ignoring case and diacritics. Use the returned source location ID to resolve ambiguous names. Localized guides fall back to English where available. response_size_limited means the page was shortened to fit; follow next_cursor.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"ja",
"de",
"fr",
"fr-fr",
"it",
"nl",
"pt",
"ka",
"pl",
"tr"
]
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"calendar_basis": {
"type": "string",
"const": "event_local_calendar_dates"
},
"default_window_basis": {
"type": "string",
"const": "UTC today through UTC today plus 13 calendar dates; pass explicit user-local dates for today or tonight."
},
"source": {
"type": "string",
"const": "Salsa Vida"
},
"coverage": {
"type": "object",
"properties": {
"from": {
"type": [
"string",
"null"
]
},
"through": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"through"
],
"additionalProperties": false
},
"source_checked_at": {
"type": [
"string",
"null"
]
},
"changes_checked_at": {
"type": [
"string",
"null"
]
},
"dates_are_local": {
"type": "boolean",
"const": true
},
"freshness": {
"type": "string",
"enum": [
"unknown",
"fresh",
"delayed",
"degraded"
]
},
"freshness_warning": {
"type": [
"string",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"source_location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"parent_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"ancestors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"additionalProperties": false
}
},
"canonical_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"visit_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"returned_language": {
"type": [
"string",
"null"
]
},
"locale_fallback": {
"type": "boolean"
}
},
"required": [
"id",
"source_location_id",
"parent_id",
"slug",
"name",
"ancestors",
"canonical_url",
"visit_url",
"returned_language",
"locale_fallback"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"pagination_limit_reached": {
"type": "boolean"
},
"response_size_limited": {
"type": "boolean"
}
},
"required": [
"calendar_basis",
"default_window_basis",
"source",
"coverage",
"source_checked_at",
"changes_checked_at",
"dates_are_local",
"freshness",
"freshness_warning",
"results",
"next_cursor",
"pagination_limit_reached",
"response_size_limited"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_guide(location, language)
Read a public Salsa Vida city, region or country guide summary and its canonical link. Uses only existing published language versions, with English fallback.
Input Schema
{
"type": "object",
"properties": {
"location": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Salsa Vida source location ID, slug, or location name. Use search_locations to disambiguate."
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"ja",
"de",
"fr",
"fr-fr",
"it",
"nl",
"pt",
"ka",
"pl",
"tr"
]
}
},
"required": [
"location"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"calendar_basis": {
"type": "string",
"const": "event_local_calendar_dates"
},
"default_window_basis": {
"type": "string",
"const": "UTC today through UTC today plus 13 calendar dates; pass explicit user-local dates for today or tonight."
},
"source": {
"type": "string",
"const": "Salsa Vida"
},
"coverage": {
"type": "object",
"properties": {
"from": {
"type": [
"string",
"null"
]
},
"through": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"through"
],
"additionalProperties": false
},
"source_checked_at": {
"type": [
"string",
"null"
]
},
"changes_checked_at": {
"type": [
"string",
"null"
]
},
"dates_are_local": {
"type": "boolean",
"const": true
},
"freshness": {
"type": "string",
"enum": [
"unknown",
"fresh",
"delayed",
"degraded"
]
},
"freshness_warning": {
"type": [
"string",
"null"
]
},
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"summary": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"visit_url": {
"type": "string",
"format": "uri"
},
"returned_language": {
"type": "string"
},
"locale_fallback": {
"type": "boolean"
}
},
"required": [
"calendar_basis",
"default_window_basis",
"source",
"coverage",
"source_checked_at",
"changes_checked_at",
"dates_are_local",
"freshness",
"freshness_warning",
"location_id",
"slug",
"name",
"summary",
"canonical_url",
"visit_url",
"returned_language",
"locale_fallback"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence