All integrations

Festivalhistorik

Connect Festivalhistorik via OAuth — track seen festivals and artists, and manage favorites from Claude, ChatGPT, or Cursor.

OAuth 14 tools

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

  1. Sign in to stackgate.ai.
  2. Go to My Integrations and open Festivalhistorik.
  3. Click Connect Festivalhistorik and choose Full access or scoped tools.
  4. On Festivalhistorik, sign in or register, then approve the requested scopes (user:read, favorites:read, favorites:write).
  5. 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/festivalhistorik with 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 http vs https). 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, or list_festival_artists before 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.