BarMusicLive para IA y desarrolladores

Deja que un asistente de IA o tu propia app responda “qué música en vivo hay” a partir de los anuncios de BarMusicLive. Solo lectura, gratis, sin cuenta y sin clave.

Conectar en un solo paso

Dale esta dirección a tu asistente. Es un servidor Model Context Protocol remoto: no hay nada que instalar, ni cuenta, ni clave.

https://barmusiclive.com/api/mcp/v1.php

Claude (web, escritorio y móvil): agrega un conector personalizado y pega la dirección.

Claude Code:

claude mcp add --transport http barmusiclive https://barmusiclive.com/api/mcp/v1.php

Cursor: en ~/.cursor/mcp.json (o en el .cursor/mcp.json del proyecto):

{
  "mcpServers": {
    "barmusiclive": {
      "url": "https://barmusiclive.com/api/mcp/v1.php"
    }
  }
}

VS Code: en .vscode/mcp.json:

{
  "servers": {
    "barmusiclive": {
      "type": "http",
      "url": "https://barmusiclive.com/api/mcp/v1.php"
    }
  }
}

Cualquier otra app que sea compatible con servidores MCP remotos mediante Streamable HTTP: pega la dirección donde te pida la URL de un servidor.
Claude Desktop, instalado localmente: el paquete de un clic en BarMusicLive para asistentes de IA tiene las mismas herramientas.

Luego pregunta: “¿Qué música en vivo hay en Pensacola este fin de semana?”, “¿Dónde toca Otis Walker Band la próxima vez?” o “¿Qué locales cerca de Huntsville tienen shows esta noche?”

Herramientas

Los seis son de solo lectura e idénticos, palabra por palabra, al servidor descargable.

Herramienta	Qué	Argumentos	Devuelve
`find_shows`	Encontrar música en vivo	town, venue, artist, query, from, to (AAAA-MM-DD), limit	Próximos shows, filtrados. Por defecto: los próximos 7 días a partir de hoy (hora central de EE. UU.).
`search_venues`	Buscar locales	query, town, state, near_lat, near_lng, radius_miles, with_shows, limit	Locales por nombre, ciudad o estado, o dentro de un radio alrededor de un punto.
`get_venue`	Detalles del local y shows	local (slug o nombre)	Dirección, sitio web, tipo y todas las próximas fechas en un local.
`search_artists`	Buscar artistas	query, with_shows, limit	Artistas y bandas por nombre, con la cantidad de fechas próximas.
`get_artist`	Shows de artistas	artist (slug o nombre)	Todas las próximas fechas de un artista o banda.
`list_towns`	Ciudades incluidas	state, limit	Ciudades con la cantidad de locales y próximas fechas de cada una.

Cada resultado incluye el enlace de BarMusicLive del show, el local o el artista. Por favor, comparte ese enlace con la gente y diles que confirmen los horarios con el local.

Recursos, prompts y autocompletado

Recursos: bml://about (cobertura, actualización, cómo citar), bml://feeds (los feeds JSON y sus campos) y las plantillas bml://venue/{slug} y bml://artist/{slug}.
Indicaciones: whats_on (ciudad, cuándo), plan_a_night_out (ciudad, fecha, estilo) y artist_tour (artista).
Autocompletado: sugiere nombres de ciudades y artistas para esas indicaciones.

Protocolo

Versiones: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.
2026-07-28 no tiene estado: no hay initialize. Envía MCP-Protocol-Version, Mcp-Method y, para una herramienta, prompt o recurso, Mcp-Name; deben coincidir con el cuerpo (error -32020 si no). server/discover lista las versiones y capacidades.
Versiones anteriores: initialize primero, como siempre. No se mantiene ninguna sesión, así que no se emite ni se necesita ningún Mcp-Session-Id; cada solicitud es independiente.
Transporte: Streamable HTTP, solo POST, respuestas JSON. Sin flujo de eventos: GET responde 405. Lotes (solo protocolo 2025-03-26 y anteriores) de hasta 5 mensajes; cada mensaje cuenta para los límites.
Errores: -32700 análisis, -32600 solicitud no válida, -32601 método desconocido, -32602 parámetros incorrectos o herramienta desconocida, -32002 recurso desconocido, -32022 versión no compatible (HTTP 400, con la lista de versiones compatibles), -32029 límite de solicitudes (HTTP 429 con Retry-After). Un argumento de herramienta incorrecto se devuelve como un resultado de herramienta legible con isError: true.

Pruébalo desde una terminal (protocolo actual):

curl -s https://barmusiclive.com/api/mcp/v1.php \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' -H 'Mcp-Name: find_shows' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"find_shows","arguments":{"town":"Huntsville, AL"}}}'

O con un protocolo anterior, iniciando una conversación:

curl -s https://barmusiclive.com/api/mcp/v1.php \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"my-app","version":"1.0"}}}'

Límites

60 solicitudes por minuto y 5,000 por día desde una misma dirección (IPv6 se cuenta por /64), y 600 por minuto desde una misma red IPv6 (/48). Por encima de eso: HTTP 429 con Retry-After; espera ese tiempo, por favor.
Una búsqueda usa como máximo sus primeras 8 palabras.
Cuerpo de la solicitud de hasta 64 KB. Hasta 100 filas por resultado.
Los anuncios cubren unas cinco semanas por adelantado y se regeneran cuando se actualiza el sitio. Cada resultado indica cuándo se generaron sus datos.

Sin MCP: los feeds JSON

Los mismos datos en tres archivos sencillos, para cualquier app o script. Cada uno indica sus propios nombres de columna; cada fila es un arreglo en ese orden.

/api/v1/upcoming.json: todos los próximos shows.
/api/v1/venues.json: todos los locales publicados, con coordenadas de mapa cuando se conocen.
/api/v1/artists.json: todos los artistas publicados.

curl -s https://barmusiclive.com/api/v1/upcoming.json
# {"built":"…","through":"…","fields":["date","start","title","url","venue",
#   "venue_name","town_name","town","artists"],"shows":[["2026-11-14","19:00",…],…]}

Calendarios: cada página de local, artista y ciudad ofrece una suscripción (/cal/{venue,artist,town}/{slug}.ics). Los locales y las bandas también pueden mostrar sus fechas en su propio sitio con el widget que se ofrece en su página.

Archivos de descubrimiento

Tarjeta del servidor MCP (el formato de tarjeta de servidor del registro de MCP).
Descripción OpenAPI 3.1 de los feeds y del endpoint MCP.
llms.txt: una guía en texto plano de todo el sitio para modelos de lenguaje.

Lo que no hace

Nunca cambia nada. Nada de publicaciones, votos, cuentas ni contenido de miembros, y nada de la página de Comunidad.
No contiene información personal: los anuncios son solo detalles públicos de locales, artistas y shows.
No consulta otros sitios web ni lee archivos; los recursos son los cuatro que se enumeran arriba.
No te recuerda. Sin cookies, sin sesiones. El límite de uso lleva un conteo diario con un hash unidireccional con clave de la dirección, y los días anteriores se borran. Este servidor no guarda nada de lo que preguntas; como todo sitio web, el registro de acceso del propio proveedor de hosting registra la dirección, la hora y la página solicitada, y lo conserva durante uno o dos meses.

Cómo usar los datos

Úsalo para ayudar a la gente a encontrar música en vivo. Enlaza cada show, local o artista a su página de BarMusicLive y no presentes los anuncios como si fueran tuyos. Los anuncios vienen de locales, artistas y fans, y se revisan antes de publicarse, pero los planes cambian: los horarios están en la hora local del local y conviene confirmarlos con el local.

¿Algo anda mal o tienes una inquietud de seguridad? Contáctanos.