Festivalhistorik
Connect Festivalhistorik via OAuth — track seen festivals and artists, and manage favorites from Claude, ChatGPT, or Cursor.
Overview
Connect Festivalhistorik so AI clients can read your profile, seen festivals and artists, browse the public catalog, and manage favorites (ratings).
Festivalhistorik distinguishes FestivalCategory (the brand, e.g. Roskilde Festival) from Festival (a yearly edition, e.g. Roskilde Festival 2026).
Prerequisites
- A Festivalhistorik account (you can register during Connect if you do not have one yet)
- A stackgate.ai account
Getting credentials
- Sign in to stackgate.ai.
- Go to My Integrations and open Festivalhistorik.
- Click Connect Festivalhistorik and choose Full access or scoped tools.
- On Festivalhistorik, sign in or register, then approve the requested scopes (
user:read,favorites:read,favorites:write). - You return to stackgate.ai with OAuth tokens stored securely — no API keys to paste.
Email verification on Festivalhistorik does not block OAuth completion.
Using with AI clients
- Dedicated endpoint:
POST /mcp/festivalhistorikwith a Sanctum bearer token - Private gateway: one config for all integrations — use
festivalhistorik__*namespaced tools
See Documentation for HTTP authentication and private gateway setup.
Troubleshooting
- 422 integration not configured — complete the Connect Festivalhistorik OAuth flow in My Integrations.
- Authorize / redirect errors — the redirect URI must match exactly (including
httpvshttps). Hub default:https://stackgate.ai/oauth/festivalhistorik/callback. - 401 / token expired — reconnect Festivalhistorik from the integration page (access tokens last ~15 days; refresh tokens ~30 days).
- Missing festival or artist IDs — use
search-tool,list_festivals, orlist_festival_artistsbefore creating favorites. - Create favorite fails — use
create_favorite(POST /favorites/items), not the legacy toggle endpoint.
Available tools
-
get_me
Return the connected Festivalhistorik user profile.
-
list_profile_festivals
List festivals the connected user has favorited (seen history).
-
list_profile_artists
List artists the connected user has favorited at festivals (seen history).
-
list_favorites
List the connected user's favorites. Optionally filter by festival_id or artist_id.
-
get_favorite
Get a single favorite by ID.
-
search
Search public festivals and artists by term (min 2 characters).
-
list_festivals
List public festival editions (yearly festivals).
-
get_festival
Get a public festival edition by ID.
-
list_festival_artists
List artists appearing at a festival edition.
-
list_artists
List public artists.
-
get_artist
Get a public artist by ID.
-
create_favorite
Create a favorite (idempotent). Pass festival_id and/or artist_id. Optional rating 1–5 and rating_reason (max 800).
-
update_favorite
Update a favorite rating and/or rating_reason.
-
delete_favorite
Delete a favorite by ID.
MCP endpoint:
https://stackgate.ai/mcp/festivalhistorik
(HTTP) or via the
private gateway.