LONG Events

Esta página é escrita tanto para o agente quanto para o desenvolvedor que o configura. Ela indica qual superfície usar para cada tarefa, como cada cliente se conecta, como uma solicitação em linguagem natural é mapeada para uma ferramenta e onde estão os contratos legíveis por máquina.

Qual superfície usar

Cada superfície lê o mesmo catálogo; escolha conforme a forma de trabalho de quem chama.

MCP

Agentes e assistentes que usam ferramentas. Um endpoint HTTP streamable, 16 ferramentas, descoberta gratuita, pagamento por chamada embutido.

REST

Aplicações, notebooks e tarefas agendadas. Dois endpoints que despacham com base em um parâmetro de ação, descritos por OpenAPI 3.1.

x402

Agentes autônomos com carteira e sem conta. Chame qualquer superfície sem chave, leia os requisitos HTTP 402, pague e tente novamente.

Web pages

Citações para pessoas. Páginas de evento, cidade, semana, artista, local e organizador em belong.events carregam dados estruturados de Event e link para a bilheteria.

Conectar um cliente MCP

O endpoint é https://long.events/functions/v1/mcp-server/mcp para todos os clientes. initialize, ping e tools/list são gratuitos e não exigem chave, então um cliente pode verificar o servidor antes de qualquer configuração.

Claude Code

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

Claude Desktop, Claude.ai and Claude apps

Configurações → Conectores → Adicionar conector personalizado com a URL https://long.events/functions/v1/mcp-server/mcp. Sem OAuth: a descoberta é anônima, e uma chave de API pode ser enviada como cabeçalho X-API-Key onde o cliente permitir cabeçalhos.

Cursor and VS Code

Adicione um servidor HTTP streamable chamado long-events com a URL https://long.events/functions/v1/mcp-server/mcp à configuração MCP do editor.

OpenAI Responses API and Agents SDK

Passe uma ferramenta MCP hospedada: { "type": "mcp", "server_label": "long_events", "server_url": "https://long.events/functions/v1/mcp-server/mcp" }.

Any other MCP client or framework

Transporte HTTP streamable, JSON-RPC 2.0, POST https://long.events/functions/v1/mcp-server/mcp. Envie initialize, depois tools/list, depois tools/call.

Plain HTTP, no MCP

GET https://long.events/functions/v1/api-events?action=discover&city=Lisbon&limit=20 com um cabeçalho X-API-Key, ou sem um para receber os requisitos de pagamento x402.

OpenClaw skill

clawdhub install long-events instala o pacote de skill cujo código-fonte vive no repositório sob long-events/.

De uma solicitação a uma ferramenta

Solicitações que os agentes recebem com mais frequência, e a primeira chamada que responde a cada uma. Cada ferramenta retorna local, cidade, horário local, organizador e contexto de ingressos, então uma segunda chamada raramente é necessária para agir.

"What is on in Lisbon this weekend?"

search_events com city, start_date e end_date; ação REST discover com os mesmos parâmetros.

"Techno parties near me tonight"

search_events com latitude, longitude, radius_km, category e uma janela de um dia.

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

search_event_weeks por nome, depois get_event_week_details para o programa completo de eventos paralelos.

"Which cities have a conference week next month?"

get_event_week_cities, ou get_event_weeks com upcoming definido.

"When does Peggy Gou play next?"

get_artist_events com o nome do artista e upcoming_only; search_artists quando a grafia é incerta.

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

get_now_playing com o event_id ou city.

"What time does ANOTR play?"

get_event_schedule com o event_id ou event_name; retorna palcos e horários no relógio do local.

"Best venues for electronic music in Berlin"

get_venues com a city; cada local carrega seu programa futuro.

"Who organizes crypto events in Lisbon?"

search_organizers com uma consulta, ou search_events com categoria crypto e leia o campo organizer.

"Which cities have the most events?"

get_cities, ou a ação REST catalog_stats.

"Full details and the ticket link for this event"

get_event_details com o event_id; ticket_url é o caminho resolvido da bilheteria, não outro site de listagem. Rank, predicted_end_time e ticket_offer viajam no mesmo payload.

Pagamento por chamada

Uma chamada medida sem chave de API retorna HTTP 402 com requisitos x402 versão 2: valor, ativo, rede e endereço de pagamento. O caminho padrão é USDC na Base por meio de um facilitador; pacotes de dez chamadas autofacilitados estão disponíveis em USDT, USDC ou USD1 na BNB Chain e em LONG. Pelo MCP, o mesmo pagamento viaja em _meta["x402/payment"] em tools/call, e o recibo de liquidação volta no resultado. O preço padrão é meio centavo por chamada; api-pricing é a fonte autoritativa.

Citando e vinculando

Cite a URL da página do evento retornada com cada evento para pessoas, e ticket_url para o caminho de compra; ambos resolvem para o organizador ou bilheteria, em vez de outro agregador. Os dados são agregados diariamente de fontes primárias e cada registro nomeia sua fonte, então uma resposta pode dizer de onde veio a listagem.

Documentos de descoberta legíveis por máquina

Tudo o que um agente, rastreador ou diretório precisa para encontrar e verificar esta API sem ler HTML.

https://long.events/llms.txt

Índice curto da documentação, endpoints e rotas públicas.

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

Toda a documentação do desenvolvedor em um único arquivo de texto simples para recuperação e janelas de contexto.

https://long.events/openapi.json

Contrato OpenAPI 3.1 para os endpoints REST, preços e rotas de descoberta.

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

Cartão do servidor MCP: identidade, endpoint remoto, versões de protocolo e cabeçalhos opcionais.

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

Linkset do catálogo de API RFC 9727 nomeando o contrato, docs e preços para cada âncora de API.

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

Manifesto de descoberta x402: cada recurso pagável com esquemas, redes, ativos e preços aceitos.

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

Cartão de status ao vivo do servidor MCP: contagem de ferramentas, métodos gratuitos e caminhos de pagamento.

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

Preços ao vivo por ação em USD e em cada ativo aceito.