RAWG Video Games Database API — games

naftiko: 1.0.0-alpha2
info:
  label: RAWG Video Games Database API — games
  description: 'RAWG Video Games Database API — games. 14 operations. Lead operation: Get a list of games.. Self-contained
    Naftiko capability covering one Rawg business surface.'
  tags:
  - Rawg
  - games
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    RAWG_API_KEY: RAWG_API_KEY
capability:
  consumes:
  - type: http
    namespace: rawg-games
    baseUri: https://api.rawg.io/api
    description: RAWG Video Games Database API — games business capability. Self-contained, no shared references.
    resources:
    - name: games
      path: /games
      operations:
      - name: gameslist
        method: GET
        description: Get a list of games.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
        - name: search
          in: query
          type: string
          description: Search query.
        - name: search_precise
          in: query
          type: boolean
          description: Disable fuzziness for the search query.
        - name: search_exact
          in: query
          type: boolean
          description: Mark the search query as exact.
        - name: parent_platforms
          in: query
          type: string
          description: 'Filter by parent platforms, for example: `1,2,3`.'
        - name: platforms
          in: query
          type: string
          description: 'Filter by platforms, for example: `4,5`.'
        - name: stores
          in: query
          type: string
          description: 'Filter by stores, for example: `5,6`.'
        - name: developers
          in: query
          type: string
          description: 'Filter by developers, for example: `1612,18893` or `valve-software,feral-interactive`.'
        - name: publishers
          in: query
          type: string
          description: 'Filter by publishers, for example: `354,20987` or `electronic-arts,microsoft-studios`.'
        - name: genres
          in: query
          type: string
          description: 'Filter by genres, for example: `4,51` or `action,indie`.'
        - name: tags
          in: query
          type: string
          description: 'Filter by tags, for example: `31,7` or `singleplayer,multiplayer`.'
        - name: creators
          in: query
          type: string
          description: 'Filter by creators, for example: `78,28` or `cris-velasco,mike-morasky`.'
        - name: dates
          in: query
          type: string
          description: 'Filter by a release date, for example: `2010-01-01,2018-12-31.1960-01-01,1969-12-31`.'
        - name: updated
          in: query
          type: string
          description: 'Filter by an update date, for example: `2020-12-01,2020-12-31`.'
        - name: platforms_count
          in: query
          type: integer
          description: 'Filter by platforms count, for example: `1`.'
        - name: metacritic
          in: query
          type: string
          description: 'Filter by a metacritic rating, for example: `80,100`.'
        - name: exclude_collection
          in: query
          type: integer
          description: 'Exclude games from a particular collection, for example: `123`.'
        - name: exclude_additions
          in: query
          type: boolean
          description: Exclude additions.
        - name: exclude_parents
          in: query
          type: boolean
          description: Exclude games which have additions.
        - name: exclude_game_series
          in: query
          type: boolean
          description: Exclude games which included in a game series.
        - name: exclude_stores
          in: query
          type: string
          description: 'Exclude stores, for example: `5,6`.'
        - name: ordering
          in: query
          type: string
          description: 'Available fields: `name`, `released`, `added`, `created`, `updated`, `rating`, `metacritic`. You can
            reverse the sort order adding a hyphen, for example: `-rele'
    - name: games-game_pk-additions
      path: /games/{game_pk}/additions
      operations:
      - name: gamesadditionslist
        method: GET
        description: Get a list of DLC's for the game, GOTY and other editions, companion apps, etc.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-game_pk-development-team
      path: /games/{game_pk}/development-team
      operations:
      - name: gamesdevelopmentteamlist
        method: GET
        description: Get a list of individual creators that were part of the development team.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ordering
          in: query
          type: string
          description: Which field to use when ordering the results.
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-game_pk-game-series
      path: /games/{game_pk}/game-series
      operations:
      - name: gamesgameserieslist
        method: GET
        description: Get a list of games that are part of the same series.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-game_pk-parent-games
      path: /games/{game_pk}/parent-games
      operations:
      - name: gamesparentgameslist
        method: GET
        description: Get a list of parent games for DLC's and editions.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-game_pk-screenshots
      path: /games/{game_pk}/screenshots
      operations:
      - name: gamesscreenshotslist
        method: GET
        description: Get screenshots for the game.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ordering
          in: query
          type: string
          description: Which field to use when ordering the results.
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-game_pk-stores
      path: /games/{game_pk}/stores
      operations:
      - name: gamesstoreslist
        method: GET
        description: Get links to the stores that sell the game.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ordering
          in: query
          type: string
          description: Which field to use when ordering the results.
        - name: page
          in: query
          type: integer
          description: A page number within the paginated result set.
        - name: page_size
          in: query
          type: integer
          description: Number of results to return per page.
    - name: games-id
      path: /games/{id}
      operations:
      - name: gamesread
        method: GET
        description: Get details of the game.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-achievements
      path: /games/{id}/achievements
      operations:
      - name: gamesachievementsread
        method: GET
        description: Get a list of game achievements.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-movies
      path: /games/{id}/movies
      operations:
      - name: gamesmoviesread
        method: GET
        description: Get a list of game trailers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-reddit
      path: /games/{id}/reddit
      operations:
      - name: gamesredditread
        method: GET
        description: Get a list of most recent posts from the game's subreddit.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-suggested
      path: /games/{id}/suggested
      operations:
      - name: gamessuggestedread
        method: GET
        description: Get a list of visually similar games, available only for business and enterprise API users.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-twitch
      path: /games/{id}/twitch
      operations:
      - name: gamestwitchread
        method: GET
        description: Get streams on Twitch associated with the game, available only for business and enterprise API users.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
    - name: games-id-youtube
      path: /games/{id}/youtube
      operations:
      - name: gamesyoutuberead
        method: GET
        description: Get videos from YouTube associated with the game, available only for business and enterprise API users.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: An ID or a slug identifying this Game.
          required: true
  exposes:
  - type: rest
    namespace: rawg-games-rest
    port: 8080
    description: REST adapter for RAWG Video Games Database API — games. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/games
      name: games
      description: REST surface for games.
      operations:
      - method: GET
        name: gameslist
        description: Get a list of games.
        call: rawg-games.gameslist
        with:
          page: rest.page
          page_size: rest.page_size
          search: rest.search
          search_precise: rest.search_precise
          search_exact: rest.search_exact
          parent_platforms: rest.parent_platforms
          platforms: rest.platforms
          stores: rest.stores
          developers: rest.developers
          publishers: rest.publishers
          genres: rest.genres
          tags: rest.tags
          creators: rest.creators
          dates: rest.dates
          updated: rest.updated
          platforms_count: rest.platforms_count
          metacritic: rest.metacritic
          exclude_collection: rest.exclude_collection
          exclude_additions: rest.exclude_additions
          exclude_parents: rest.exclude_parents
          exclude_game_series: rest.exclude_game_series
          exclude_stores: rest.exclude_stores
          ordering: rest.ordering
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/additions
      name: games-game-pk-additions
      description: REST surface for games-game_pk-additions.
      operations:
      - method: GET
        name: gamesadditionslist
        description: Get a list of DLC's for the game, GOTY and other editions, companion apps, etc.
        call: rawg-games.gamesadditionslist
        with:
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/development-team
      name: games-game-pk-development-team
      description: REST surface for games-game_pk-development-team.
      operations:
      - method: GET
        name: gamesdevelopmentteamlist
        description: Get a list of individual creators that were part of the development team.
        call: rawg-games.gamesdevelopmentteamlist
        with:
          ordering: rest.ordering
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/game-series
      name: games-game-pk-game-series
      description: REST surface for games-game_pk-game-series.
      operations:
      - method: GET
        name: gamesgameserieslist
        description: Get a list of games that are part of the same series.
        call: rawg-games.gamesgameserieslist
        with:
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/parent-games
      name: games-game-pk-parent-games
      description: REST surface for games-game_pk-parent-games.
      operations:
      - method: GET
        name: gamesparentgameslist
        description: Get a list of parent games for DLC's and editions.
        call: rawg-games.gamesparentgameslist
        with:
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/screenshots
      name: games-game-pk-screenshots
      description: REST surface for games-game_pk-screenshots.
      operations:
      - method: GET
        name: gamesscreenshotslist
        description: Get screenshots for the game.
        call: rawg-games.gamesscreenshotslist
        with:
          ordering: rest.ordering
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{game-pk}/stores
      name: games-game-pk-stores
      description: REST surface for games-game_pk-stores.
      operations:
      - method: GET
        name: gamesstoreslist
        description: Get links to the stores that sell the game.
        call: rawg-games.gamesstoreslist
        with:
          ordering: rest.ordering
          page: rest.page
          page_size: rest.page_size
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}
      name: games-id
      description: REST surface for games-id.
      operations:
      - method: GET
        name: gamesread
        description: Get details of the game.
        call: rawg-games.gamesread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/achievements
      name: games-id-achievements
      description: REST surface for games-id-achievements.
      operations:
      - method: GET
        name: gamesachievementsread
        description: Get a list of game achievements.
        call: rawg-games.gamesachievementsread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/movies
      name: games-id-movies
      description: REST surface for games-id-movies.
      operations:
      - method: GET
        name: gamesmoviesread
        description: Get a list of game trailers.
        call: rawg-games.gamesmoviesread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/reddit
      name: games-id-reddit
      description: REST surface for games-id-reddit.
      operations:
      - method: GET
        name: gamesredditread
        description: Get a list of most recent posts from the game's subreddit.
        call: rawg-games.gamesredditread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/suggested
      name: games-id-suggested
      description: REST surface for games-id-suggested.
      operations:
      - method: GET
        name: gamessuggestedread
        description: Get a list of visually similar games, available only for business and enterprise API users.
        call: rawg-games.gamessuggestedread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/twitch
      name: games-id-twitch
      description: REST surface for games-id-twitch.
      operations:
      - method: GET
        name: gamestwitchread
        description: Get streams on Twitch associated with the game, available only for business and enterprise API users.
        call: rawg-games.gamestwitchread
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/games/{id}/youtube
      name: games-id-youtube
      description: REST surface for games-id-youtube.
      operations:
      - method: GET
        name: gamesyoutuberead
        description: Get videos from YouTube associated with the game, available only for business and enterprise API users.
        call: rawg-games.gamesyoutuberead
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rawg-games-mcp
    port: 9090
    transport: http
    description: MCP adapter for RAWG Video Games Database API — games. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: get-list-games
      description: Get a list of games.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gameslist
      with:
        page: tools.page
        page_size: tools.page_size
        search: tools.search
        search_precise: tools.search_precise
        search_exact: tools.search_exact
        parent_platforms: tools.parent_platforms
        platforms: tools.platforms
        stores: tools.stores
        developers: tools.developers
        publishers: tools.publishers
        genres: tools.genres
        tags: tools.tags
        creators: tools.creators
        dates: tools.dates
        updated: tools.updated
        platforms_count: tools.platforms_count
        metacritic: tools.metacritic
        exclude_collection: tools.exclude_collection
        exclude_additions: tools.exclude_additions
        exclude_parents: tools.exclude_parents
        exclude_game_series: tools.exclude_game_series
        exclude_stores: tools.exclude_stores
        ordering: tools.ordering
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-dlc-s-game-goty
      description: Get a list of DLC's for the game, GOTY and other editions, companion apps, etc.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesadditionslist
      with:
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-individual-creators-that
      description: Get a list of individual creators that were part of the development team.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesdevelopmentteamlist
      with:
        ordering: tools.ordering
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-games-that-are
      description: Get a list of games that are part of the same series.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesgameserieslist
      with:
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-parent-games-dlc-s
      description: Get a list of parent games for DLC's and editions.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesparentgameslist
      with:
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-screenshots-game
      description: Get screenshots for the game.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesscreenshotslist
      with:
        ordering: tools.ordering
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-links-stores-that-sell
      description: Get links to the stores that sell the game.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesstoreslist
      with:
        ordering: tools.ordering
        page: tools.page
        page_size: tools.page_size
      outputParameters:
      - type: object
        mapping: $.
    - name: get-details-game
      description: Get details of the game.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-game-achievements
      description: Get a list of game achievements.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesachievementsread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-game-trailers
      description: Get a list of game trailers.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesmoviesread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-most-recent-posts
      description: Get a list of most recent posts from the game's subreddit.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesredditread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-visually-similar-games
      description: Get a list of visually similar games, available only for business and enterprise API users.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamessuggestedread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-streams-twitch-associated-game
      description: Get streams on Twitch associated with the game, available only for business and enterprise API users.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamestwitchread
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-videos-youtube-associated-game
      description: Get videos from YouTube associated with the game, available only for business and enterprise API users.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rawg-games.gamesyoutuberead
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.