Build with HQ
HQ provides a public API and an authenticated Model Context Protocol (MCP) server. Use the API to read published show data. Use Artist MCP to let a compatible AI client manage unpublished show drafts for an eligible HQ artist account.
This is the supported developer surface today. We will add more documented endpoints and tools over time.
Available now
| Surface | Endpoint | Access | Use |
|---|---|---|---|
| API | GET /v1/public/shows | Public | Find published shows by time, location, artist, and pagination filters. |
| API | GET /v1/artists/{username}/shows | Public | Fetch published shows for one public artist username. |
| MCP | https://api.b90hq.app/mcp | OAuth 2.1 | Read shows and manage unpublished artist show drafts. |
The API endpoints are read-only. They do not need an account, token, or API key. Browser clients may call them from any origin. Responses use JSON.
Artist MCP is a separate authenticated surface. It uses browser consent and requires an eligible HQ artist account. It can create or edit unpublished drafts, but it cannot publish or delete a show.
Get started with the API
Send a request to the production API:
curl --fail-with-body \
'https://api.b90hq.app/v1/public/shows?when=upcoming&limit=10'
Then use the Shows or Artist shows page for the supported query parameters, response fields, pagination behavior, and errors.
Get started with MCP
Open the Artist MCP page and add the remote server to a compatible MCP client. The client opens HQ in your browser so you can sign in and approve access. You do not need to create or paste an API key.
What the documentation covers
The pages in this section define the endpoints, tools, inputs, and response fields that HQ makes available for external use. Undocumented app, dashboard, and internal routes are not part of this supported surface.
The public API returns published shows that are not hidden or deleted. It does not return private RSVP identities, moderation data, credentials, or dashboard-only fields.
You may use the documented public show, artist, venue, schedule, and image URL data for public event listings, discovery, calendars, and integrations under the Terms of Service. Follow the documented limits and stop using data that is no longer public.