imho.run game recommendations
Steam games like any game you name, facts about a game, and finding a game from a description.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~9,572토큰 (도구 정의)
~12.2 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 7.48%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"games": {
"url": "https://imho.run/mcp"
}
}
}원격 엔드포인트
https://imho.run/mcpstreamable-http할 수 있는 일
도구 목록
도구 (8)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"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"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 8개