LONG Events

Esta página está escrita tanto para el agente como para el desarrollador que lo configura. Explica qué superficie usar para cada tarea, cómo se conecta cada cliente, cómo se asigna una solicitud en lenguaje natural a una herramienta y dónde residen los contratos legibles por máquina.

Qué superficie usar

Cada superficie lee el mismo catálogo; elige según cómo trabaje quien realiza la llamada.

MCP

Agentes y asistentes que usan herramientas. Un único endpoint HTTP transmisible, 16 herramientas, descubrimiento gratuito, pago por llamada integrado.

REST

Aplicaciones, cuadernos y trabajos programados. Dos endpoints que despachan según un parámetro de acción, descritos por OpenAPI 3.1.

x402

Agentes autónomos con una cartera y sin cuenta. Llama a cualquiera de las superficies sin clave, lee los requisitos HTTP 402, paga y reintenta.

Web pages

Citas para personas. Las páginas de evento, ciudad, semana, artista, recinto y organizador en belong.events llevan datos estructurados de Event y enlazan a la taquilla.

Conectar un cliente MCP

El endpoint es https://long.events/functions/v1/mcp-server/mcp para todos los clientes. initialize, ping y tools/list son gratuitos y no requieren clave, por lo que un cliente puede verificar el servidor antes de configurar nada.

Claude Code

claude mcp add long-events -t http https://long.events/functions/v1/mcp-server/mcp

Claude Desktop, Claude.ai and Claude apps

Configuración → Conectores → Añadir conector personalizado con la URL https://long.events/functions/v1/mcp-server/mcp. Sin OAuth: el descubrimiento es anónimo y se puede enviar una clave API como cabecera X-API-Key donde el cliente permita cabeceras.

Cursor and VS Code

Añade un servidor HTTP transmisible llamado long-events con la URL https://long.events/functions/v1/mcp-server/mcp a la configuración MCP del editor.

OpenAI Responses API and Agents SDK

Pasa una herramienta MCP alojada: { "type": "mcp", "server_label": "long_events", "server_url": "https://long.events/functions/v1/mcp-server/mcp" }.

Any other MCP client or framework

Transporte HTTP transmisible, JSON-RPC 2.0, POST https://long.events/functions/v1/mcp-server/mcp. Envía initialize, luego tools/list y luego tools/call.

Plain HTTP, no MCP

GET https://long.events/functions/v1/api-events?action=discover&city=Lisbon&limit=20 con una cabecera X-API-Key, o sin ella para recibir los requisitos de pago x402.

OpenClaw skill

clawdhub install long-events instala el paquete de habilidades cuyo código fuente vive en el repositorio bajo long-events/.

De una solicitud a una herramienta

Las solicitudes que los agentes reciben con más frecuencia y la primera llamada que responde a cada una. Cada herramienta devuelve recinto, ciudad, hora local, organizador y contexto de entradas, por lo que rara vez se necesita una segunda llamada para actuar.

"What is on in Lisbon this weekend?"

search_events con city, start_date y end_date; acción REST discover con los mismos parámetros.

"Techno parties near me tonight"

search_events con latitude, longitude, radius_km, category y una ventana de un día.

"What is happening during Token2049 / ETH Denver / Devconnect?"

search_event_weeks por nombre y luego get_event_week_details para el programa completo de eventos paralelos.

"Which cities have a conference week next month?"

get_event_week_cities, o get_event_weeks con upcoming activado.

"When does Peggy Gou play next?"

get_artist_events con el nombre del artista y upcoming_only; search_artists cuando la ortografía sea incierta.

"Who is on stage right now at the festival?"

get_now_playing con event_id o city.

"What time does ANOTR play?"

get_event_schedule con event_id o event_name; devuelve escenarios y horarios en el reloj del recinto.

"Best venues for electronic music in Berlin"

get_venues con la ciudad; cada recinto lleva su programa próximo.

"Who organizes crypto events in Lisbon?"

search_organizers con una consulta, o search_events con categoría crypto y lee el campo organizer.

"Which cities have the most events?"

get_cities, o la acción REST catalog_stats.

"Full details and the ticket link for this event"

get_event_details con event_id; ticket_url es la ruta resuelta de taquilla, no otro sitio de listados. Rank, predicted_end_time y ticket_offer viajan en el mismo payload.

Pagar por llamada

Una llamada medida sin clave API devuelve HTTP 402 con requisitos x402 versión 2: cantidad, activo, red y dirección de pago. La vía estándar es USDC en Base a través de un facilitador; paquetes autofacilitados de diez llamadas están disponibles en USDT, USDC o USD1 en BNB Chain y en LONG. A través de MCP, el mismo pago viaja en _meta["x402/payment"] en tools/call, y el recibo de liquidación regresa en el resultado. El precio predeterminado es medio centavo por llamada; api-pricing es la fuente autoritativa.

Citar y enlazar

Cita la URL de la página del evento devuelta con cada evento para personas, y ticket_url para la ruta de compra; ambas resuelven al organizador o a la taquilla en lugar de a otro agregador. Los datos se agregan diariamente de fuentes primarias y cada registro nombra su fuente, por lo que una respuesta puede indicar de dónde proviene el listado.

Documentos de descubrimiento legibles por máquina

Todo lo que un agente, rastreador o directorio necesita para encontrar y verificar esta API sin leer HTML.

https://long.events/llms.txt

Índice breve de la documentación, endpoints y rutas públicas.

https://long.events/llms-full.txt

Toda la documentación para desarrolladores en un único archivo de texto plano para recuperación y ventanas de contexto.

https://long.events/openapi.json

Contrato OpenAPI 3.1 para los endpoints REST, precios y rutas de descubrimiento.

https://long.events/.well-known/mcp-server-card

Tarjeta del servidor MCP: identidad, endpoint remoto, versiones de protocolo y cabeceras opcionales.

https://long.events/.well-known/api-catalog

Conjunto de enlaces del catálogo de API RFC 9727 que nombra el contrato, la documentación y los precios para cada ancla de API.

https://long.events/.well-known/x402

Manifiesto de descubrimiento x402: cada recurso pagable con esquemas, redes, activos y precios aceptados.

https://long.events/functions/v1/mcp-server

Tarjeta de estado del servidor MCP en vivo: número de herramientas, métodos gratuitos y vías de pago.

https://long.events/functions/v1/api-pricing

Precios por acción en vivo en USD y en cada activo aceptado.