IGDB · Capability

IGDB API

The IGDB (Internet Game Database) API provides programmatic access to a comprehensive video game database, including games, platforms, companies, genres, release dates, covers, screenshots, and user reviews. Authentication uses Twitch OAuth Client Credentials. All requests require a Client-ID header and an Authorization Bearer token. Most endpoints accept POST requests with an Apicalypse query body for filtering, sorting, and field selection.

Run with Naftiko IgdbAPI

What You Can Do

POST
Post games — Query games
/games
POST
Post platforms — Query platforms
/platforms
POST
Post companies — Query companies
/companies
POST
Post involved companies — Query involved companies
/involved_companies
POST
Post genres — Query genres
/genres
POST
Post themes — Query themes
/themes
POST
Post game modes — Query game modes
/game_modes
POST
Post covers — Query game covers
/covers
POST
Post screenshots — Query screenshots
/screenshots
POST
Post artworks — Query artworks
/artworks
POST
Post release dates — Query release dates
/release_dates
POST
Post collections — Query collections
/collections
POST
Post franchises — Query franchises
/franchises
POST
Post keywords — Query keywords
/keywords
POST
Post age ratings — Query age ratings
/age_ratings
POST
Post websites — Query game websites
/websites
POST
Post search — Search across IGDB entities
/search

MCP Tools

post-games

Query games

post-platforms

Query platforms

post-companies

Query companies

post-involved-companies

Query involved companies

post-genres

Query genres

post-themes

Query themes

post-game-modes

Query game modes

post-covers

Query game covers

post-screenshots

Query screenshots

post-artworks

Query artworks

post-release-dates

Query release dates

post-collections

Query collections

post-franchises

Query franchises

post-keywords

Query keywords

post-age-ratings

Query age ratings

post-websites

Query game websites

post-search

Search across IGDB entities

Capability Spec

igdb-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: IGDB API
  description: The IGDB (Internet Game Database) API provides programmatic access to a comprehensive video game database,
    including games, platforms, companies, genres, release dates, covers, screenshots, and user reviews. Authentication uses
    Twitch OAuth Client Credentials. All requests require a Client-ID header and an Authorization Bearer token. Most endpoints
    accept POST requests with an Apicalypse query body for filtering, sorting, and field selection.
  tags:
  - Igdb
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: igdb
    baseUri: https://api.igdb.com/v4
    description: IGDB API HTTP API.
    authentication:
      type: apikey
      in: header
      name: Client-ID
      value: '{{IGDB_TOKEN}}'
    resources:
    - name: games
      path: /games
      operations:
      - name: post-games
        method: POST
        description: Query games
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: platforms
      path: /platforms
      operations:
      - name: post-platforms
        method: POST
        description: Query platforms
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: companies
      path: /companies
      operations:
      - name: post-companies
        method: POST
        description: Query companies
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: involved-companies
      path: /involved_companies
      operations:
      - name: post-involved-companies
        method: POST
        description: Query involved companies
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: genres
      path: /genres
      operations:
      - name: post-genres
        method: POST
        description: Query genres
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: themes
      path: /themes
      operations:
      - name: post-themes
        method: POST
        description: Query themes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: game-modes
      path: /game_modes
      operations:
      - name: post-game-modes
        method: POST
        description: Query game modes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: covers
      path: /covers
      operations:
      - name: post-covers
        method: POST
        description: Query game covers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: screenshots
      path: /screenshots
      operations:
      - name: post-screenshots
        method: POST
        description: Query screenshots
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: artworks
      path: /artworks
      operations:
      - name: post-artworks
        method: POST
        description: Query artworks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: release-dates
      path: /release_dates
      operations:
      - name: post-release-dates
        method: POST
        description: Query release dates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: collections
      path: /collections
      operations:
      - name: post-collections
        method: POST
        description: Query collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: franchises
      path: /franchises
      operations:
      - name: post-franchises
        method: POST
        description: Query franchises
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: keywords
      path: /keywords
      operations:
      - name: post-keywords
        method: POST
        description: Query keywords
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: age-ratings
      path: /age_ratings
      operations:
      - name: post-age-ratings
        method: POST
        description: Query age ratings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: websites
      path: /websites
      operations:
      - name: post-websites
        method: POST
        description: Query game websites
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: search
      path: /search
      operations:
      - name: post-search
        method: POST
        description: Search across IGDB entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: igdb-rest
    description: REST adapter for IGDB API.
    resources:
    - path: /games
      name: post-games
      operations:
      - method: POST
        name: post-games
        description: Query games
        call: igdb.post-games
        outputParameters:
        - type: object
          mapping: $.
    - path: /platforms
      name: post-platforms
      operations:
      - method: POST
        name: post-platforms
        description: Query platforms
        call: igdb.post-platforms
        outputParameters:
        - type: object
          mapping: $.
    - path: /companies
      name: post-companies
      operations:
      - method: POST
        name: post-companies
        description: Query companies
        call: igdb.post-companies
        outputParameters:
        - type: object
          mapping: $.
    - path: /involved_companies
      name: post-involved-companies
      operations:
      - method: POST
        name: post-involved-companies
        description: Query involved companies
        call: igdb.post-involved-companies
        outputParameters:
        - type: object
          mapping: $.
    - path: /genres
      name: post-genres
      operations:
      - method: POST
        name: post-genres
        description: Query genres
        call: igdb.post-genres
        outputParameters:
        - type: object
          mapping: $.
    - path: /themes
      name: post-themes
      operations:
      - method: POST
        name: post-themes
        description: Query themes
        call: igdb.post-themes
        outputParameters:
        - type: object
          mapping: $.
    - path: /game_modes
      name: post-game-modes
      operations:
      - method: POST
        name: post-game-modes
        description: Query game modes
        call: igdb.post-game-modes
        outputParameters:
        - type: object
          mapping: $.
    - path: /covers
      name: post-covers
      operations:
      - method: POST
        name: post-covers
        description: Query game covers
        call: igdb.post-covers
        outputParameters:
        - type: object
          mapping: $.
    - path: /screenshots
      name: post-screenshots
      operations:
      - method: POST
        name: post-screenshots
        description: Query screenshots
        call: igdb.post-screenshots
        outputParameters:
        - type: object
          mapping: $.
    - path: /artworks
      name: post-artworks
      operations:
      - method: POST
        name: post-artworks
        description: Query artworks
        call: igdb.post-artworks
        outputParameters:
        - type: object
          mapping: $.
    - path: /release_dates
      name: post-release-dates
      operations:
      - method: POST
        name: post-release-dates
        description: Query release dates
        call: igdb.post-release-dates
        outputParameters:
        - type: object
          mapping: $.
    - path: /collections
      name: post-collections
      operations:
      - method: POST
        name: post-collections
        description: Query collections
        call: igdb.post-collections
        outputParameters:
        - type: object
          mapping: $.
    - path: /franchises
      name: post-franchises
      operations:
      - method: POST
        name: post-franchises
        description: Query franchises
        call: igdb.post-franchises
        outputParameters:
        - type: object
          mapping: $.
    - path: /keywords
      name: post-keywords
      operations:
      - method: POST
        name: post-keywords
        description: Query keywords
        call: igdb.post-keywords
        outputParameters:
        - type: object
          mapping: $.
    - path: /age_ratings
      name: post-age-ratings
      operations:
      - method: POST
        name: post-age-ratings
        description: Query age ratings
        call: igdb.post-age-ratings
        outputParameters:
        - type: object
          mapping: $.
    - path: /websites
      name: post-websites
      operations:
      - method: POST
        name: post-websites
        description: Query game websites
        call: igdb.post-websites
        outputParameters:
        - type: object
          mapping: $.
    - path: /search
      name: post-search
      operations:
      - method: POST
        name: post-search
        description: Search across IGDB entities
        call: igdb.post-search
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: igdb-mcp
    transport: http
    description: MCP adapter for IGDB API for AI agent use.
    tools:
    - name: post-games
      description: Query games
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-games
      outputParameters:
      - type: object
        mapping: $.
    - name: post-platforms
      description: Query platforms
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-platforms
      outputParameters:
      - type: object
        mapping: $.
    - name: post-companies
      description: Query companies
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-companies
      outputParameters:
      - type: object
        mapping: $.
    - name: post-involved-companies
      description: Query involved companies
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-involved-companies
      outputParameters:
      - type: object
        mapping: $.
    - name: post-genres
      description: Query genres
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-genres
      outputParameters:
      - type: object
        mapping: $.
    - name: post-themes
      description: Query themes
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-themes
      outputParameters:
      - type: object
        mapping: $.
    - name: post-game-modes
      description: Query game modes
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-game-modes
      outputParameters:
      - type: object
        mapping: $.
    - name: post-covers
      description: Query game covers
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-covers
      outputParameters:
      - type: object
        mapping: $.
    - name: post-screenshots
      description: Query screenshots
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-screenshots
      outputParameters:
      - type: object
        mapping: $.
    - name: post-artworks
      description: Query artworks
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-artworks
      outputParameters:
      - type: object
        mapping: $.
    - name: post-release-dates
      description: Query release dates
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-release-dates
      outputParameters:
      - type: object
        mapping: $.
    - name: post-collections
      description: Query collections
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-collections
      outputParameters:
      - type: object
        mapping: $.
    - name: post-franchises
      description: Query franchises
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-franchises
      outputParameters:
      - type: object
        mapping: $.
    - name: post-keywords
      description: Query keywords
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-keywords
      outputParameters:
      - type: object
        mapping: $.
    - name: post-age-ratings
      description: Query age ratings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-age-ratings
      outputParameters:
      - type: object
        mapping: $.
    - name: post-websites
      description: Query game websites
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-websites
      outputParameters:
      - type: object
        mapping: $.
    - name: post-search
      description: Search across IGDB entities
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: igdb.post-search
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    IGDB_TOKEN: IGDB_TOKEN