RAWG Game Discovery

naftiko: "1.0.0-alpha1"

info:
  label: "RAWG Game Discovery"
  description: >-
    Unified game discovery and research capability powered by the RAWG Video
    Games Database. Enables developers, content creators, and gaming
    applications to search, filter, and retrieve comprehensive game metadata
    including detailed game information, platform availability, developer and
    publisher data, genre classification, community ratings, screenshots,
    trailers, achievements, store links, and social content. Supports
    AI-assisted game recommendation workflows through MCP tooling.
  tags:
    - RAWG
    - Video Games
    - Gaming
    - Game Discovery
    - Entertainment
    - Database
    - Metadata
  created: "2026-05-02"
  modified: "2026-05-02"

binds:
  - namespace: env
    keys:
      RAWG_API_KEY: RAWG_API_KEY

capability:
  consumes:
    - import: rawg
      location: ./shared/rawg-video-games-database.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: rawg-discovery-api
      description: "Unified REST API for game discovery and metadata retrieval."
      resources:
        - path: /v1/games
          name: games
          description: "Video game search and filtering"
          operations:
            - method: GET
              name: list-games
              description: "Search and filter games across the RAWG database"
              call: "rawg.list-games"
              with:
                search: "rest.search"
                platforms: "rest.platforms"
                genres: "rest.genres"
                developers: "rest.developers"
                publishers: "rest.publishers"
                tags: "rest.tags"
                dates: "rest.dates"
                metacritic: "rest.metacritic"
                ordering: "rest.ordering"
                page: "rest.page"
                page_size: "rest.page_size"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}
          name: game-detail
          description: "Complete game metadata"
          operations:
            - method: GET
              name: get-game
              description: "Get full game details"
              call: "rawg.get-game"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/additions
          name: game-additions
          description: "DLCs and editions for a game"
          operations:
            - method: GET
              name: list-game-additions
              description: "List DLCs and game editions"
              call: "rawg.list-game-additions"
              with:
                game_pk: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/series
          name: game-series
          description: "Games in the same series"
          operations:
            - method: GET
              name: list-game-series
              description: "List games in the series"
              call: "rawg.list-game-series"
              with:
                game_pk: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/screenshots
          name: game-screenshots
          description: "Game screenshots"
          operations:
            - method: GET
              name: list-game-screenshots
              description: "List game screenshots"
              call: "rawg.list-game-screenshots"
              with:
                game_pk: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/stores
          name: game-stores
          description: "Where to buy the game"
          operations:
            - method: GET
              name: list-game-stores
              description: "List store purchase links"
              call: "rawg.list-game-stores"
              with:
                game_pk: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/achievements
          name: game-achievements
          description: "Game achievements"
          operations:
            - method: GET
              name: list-game-achievements
              description: "List game achievements"
              call: "rawg.list-game-achievements"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/trailers
          name: game-trailers
          description: "Game trailers and videos"
          operations:
            - method: GET
              name: list-game-trailers
              description: "List game trailers"
              call: "rawg.list-game-trailers"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/games/{id}/reddit
          name: game-reddit
          description: "Game subreddit posts"
          operations:
            - method: GET
              name: list-game-reddit-posts
              description: "List recent Reddit posts for the game"
              call: "rawg.list-game-reddit-posts"
              with:
                id: "rest.id"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/genres
          name: genres
          description: "Video game genres"
          operations:
            - method: GET
              name: list-genres
              description: "List all game genres"
              call: "rawg.list-genres"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/platforms
          name: platforms
          description: "Gaming platforms"
          operations:
            - method: GET
              name: list-platforms
              description: "List all gaming platforms"
              call: "rawg.list-platforms"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/developers
          name: developers
          description: "Game developers"
          operations:
            - method: GET
              name: list-developers
              description: "List game development studios"
              call: "rawg.list-developers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/publishers
          name: publishers
          description: "Game publishers"
          operations:
            - method: GET
              name: list-publishers
              description: "List game publishers"
              call: "rawg.list-publishers"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/stores
          name: stores
          description: "Game storefronts"
          operations:
            - method: GET
              name: list-stores
              description: "List game storefronts"
              call: "rawg.list-stores"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/tags
          name: tags
          description: "Game tags"
          operations:
            - method: GET
              name: list-tags
              description: "List all game tags"
              call: "rawg.list-tags"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/creators
          name: creators
          description: "Game creators"
          operations:
            - method: GET
              name: list-creators
              description: "List individual game creators"
              call: "rawg.list-creators"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: rawg-discovery-mcp
      transport: http
      description: "MCP server for AI-assisted game discovery and research using the RAWG database."
      tools:
        - name: search-games
          description: "Search and filter the RAWG game catalog by title, platform, genre, developer, publisher, tag, release date, or Metacritic score"
          hints:
            readOnly: true
            openWorld: true
            idempotent: true
          call: "rawg.list-games"
          with:
            search: "tools.search"
            platforms: "tools.platforms"
            genres: "tools.genres"
            developers: "tools.developers"
            publishers: "tools.publishers"
            tags: "tools.tags"
            dates: "tools.dates"
            metacritic: "tools.metacritic"
            ordering: "tools.ordering"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-game-details
          description: "Get comprehensive metadata for a specific game including ratings, platforms, genres, website, and community data"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.get-game"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-dlcs
          description: "List DLCs, game editions, and companion apps for a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-additions"
          with:
            game_pk: "tools.game_pk"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-series
          description: "Find other games that are part of the same franchise or series"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-series"
          with:
            game_pk: "tools.game_pk"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-development-team
          description: "List the individual creators and developers who built a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-development-team"
          with:
            game_pk: "tools.game_pk"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-screenshots
          description: "Get screenshot images for a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-screenshots"
          with:
            game_pk: "tools.game_pk"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-purchase-links
          description: "Find where to buy a game across digital storefronts (Steam, Epic, PlayStation Store, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-stores"
          with:
            game_pk: "tools.game_pk"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-achievements
          description: "List all achievements available in a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-achievements"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-trailers
          description: "Get official trailers and video content for a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-trailers"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-game-community-posts
          description: "Get recent Reddit community posts and discussions about a game"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-game-reddit-posts"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-similar-games
          description: "Find visually similar games for recommendation (enterprise tier)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-suggested-games"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-genres
          description: "List all video game genres (Action, RPG, Strategy, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-genres"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-platforms
          description: "List all gaming platforms (PC, PlayStation, Xbox, Nintendo Switch, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-platforms"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-parent-platforms
          description: "List parent platform families (PlayStation, Xbox, Nintendo, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-parent-platforms"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-developers
          description: "List game development studios and companies"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-developers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-publishers
          description: "List game publishing companies"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-publishers"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-storefronts
          description: "List digital and physical game storefronts (Steam, GOG, Epic Games Store, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-stores"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-tags
          description: "List all community game tags (singleplayer, open-world, co-op, etc.)"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-tags"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-creators
          description: "List individual game creators, designers, and artists"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-creators"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-creator-details
          description: "Get the profile and credits of an individual game creator"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.get-creator"
          with:
            id: "tools.id"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-creator-roles
          description: "List all job roles and positions in game development"
          hints:
            readOnly: true
            idempotent: true
          call: "rawg.list-creator-roles"
          outputParameters:
            - type: object
              mapping: "$."