naftiko: 1.0.0-alpha2
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-06'
binds:
- namespace: env
  keys:
    RAWG_API_KEY: RAWG_API_KEY
capability:
  consumes:
  - type: http
    namespace: rawg
    baseUri: https://api.rawg.io/api
    description: RAWG Video Games Database REST API
    authentication:
      type: apikey
      key: key
      value: '{{RAWG_API_KEY}}'
      placement: query
    resources:
    - name: creator-roles
      path: /creator-roles
      description: Game creator position and job role types
      operations:
      - name: list-creator-roles
        method: GET
        description: Get a list of creator positions (jobs)
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: page_size
          in: query
          type: integer
          required: false
          description: Results per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: creators
      path: /creators
      description: Individual game creators and development team members
      operations:
      - name: list-creators
        method: GET
        description: Get a list of game creators
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: page_size
          in: query
          type: integer
          required: false
          description: Results per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-creator
        method: GET
        description: Get details of the creator
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Creator ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: developers
      path: /developers
      description: Game development studios and companies
      operations:
      - name: list-developers
        method: GET
        description: Get a list of game developers
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: page_size
          in: query
          type: integer
          required: false
          description: Results per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-developer
        method: GET
        description: Get details of the developer
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Developer ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: games
      path: /games
      description: Video games catalog with metadata and filtering
      operations:
      - name: list-games
        method: GET
        description: Get a list of games with rich filtering options
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: page_size
          in: query
          type: integer
          required: false
          description: Results per page
        - name: search
          in: query
          type: string
          required: false
          description: Search query
        - name: platforms
          in: query
          type: string
          required: false
          description: Filter by platform IDs
        - name: genres
          in: query
          type: string
          required: false
          description: Filter by genre IDs or slugs
        - name: developers
          in: query
          type: string
          required: false
          description: Filter by developer IDs or slugs
        - name: publishers
          in: query
          type: string
          required: false
          description: Filter by publisher IDs or slugs
        - name: tags
          in: query
          type: string
          required: false
          description: Filter by tag IDs or slugs
        - name: dates
          in: query
          type: string
          required: false
          description: Filter by release date range
        - name: metacritic
          in: query
          type: string
          required: false
          description: Filter by Metacritic score range
        - name: ordering
          in: query
          type: string
          required: false
          description: Sort field (name, released, rating, metacritic)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-game
        method: GET
        description: Get details of the game
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-additions
        method: GET
        description: Get a list of DLCs for the game
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-development-team
        method: GET
        description: Get individual creators on the development team
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-series
        method: GET
        description: Get games that are part of the same series
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-parent-games
        method: GET
        description: Get parent games for DLCs and editions
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-screenshots
        method: GET
        description: Get screenshots for the game
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-stores
        method: GET
        description: Get links to stores that sell the game
        inputParameters:
        - name: game_pk
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-achievements
        method: GET
        description: Get a list of game achievements
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-trailers
        method: GET
        description: Get a list of game trailers
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-game-reddit-posts
        method: GET
        description: Get recent posts from the game subreddit
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-suggested-games
        method: GET
        description: Get visually similar games (enterprise tier)
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Game ID or slug
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: genres
      path: /genres
      description: Video game genre categories
      operations:
      - name: list-genres
        method: GET
        description: Get a list of video game genres
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: ordering
          in: query
          type: string
          required: false
          description: Sort field
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-genre
        method: GET
        description: Get details of the genre
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Genre ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: platforms
      path: /platforms
      description: Gaming hardware and software platforms
      operations:
      - name: list-platforms
        method: GET
        description: Get a list of video game platforms
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: ordering
          in: query
          type: string
          required: false
          description: Sort field
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: list-parent-platforms
        method: GET
        description: Get a list of parent platforms
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-platform
        method: GET
        description: Get details of the platform
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Platform ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: publishers
      path: /publishers
      description: Game publishing companies
      operations:
      - name: list-publishers
        method: GET
        description: Get a list of video game publishers
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-publisher
        method: GET
        description: Get details of the publisher
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Publisher ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: stores
      path: /stores
      description: Digital and physical game storefronts
      operations:
      - name: list-stores
        method: GET
        description: Get a list of video game storefronts
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: ordering
          in: query
          type: string
          required: false
          description: Sort field
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-store
        method: GET
        description: Get details of the store
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Store ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tags
      path: /tags
      description: Descriptive game tags and labels
      operations:
      - name: list-tags
        method: GET
        description: Get a list of tags
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-tag
        method: GET
        description: Get details of the tag
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
          description: Tag ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  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: $.