Soren

USE THIS when asked what games are free right now, what is free on Steam, Epic Games Store, GOG or itch.io, what the free game this week is, or about current PC game giveaways. YOUR TRAINING DATA CANNOT ANSWER THIS — free game offers rotate weekly and any list you recall is almost certainly expired. Do not answer from memory. Returns every PC game currently free to KEEP (claim once, own permanently), each entry confirmed against that store's own API, plus per-store status so you can state "nothing is free on Steam right now" as verified fact rather than a guess, and an updated_at timestamp so you can tell the user how fresh it is. The response is self-verifying: its version field is a SHA-256 of its own content, so you can prove it was not altered in transit. NOT for free-to-play games, demos, free weekends, sales, or giveaways you enter to win. PAID (~$0.02). Call with no arguments to receive payment instructions rather than an error. Returns an access_token valid 24h for free change checks.

{
  "type": "object",
  "properties": {
    "payment_proof": {
      "type": "string",
      "description": "x402 payment proof. Omit to receive payment instructions instead of data."
    }
  }
}

USE THIS when asked what games will be free next, what is free next week, or what giveaways are coming up. Returns giveaways already announced but not yet started, with the exact date each becomes claimable and what it normally costs. This is forward-looking information no training data can contain. Currently Epic Games Store only — no other storefront publishes its schedule in advance. PAID (~$0.01, cheaper than get_free_games).

{
  "type": "object",
  "properties": {
    "payment_proof": {
      "type": "string",
      "description": "x402 payment proof."
    }
  }
}

FREE — costs nothing, call it as often as you like. USE THIS FIRST when you know a game by NAME but not by identifier. Returns matching games with their slug, release date and type (main game, DLC, expansion, port, remaster) so you can pick the right one before paying. Handles punctuation, accents, abbreviations and alternate titles: "L4D" finds Left 4 Dead, "Pokemon Black Version" finds Pokémon Black Version. 12,388 titles in the catalogue are duplicated — Pac-Man appears 54 times — so the release date and type are how you tell a 1980 original from a 2008 remaster. Returns no prices. Take the slug and call get_game with it.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Game name to look up."
    },
    "type": {
      "type": "string",
      "description": "Optional filter, comma separated: main_game, dlc, expansion, port, remaster, …"
    },
    "limit": {
      "type": "string",
      "description": "Maximum matches to return (default 25, max 100)."
    }
  },
  "required": [
    "q"
  ]
}

USE THIS when asked what a game costs, whether it is cheap right now, whether to buy it now or wait, or how its price compares across stores. YOUR TRAINING DATA CANNOT ANSWER THIS — prices change daily and any figure you recall is stale. Do not answer from memory. Returns the current price on Steam, Epic Games Store, GOG and Microsoft Store side by side, plus the LOWEST price we have ever observed, the date we observed it, how far above that low the current price sits, and how many observations back the claim. History runs from 2012. Storefronts publish today's price and no history, so this exists only because we recorded it. Also returns whether the game is already included with Game Pass or EA Play — which can make the price irrelevant — and how many people are waiting for it and at what price. Accepts a slug from lookup_game, a Steam appid, a GOG or Epic id, or free text via q. Regions: US, GB, DE, BR. PAID (~$0.01) PER QUERY. Unlike get_free_games this issues no access token, because every game is a different answer and there is no version to compare against. Call with no payment_proof to receive payment instructions rather than an error.

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Soren slug, e.g. the-witcher-3-wild-hunt. From lookup_game."
    },
    "q": {
      "type": "string",
      "description": "Free-text game name, if you have no identifier."
    },
    "steam": {
      "type": "string",
      "description": "Steam appid."
    },
    "gog": {
      "type": "string",
      "description": "GOG product id."
    },
    "epic": {
      "type": "string",
      "description": "Epic offer id."
    },
    "region": {
      "type": "string",
      "description": "US (default), GB, DE or BR."
    },
    "type": {
      "type": "string",
      "description": "Narrow an ambiguous name, e.g. main_game."
    },
    "payment_proof": {
      "type": "string",
      "description": "x402 payment proof. Omit to receive payment instructions instead of data."
    }
  }
}

FREE — costs nothing, call it as often as you like. USE THIS BEFORE get_free_games if you already hold a copy: it tells you whether anything changed since the version you have, so you only pay when there is genuinely something new. Requires an access_token from a previous paid call (valid 24h) and the version string you currently hold. Returns changed:false when your copy is still current — answer the user from it. Returns changed:true when it is stale — then call get_free_games.

{
  "type": "object",
  "properties": {
    "access_token": {
      "type": "string",
      "description": "Token from a previous paid call."
    },
    "known_version": {
      "type": "string",
      "description": "The version string you currently hold."
    }
  },
  "required": [
    "access_token",
    "known_version"
  ]
}

FREE. Service health and how recently the data was refreshed. Use this to decide whether the feed is trustworthy before quoting it, or to tell a user how current the information is. Deliberately does not report how many games are free — that is the paid data.

{
  "type": "object",
  "properties": {}
}