SeatGeek Event Discovery

naftiko: "1.0.0-alpha1"

info:
  label: "SeatGeek Event Discovery"
  description: >-
    Unified event discovery capability combining SeatGeek's events, performers, venues,
    and recommendation APIs. Enables applications to build comprehensive live event
    discovery experiences with geolocation search, performer browsing, venue exploration,
    and personalized recommendations for concerts, sports, and theater.
  tags:
    - Events
    - Live Events
    - Concerts
    - Sports
    - Ticketing
    - Discovery
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      SEATGEEK_CLIENT_ID: SEATGEEK_CLIENT_ID

capability:
  consumes:
    - import: seatgeek-platform
      location: ./shared/platform.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: event-discovery-api
      description: "Unified REST API for live event discovery with SeatGeek."
      resources:
        - path: /v1/events
          name: events
          description: "Search and browse live events"
          operations:
            - method: GET
              name: list-events
              description: "Search events by keyword, performer, venue, date, or location"
              call: "seatgeek-platform.list-events"
              with:
                q: "rest.q"
                lat: "rest.lat"
                lon: "rest.lon"
                range: "rest.range"
                per_page: "rest.per_page"
                page: "rest.page"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/events/{event_id}
          name: event-detail
          description: "Event details and ticket pricing"
          operations:
            - method: GET
              name: get-event
              description: "Get full event details with ticket pricing"
              call: "seatgeek-platform.get-event"
              with:
                event_id: "rest.event_id"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/performers
          name: performers
          description: "Browse performers"
          operations:
            - method: GET
              name: list-performers
              description: "Search for artists, teams, and performers"
              call: "seatgeek-platform.list-performers"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/performers/{performer_id}
          name: performer-detail
          description: "Performer profile and upcoming events"
          operations:
            - method: GET
              name: get-performer
              description: "Get performer details"
              call: "seatgeek-platform.get-performer"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/venues
          name: venues
          description: "Search venues"
          operations:
            - method: GET
              name: list-venues
              description: "Find venues by city, state, or location radius"
              call: "seatgeek-platform.list-venues"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/taxonomies
          name: taxonomies
          description: "Event categories and classifications"
          operations:
            - method: GET
              name: list-taxonomies
              description: "List all event taxonomy categories"
              call: "seatgeek-platform.list-taxonomies"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/recommendations
          name: recommendations
          description: "Personalized event recommendations"
          operations:
            - method: GET
              name: get-recommendations
              description: "Get personalized event recommendations"
              call: "seatgeek-platform.get-recommendations"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: event-discovery-mcp
      transport: http
      description: "MCP server for AI-assisted live event discovery with SeatGeek."
      tools:
        - name: search-events
          description: "Search for live events by artist name, genre, location, date range, or ticket price"
          hints:
            readOnly: true
            openWorld: true
          call: "seatgeek-platform.list-events"
          with:
            q: "tools.q"
            lat: "tools.lat"
            lon: "tools.lon"
            range: "tools.range"
            per_page: "tools.per_page"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-event-details
          description: "Get full details for a specific event including venue, performers, ticket pricing, and seat availability"
          hints:
            readOnly: true
            openWorld: false
          call: "seatgeek-platform.get-event"
          with:
            event_id: "tools.event_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: search-performers
          description: "Search for concert artists, sports teams, theater companies, and other performers"
          hints:
            readOnly: true
            openWorld: true
          call: "seatgeek-platform.list-performers"
          with:
            q: "tools.q"
            slug: "tools.slug"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-performer-details
          description: "Get performer profile, genre, and upcoming event count"
          hints:
            readOnly: true
            openWorld: false
          call: "seatgeek-platform.get-performer"
          with:
            performer_id: "tools.performer_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: search-venues
          description: "Find event venues by city, state, country, or location radius"
          hints:
            readOnly: true
            openWorld: true
          call: "seatgeek-platform.list-venues"
          with:
            city: "tools.city"
            state: "tools.state"
            lat: "tools.lat"
            lon: "tools.lon"
            range: "tools.range"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-event-categories
          description: "List available event taxonomy categories such as concerts, sports, and theater"
          hints:
            readOnly: true
            openWorld: false
          call: "seatgeek-platform.list-taxonomies"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-event-recommendations
          description: "Get personalized event recommendations based on user location and interests"
          hints:
            readOnly: true
            openWorld: true
          call: "seatgeek-platform.get-recommendations"
          with:
            lat: "tools.lat"
            lon: "tools.lon"
            performers.id: "tools.performer_ids"
          outputParameters:
            - type: object
              mapping: "$."