Developer documentation

One catalog of real-world events, reachable two ways: a documented REST API for applications, and a streamable HTTP MCP server for agents. Discovery is free, and a metered call can be paid for without an account.

Public endpoints

Every production surface lives on long.events and answers without a browser. The OpenAPI document is the machine-readable contract for the REST half.

https://long.events/functions/v1/api-events: Events, schedules, set times, now playing, and artists.
https://long.events/functions/v1/api-event-weeks: Conference weeks, festivals, cities, tags, and side events.
https://long.events/functions/v1/mcp-server/mcp: Streamable HTTP MCP endpoint exposing 16 tools.
https://long.events/functions/v1/long-five: The immutable weekly five-city chart.
https://long.events/functions/v1/api-pricing: Live per-action prices and the supported payment lanes.
https://long.events/functions/v1/x402-discovery: Machine-readable catalog of paid resources.
https://long.events/openapi.json: OpenAPI 3.1 contract for code generation and agent ingestion.

Authentication and payment

Pick the access path that matches the caller. A person or an application uses an API key; an autonomous agent can pay for a single call instead of holding an account.

API key: Send a LONG or Belong key in the X-API-Key header. Keys carry a per-minute free-tier allowance of 60 requests.
x402 per call: Call without a key, read the HTTP 402 payment requirements, sign the quoted USDC payment on Base, and retry.
Token bundles: Prepay a block of calls in LONG or BSC stablecoins (USDT, USDC, USD1).
Free: MCP initialize, ping, tools/list and notifications are never charged, so an agent can inspect the contract first.

What the data covers

The catalog is aggregated daily from dozens of primary sources and normalized into one graph: events, their venues and cities, the artists on the bill, the organizers behind them, multi-day event weeks and their side events, stage schedules, and resolved ticket paths that point at the box office rather than at another listing site.