imho.run game recommendations
Steam games like any game you name, facts about a game, and finding a game from a description.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~9,572Tokens (definiciones de herramientas)
~12.2 KBTamaño de respuesta típico
Impacto significativo en la atención (7.48% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"games": {
"url": "https://imho.run/mcp"
}
}
}Puntos de conexión remotos
https://imho.run/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (8)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢games_like(game, n, lang, free, coop, ...)
Steam games similar to ONE game, ranked by imho.run's recommender (the list on that game's imho.run page), each with a one-line reason, price, Steam Deck status, year, review numbers, the imho.run page URL and the Steam URL. Use it for 'games like X', optionally only free, co-op or Steam Deck games. Use `recommend` instead when the user names 2-3 games, wants other filters (no PvP, no microtransactions, release years, niche) or describes what they want in words. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"game": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
},
"free": {
"type": "boolean",
"default": false,
"description": "Only free games."
},
"coop": {
"type": "boolean",
"default": false,
"description": "Only co-op games."
},
"coop_mode": {
"type": "string",
"enum": [
"online",
"local"
],
"description": "Kind of co-op (implies coop): online co-op (Remote Play Together does not count), or local same-screen / split-screen co-op."
},
"steam_deck": {
"type": "string",
"enum": [
"verified",
"playable"
],
"description": "Steam Deck verified, or playable-or-better."
}
},
"required": [
"game"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"source": {
"description": "Always \"imho.run\".",
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"seed": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "The game's page on imho.run (the full list of similar games).",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
}
},
"required": [
"appid",
"name",
"url",
"steam_url"
],
"title": "AgentSeed",
"type": "object"
},
"other_matches": {
"description": "Other games the query could mean; pass one's appid as `q` to switch.",
"items": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
}
},
"required": [
"appid",
"name"
],
"title": "AgentMatch",
"type": "object"
},
"title": "Other Matches",
"type": "array"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"filters": {
"properties": {
"free": {
"default": false,
"title": "Free",
"type": "boolean"
},
"coop": {
"default": false,
"title": "Coop",
"type": "boolean"
},
"coop_mode": {
"anyOf": [
{
"enum": [
"online",
"local"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Coop Mode"
},
"deck": {
"anyOf": [
{
"enum": [
"verified",
"playable"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deck"
}
},
"title": "AgentFilters",
"type": "object"
},
"list_url": {
"description": "The same list on imho.run.",
"title": "List Url",
"type": "string"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "Link this when you mention the game: its page on imho.run.",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"why": {
"description": "One short sentence: why this game is like the seed.",
"title": "Why",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
}
},
"required": [
"rank",
"appid",
"name",
"url",
"steam_url",
"why",
"price",
"steam_deck"
],
"title": "AgentPick",
"type": "object"
},
"title": "Results",
"type": "array"
},
"generated_at": {
"title": "Generated At",
"type": "string"
}
},
"required": [
"query",
"source",
"attribution",
"seed",
"lang",
"filters",
"list_url",
"results",
"generated_at"
],
"title": "GamesLikeResponse"
}🟢recommend(seeds, liked, disliked, filters, preferences, ...)
Steam games for someone who likes 1-3 given games, ranked by imho.run's recommender: the list imho.run's own tool shows for those games and filters. Use it instead of games_like when the user names several games, wants filters beyond free / co-op / Steam Deck (no PvP, no microtransactions, no grind, not too hard, no Early Access, release years, more niche or more popular), or says what they want in words: pass that as `preferences` ('cozy base building, no combat'); the result says which Steam tags it was read as. When the user reacts to the picks, call it again with `liked` / `disliked`: liked games join the seeds, disliked ones never come back. Each pick has a one-line reason naming the seed it is closest to (`similar_to`), price, Steam Deck status, year, reviews, the imho.run URL and the Steam URL, plus `tool_url` (these games in imho.run's tool). Not for naming a game from a description (find_game_by_description) or facts about one game (game_facts). Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"seeds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"minItems": 1,
"maxItems": 3,
"description": "1-3 games the user likes: names, Steam appids or Steam URLs."
},
"liked": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"maxItems": 10,
"description": "Other games the user said they liked (e.g. from earlier answers). They fill free seed slots after `seeds` (3 in all); the rest are listed in `ignored`."
},
"disliked": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"maxItems": 20,
"description": "Games the user disliked or already played: never recommended. Pass earlier picks the user rejected to get fresh ones."
},
"filters": {
"type": "object",
"description": "All optional. Leave out what the user did not ask for.",
"properties": {
"free": {
"type": "boolean",
"description": "Only free-to-play games."
},
"coop": {
"type": "boolean",
"description": "Only games with co-op."
},
"coop_mode": {
"type": "string",
"enum": [
"online",
"local",
"any"
],
"description": "Kind of co-op (implies coop): online (Remote Play Together does not count), local same-screen / split-screen, or any."
},
"deck": {
"type": "string",
"enum": [
"verified",
"playable"
],
"description": "Steam Deck verified, or playable-or-better."
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pvp",
"microtransactions",
"hard",
"grind",
"early_access",
"vr_only"
]
},
"description": "Leave out: pvp (PvP-focused), microtransactions (in-app purchases / free-to-play), hard (Difficult / Souls-like), grind (MMO / looter grind), early_access, vr_only."
},
"exclude_tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10,
"description": "Steam tags to leave out, e.g. ['Horror', 'Anime']."
},
"year_min": {
"type": "integer",
"minimum": 1970,
"maximum": 2100,
"description": "Released in or after this year."
},
"year_max": {
"type": "integer",
"minimum": 1970,
"maximum": 2100,
"description": "Released in or before this year (default: this year)."
},
"upcoming": {
"type": "boolean",
"description": "Also include unreleased games (no year_max default)."
},
"popularity_bias": {
"type": "number",
"minimum": -1,
"maximum": 1,
"description": "-1 = hidden gems / more niche, 0 = neutral, 1 = well-known / more popular. Rounded to steps of 0.5."
}
},
"additionalProperties": false
},
"preferences": {
"type": "string",
"maxLength": 200,
"description": "What the user wants or wants to avoid, in their words (any language), e.g. 'dragons and crafting, no horror, no grind'. Read as Steam tags."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"required": [
"seeds"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"properties": {
"seeds": {
"items": {
"type": "string"
},
"title": "Seeds",
"type": "array"
},
"preferences": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Preferences"
},
"liked": {
"items": {
"type": "string"
},
"title": "Liked",
"type": "array"
},
"disliked": {
"items": {
"type": "string"
},
"title": "Disliked",
"type": "array"
}
},
"required": [
"seeds"
],
"title": "AgentRecQuery",
"type": "object"
},
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"seeds": {
"items": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "The game's page on imho.run (the full list of similar games).",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
}
},
"required": [
"appid",
"name",
"url",
"steam_url"
],
"title": "AgentSeed",
"type": "object"
},
"title": "Seeds",
"type": "array"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"filters": {
"properties": {
"free": {
"default": false,
"title": "Free",
"type": "boolean"
},
"coop": {
"default": false,
"title": "Coop",
"type": "boolean"
},
"coop_mode": {
"anyOf": [
{
"enum": [
"online",
"local"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Coop Mode"
},
"deck": {
"anyOf": [
{
"enum": [
"verified",
"playable"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deck"
},
"exclude": {
"items": {
"enum": [
"pvp",
"microtransactions",
"hard",
"grind",
"early_access",
"vr_only"
],
"type": "string"
},
"title": "Exclude",
"type": "array"
},
"exclude_tags": {
"items": {
"type": "string"
},
"title": "Exclude Tags",
"type": "array"
},
"year_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Min"
},
"year_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "This year by default (no unreleased games), as on the site.",
"title": "Year Max"
},
"popularity_bias": {
"default": 0,
"title": "Popularity Bias",
"type": "number"
}
},
"title": "AgentRecFilters",
"type": "object"
},
"preferred_tags": {
"items": {
"type": "string"
},
"title": "Preferred Tags",
"type": "array"
},
"tool_url": {
"description": "imho.run's tool with these games picked; the user can tune filters there.",
"title": "Tool Url",
"type": "string"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "Link this when you mention the game: its page on imho.run.",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"why": {
"description": "One short sentence: why this game is like the seed.",
"title": "Why",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
},
"similar_to": {
"description": "appid of the seed this pick is closest to; `why` names that seed.",
"title": "Similar To",
"type": "integer"
}
},
"required": [
"rank",
"appid",
"name",
"url",
"steam_url",
"why",
"price",
"steam_deck",
"similar_to"
],
"title": "AgentRecPick",
"type": "object"
},
"title": "Results",
"type": "array"
},
"preferences_applied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "null without `preferences`; false when they could not be read.",
"title": "Preferences Applied"
},
"preferences": {
"anyOf": [
{
"properties": {
"applied": {
"description": "False: the text could not be read now; nothing applied.",
"title": "Applied",
"type": "boolean"
},
"prefer_tags": {
"items": {
"type": "string"
},
"title": "Prefer Tags",
"type": "array"
},
"avoid_tags": {
"items": {
"type": "string"
},
"title": "Avoid Tags",
"type": "array"
},
"filters": {
"items": {
"type": "string"
},
"title": "Filters",
"type": "array"
},
"unmatched": {
"items": {
"type": "string"
},
"title": "Unmatched",
"type": "array"
},
"suggestions": {
"items": {
"properties": {
"phrase": {
"title": "Phrase",
"type": "string"
},
"polarity": {
"enum": [
"positive",
"negative"
],
"title": "Polarity",
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
}
},
"required": [
"phrase",
"polarity"
],
"title": "AgentPrefSuggestion",
"type": "object"
},
"title": "Suggestions",
"type": "array"
}
},
"required": [
"applied"
],
"title": "AgentPreferences",
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "How `preferences` were read as Steam tags."
},
"ignored": {
"description": "liked / disliked games not used: no match, or liked past the 3 seed slots.",
"items": {
"type": "string"
},
"title": "Ignored",
"type": "array"
},
"generated_at": {
"title": "Generated At",
"type": "string"
}
},
"required": [
"query",
"source",
"attribution",
"seeds",
"lang",
"filters",
"tool_url",
"results",
"generated_at"
],
"title": "RecommendResponse"
}🟢library_recs(profile, filters, n, lang)
Steam games for a player, ranked against their own public Steam library (what they play most), the way imho.run's library mode does it; owned games are left out. Use it when the user gives their Steam profile and wants picks for their taste in general; for 'games like X' use games_like or recommend. Takes a SteamID64 or a steamcommunity.com/profiles/<SteamID64> link (not a custom /id/ name) and works only for public profiles imho.run already has; otherwise it returns one 'unavailable' error with a link the user can open to paste their profile. Each pick names the most-played game it is closest to (`similar_to`). Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 17,
"maxLength": 200,
"description": "SteamID64 or steamcommunity.com/profiles/<SteamID64> link."
},
"filters": {
"type": "object",
"description": "All optional, same meaning as in recommend.",
"properties": {
"free": {
"type": "boolean"
},
"coop": {
"type": "boolean"
},
"coop_mode": {
"type": "string",
"enum": [
"online",
"local",
"any"
]
},
"deck": {
"type": "string",
"enum": [
"verified",
"playable"
]
},
"exclude": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pvp",
"microtransactions",
"hard",
"grind",
"early_access",
"vr_only"
]
}
},
"year_min": {
"type": "integer",
"minimum": 1970,
"maximum": 2100
},
"year_max": {
"type": "integer",
"minimum": 1970,
"maximum": 2100
}
},
"additionalProperties": false
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"required": [
"profile"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"filters": {
"properties": {
"free": {
"default": false,
"title": "Free",
"type": "boolean"
},
"coop": {
"default": false,
"title": "Coop",
"type": "boolean"
},
"coop_mode": {
"anyOf": [
{
"enum": [
"online",
"local"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Coop Mode"
},
"deck": {
"anyOf": [
{
"enum": [
"verified",
"playable"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deck"
},
"exclude": {
"items": {
"enum": [
"pvp",
"microtransactions",
"hard",
"grind",
"early_access",
"vr_only"
],
"type": "string"
},
"title": "Exclude",
"type": "array"
},
"exclude_tags": {
"items": {
"type": "string"
},
"title": "Exclude Tags",
"type": "array"
},
"year_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year Min"
},
"year_max": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "This year by default (no unreleased games), as on the site.",
"title": "Year Max"
},
"popularity_bias": {
"default": 0,
"title": "Popularity Bias",
"type": "number"
}
},
"title": "AgentRecFilters",
"type": "object"
},
"based_on": {
"description": "The profile's most-played games the reasons refer to.",
"items": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
}
},
"required": [
"appid",
"name",
"url"
],
"title": "AgentLibraryAnchor",
"type": "object"
},
"title": "Based On",
"type": "array"
},
"tool_url": {
"description": "imho.run's library mode, where the user can paste the link.",
"title": "Tool Url",
"type": "string"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "Link this when you mention the game: its page on imho.run.",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"why": {
"description": "One short sentence: why this game is like the seed.",
"title": "Why",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
},
"similar_to": {
"description": "appid of the seed this pick is closest to; `why` names that seed.",
"title": "Similar To",
"type": "integer"
}
},
"required": [
"rank",
"appid",
"name",
"url",
"steam_url",
"why",
"price",
"steam_deck",
"similar_to"
],
"title": "AgentRecPick",
"type": "object"
},
"title": "Results",
"type": "array"
},
"generated_at": {
"title": "Generated At",
"type": "string"
}
},
"required": [
"source",
"attribution",
"lang",
"filters",
"tool_url",
"results",
"generated_at"
],
"title": "LibraryRecsResponse"
}🟢game_facts(game, lang)
Public facts about one Steam game: year, developers, genres, top tags, price, Steam Deck status, review numbers, a review-mined summary and links. For a few single-player games, `coop_via_mod` names a reviewed fan mod for co-op, with caveats. Use it to answer questions about a game the user names; for similar games use games_like or recommend. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"game": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Game name (typos and Russian names are fine), Steam appid or Steam store URL."
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"required": [
"game"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"game": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"similar_url": {
"description": "Games like this one on imho.run.",
"title": "Similar Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"release_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Release Date"
},
"coming_soon": {
"default": false,
"title": "Coming Soon",
"type": "boolean"
},
"developers": {
"items": {
"type": "string"
},
"title": "Developers",
"type": "array"
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
},
"tags": {
"description": "Top Steam user tags by votes.",
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Steam's short description (English).",
"title": "Description"
},
"description_lang": {
"default": "en",
"title": "Description Lang",
"type": "string"
},
"summary": {
"anyOf": [
{
"properties": {
"tagline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tagline"
},
"difficulty": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Difficulty"
},
"length": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Length"
},
"session_shape": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Session Shape"
},
"co_op": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Co Op"
},
"hooks": {
"items": {
"type": "string"
},
"title": "Hooks",
"type": "array"
},
"dealbreakers": {
"items": {
"type": "string"
},
"title": "Dealbreakers",
"type": "array"
},
"language": {
"default": "en",
"title": "Language",
"type": "string"
}
},
"title": "AgentFactsSummary",
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Review-mined summary (English), when we have one."
},
"coop_via_mod": {
"anyOf": [
{
"description": "Reviewed fan-mod co-op for a game without full official co-op (#665).",
"properties": {
"mod_name": {
"title": "Mod Name",
"type": "string"
},
"mod_url": {
"description": "The mod's official project page. Link this, never a mirror.",
"title": "Mod Url",
"type": "string"
},
"scope": {
"enum": [
"full_campaign",
"partial_campaign",
"shared_world",
"sandbox_servers"
],
"title": "Scope",
"type": "string"
},
"scope_text": {
"title": "Scope Text",
"type": "string"
},
"max_players": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Players"
},
"maturity": {
"enum": [
"stable",
"beta"
],
"title": "Maturity",
"type": "string"
},
"status": {
"description": "ok = released after the last game patch; frozen_game = the game is no longer patched; lagging = the game was patched after the mod; check_due = not rechecked in 90+ days.",
"enum": [
"ok",
"frozen_game",
"lagging",
"check_due"
],
"title": "Status",
"type": "string"
},
"last_checked": {
"title": "Last Checked",
"type": "string"
},
"official_coop_is_summon_only": {
"default": false,
"title": "Official Coop Is Summon Only",
"type": "boolean"
},
"note": {
"title": "Note",
"type": "string"
},
"note_lang": {
"default": "en",
"enum": [
"en",
"ru"
],
"title": "Note Lang",
"type": "string"
},
"caveats": {
"description": "Always pass these on: unofficial mod, save and anti-cheat risk.",
"items": {
"type": "string"
},
"title": "Caveats",
"type": "array"
}
},
"required": [
"mod_name",
"mod_url",
"scope",
"scope_text",
"maturity",
"status",
"last_checked",
"note"
],
"title": "AgentCoopViaMod",
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Only for listed single-player games: co-op through a reviewed fan mod."
},
"audience_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "For game developers: what this game's players also play (co-play overlap from public Steam libraries). Only for well-sampled games.",
"title": "Audience Url"
}
},
"required": [
"appid",
"name",
"url",
"similar_url",
"steam_url",
"price",
"steam_deck"
],
"title": "AgentGameFacts",
"type": "object"
},
"other_matches": {
"items": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
}
},
"required": [
"appid",
"name"
],
"title": "AgentMatch",
"type": "object"
},
"title": "Other Matches",
"type": "array"
},
"generated_at": {
"title": "Generated At",
"type": "string"
}
},
"required": [
"query",
"source",
"attribution",
"lang",
"game",
"generated_at"
],
"title": "GameFactsResponse"
}🟢find_game_by_description(description, lang, platform, year_min, year_max, ...)
Identify a game from a description of what the user remembers (plot, look, platform, era). Returns ranked candidates with a reason each, a `confidence`, and `find_game_url`: imho.run's /find-game page with the description filled in (the user presses the button; nothing runs by itself). Pass what the user said about the platform, the release years and the camera as `platform`, `year_min` / `year_max` and `perspective` instead of leaving them only in the text. When `confidence` is not high or no result fits, give the user `find_game_url` so they can add details there. Slow (LLM) and rate-limited: use it only when the user does not know the title; for games similar to a known game use games_like or recommend. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 12,
"maxLength": 3000,
"description": "What the user remembers about the game, in their words."
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en"
},
"platform": {
"type": "string",
"enum": [
"pc",
"playstation",
"xbox",
"nintendo",
"sega",
"mobile",
"browser",
"arcade"
],
"description": "Where the user played it, if they said (a platform family)."
},
"year_min": {
"type": "integer",
"minimum": 1970,
"maximum": 2035,
"description": "Earliest plausible release year, if the user gave an era."
},
"year_max": {
"type": "integer",
"minimum": 1970,
"maximum": 2035,
"description": "Latest plausible release year, if the user gave an era."
},
"perspective": {
"type": "string",
"enum": [
"first",
"third",
"top_down",
"side"
],
"description": "Camera: first person, third person, top-down or side view."
}
},
"required": [
"description"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"confidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Confidence"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"platforms": {
"items": {
"type": "string"
},
"title": "Platforms",
"type": "array"
},
"why": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Why"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"steam_appid": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Steam Appid"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Its imho.run page, when we have one.",
"title": "Url"
},
"steam_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Steam Url"
},
"igdb_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Igdb Url"
}
},
"required": [
"rank",
"name"
],
"title": "AgentFindItem",
"type": "object"
},
"title": "Results",
"type": "array"
},
"tool_url": {
"title": "Tool Url",
"type": "string"
},
"find_game_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "/find-game with the description filled in, for the user to refine.",
"title": "Find Game Url"
}
},
"required": [
"source",
"attribution",
"lang",
"results",
"tool_url"
],
"title": "FindGameResponse"
}🟢trending(kind, n, lang)
Steam games trending right now (imho.run/trending): `rising` = established games gaining reviews and players against their own recent baseline, `breakouts` = new games taking off. Each has reviews this week, growth in %, price, Steam Deck status and links. Use it for 'what's hot / popular right now on Steam'; for new releases use new_releases, for games like a given game use games_like. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"rising",
"breakouts"
],
"default": "rising"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"kind": {
"enum": [
"rising",
"breakouts"
],
"title": "Kind",
"type": "string"
},
"status": {
"description": "collecting: the lists are not ready yet; results is empty.",
"enum": [
"ready",
"collecting"
],
"title": "Status",
"type": "string"
},
"updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
},
"page_url": {
"title": "Page Url",
"type": "string"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "Link this when you mention the game: its page on imho.run.",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
},
"reviews_week": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "trending: Steam reviews in the last 7 days.",
"title": "Reviews Week"
},
"reviews_growth_pct": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "trending: weekly reviews vs the game's own 3-week baseline, in %.",
"title": "Reviews Growth Pct"
},
"release_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "new_releases: Steam release date.",
"title": "Release Date"
},
"release_kind": {
"anyOf": [
{
"enum": [
"new",
"ea_exit"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "new_releases (released games): `new` = a new launch; `ea_exit` = the game left Early Access on its release date (its 1.0), it was playable before. Say 'out of Early Access', not 'new game', for `ea_exit`.",
"title": "Release Kind"
}
},
"required": [
"rank",
"appid",
"name",
"url",
"steam_url",
"price",
"steam_deck"
],
"title": "AgentListPick",
"type": "object"
},
"title": "Results",
"type": "array"
}
},
"required": [
"source",
"attribution",
"lang",
"kind",
"status",
"page_url",
"results"
],
"title": "TrendingResponse"
}🟢new_releases(upcoming, coop, ea_exits, n, lang)
Games released on Steam in the last 30 days that players rate well (70%+ positive, 50+ positive reviews), or with `upcoming` the upcoming games that have a release date; optionally co-op only. The site's New releases list, with price, Steam Deck status, release date and links. Released games carry `release_kind`: `new`, or `ea_exit` for a game that just left Early Access (its 1.0; it was playable before), so call those 'out of Early Access', not new. `ea_exits`: include (default), exclude (brand-new games only) or only. Use it for 'what's new / coming out'; for what is gaining players now use trending. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"upcoming": {
"type": "boolean",
"default": false
},
"coop": {
"type": "boolean",
"default": false
},
"ea_exits": {
"type": "string",
"enum": [
"include",
"exclude",
"only"
],
"default": "include",
"description": "Games that just left Early Access: include them, exclude them (only brand-new launches) or return only them."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
},
"lang": {
"type": "string",
"enum": [
"en",
"ru"
],
"default": "en",
"description": "Language of the `why` lines."
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"attribution": {
"title": "Attribution",
"type": "string"
},
"lang": {
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
},
"kind": {
"enum": [
"released",
"upcoming"
],
"title": "Kind",
"type": "string"
},
"coop": {
"default": false,
"title": "Coop",
"type": "boolean"
},
"ea_exits": {
"default": "include",
"description": "The Early Access exits filter this list was built with.",
"enum": [
"include",
"exclude",
"only"
],
"title": "Ea Exits",
"type": "string"
},
"page_url": {
"title": "Page Url",
"type": "string"
},
"results": {
"items": {
"properties": {
"rank": {
"title": "Rank",
"type": "integer"
},
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"url": {
"description": "Link this when you mention the game: its page on imho.run.",
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"price": {
"properties": {
"is_free": {
"title": "Is Free",
"type": "boolean"
},
"amount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Price as last scraped from the US Steam store.",
"title": "Amount"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Currency"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"Free\", \"29.99 USD\" or null when unknown.",
"title": "Text"
}
},
"required": [
"is_free"
],
"title": "AgentPrice",
"type": "object"
},
"steam_deck": {
"enum": [
"verified",
"playable",
"unsupported",
"unknown"
],
"title": "Steam Deck",
"type": "string"
},
"reviews": {
"anyOf": [
{
"properties": {
"total": {
"description": "Steam user reviews.",
"title": "Total",
"type": "integer"
},
"positive_pct": {
"description": "Share of positive Steam reviews, 0-100.",
"title": "Positive Pct",
"type": "integer"
}
},
"required": [
"total",
"positive_pct"
],
"title": "AgentReviews",
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"genres": {
"items": {
"type": "string"
},
"title": "Genres",
"type": "array"
},
"reviews_week": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "trending: Steam reviews in the last 7 days.",
"title": "Reviews Week"
},
"reviews_growth_pct": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "trending: weekly reviews vs the game's own 3-week baseline, in %.",
"title": "Reviews Growth Pct"
},
"release_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "new_releases: Steam release date.",
"title": "Release Date"
},
"release_kind": {
"anyOf": [
{
"enum": [
"new",
"ea_exit"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "new_releases (released games): `new` = a new launch; `ea_exit` = the game left Early Access on its release date (its 1.0), it was playable before. Say 'out of Early Access', not 'new game', for `ea_exit`.",
"title": "Release Kind"
}
},
"required": [
"rank",
"appid",
"name",
"url",
"steam_url",
"price",
"steam_deck"
],
"title": "AgentListPick",
"type": "object"
},
"title": "Results",
"type": "array"
}
},
"required": [
"source",
"attribution",
"lang",
"kind",
"page_url",
"results"
],
"title": "NewReleasesAgentResponse"
}🟢search_games(query, n)
Find Steam games by title (typos, partial names, Russian names and acronyms are fine): appid, year, imho.run page and Steam link for each match. Use it to check which game the user means or to get an appid; the other tools also accept names directly. For a game the user can only describe, use find_game_by_description. Games rated for adults only (explicit sexual content) are not covered; filtering is best effort.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
}
},
"required": [
"query"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"source": {
"title": "Source",
"type": "string"
},
"results": {
"items": {
"properties": {
"appid": {
"title": "Appid",
"type": "integer"
},
"name": {
"title": "Name",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Year"
},
"url": {
"title": "Url",
"type": "string"
},
"steam_url": {
"title": "Steam Url",
"type": "string"
}
},
"required": [
"appid",
"name",
"url",
"steam_url"
],
"title": "AgentSearchHit",
"type": "object"
},
"title": "Results",
"type": "array"
}
},
"required": [
"query",
"source",
"results"
],
"title": "SearchResponse"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada8 herramientas