How do I use yagames-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@yagames-mcp search for puzzle games" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

yagames-mcp

by PETERGS27

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

yagames-mcp

MCP server for Yandex Games — search the catalog, manage game drafts, upload builds, and publish games, all from your MCP client.

Features

Public catalog — search games, browse popular titles, list categories (no auth required)
Game management — create and update game drafts
Build upload — upload game ZIP archives as new versions
Moderation & publish — submit for review, publish approved games
Status tracking — check draft/moderation/publish status, list all your games

Related MCP server: Yandex Webmaster MCP Server

Tools

Public (no auth)

Tool	Description
`yagames-search`	Search games by keyword
`yagames-popular`	Get popular games, optionally filtered by category
`yagames-categories`	List all available genres

Authenticated (env vars required)

Tool	Description
`yagames-create-draft`	Register a new game in the console
`yagames-update-draft`	Update an existing game draft
`yagames-upload-build`	Upload a ZIP archive as a new build
`yagames-submit-moderation`	Send the game for moderation review
`yagames-publish`	Publish a game that passed moderation
`yagames-status`	Check status of a specific game
`yagames-list-my-games`	List all games on your account

Quick start

Requirements

Node.js >= 18
npm

Install & run

npm install
npm run build

Authenticated tools

Set these environment variables to use the console management tools:

export YAGAMES_SESSION_COOKIE="your_session_id_value"
export YAGAMES_CSRF_TOKEN="your_csrf_token_value"

How to obtain credentials:

Go to games.yandex.ru/console and log in with your developer account
Open DevTools (F12 / Cmd+Option+I)
Session_id: Application → Cookies → games.yandex.ru → copy Session_id value
CSRF token: Network tab → find a POST request to /console/api/application → Request Headers → copy X-CSRF-Token

Warning: Credentials grant full access to your developer account. Never share them or commit them to version control.

Usage with opencode

Add to your project's opencode.json or global ~/.config/opencode/opencode.json:

{
  "mcp": {
    "yagames-mcp": {
      "type": "local",
      "command": ["node", "/path/to/yagames-mcp/build/index.js"],
      "enabled": true,
      "env": {
        "YAGAMES_SESSION_COOKIE": "your_session_id",
        "YAGAMES_CSRF_TOKEN": "your_csrf_token"
      }
    }
  }
}

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "yagames-mcp": {
      "command": "node",
      "args": ["/path/to/yagames-mcp/build/index.js"],
      "env": {
        "YAGAMES_SESSION_COOKIE": "your_session_id",
        "YAGAMES_CSRF_TOKEN": "your_csrf_token"
      }
    }
  }
}

npx (from npm)

npx yagames-mcp

Architecture

yagames-mcp/
├── src/
│   ├── index.ts              # MCP server entry (JSON-RPC over stdio)
│   ├── types.ts              # Shared TypeScript types
│   ├── client/
│   │   ├── catalog.ts        # Public catalog client (HTML scraping)
│   │   └── console.ts        # Authenticated console client (REST API)
│   └── tools/
│       ├── catalog.ts        # yagames-search, yagames-popular, yagames-categories
│       ├── draft.ts          # yagames-create-draft, yagames-update-draft
│       ├── build.ts          # yagames-upload-build
│       ├── moderation.ts     # yagames-submit-moderation, yagames-publish
│       └── status.ts         # yagames-status, yagames-list-my-games
├── build/                    # Compiled JS output
├── package.json
└── tsconfig.json

How it works

Public catalog scrapes HTML from yandex.ru/games — Yandex Games renders game data server-side in __appData__ JSON and game-card elements. No API key required.
Console API calls games.yandex.ru/console/api/application* with Session_id cookie and X-CSRF-Token header for authentication.
Transport: stdio (standard MCP protocol). The server speaks JSON-RPC 2.0.

API endpoints

Endpoint	Purpose
`yandex.ru/games/`	Public catalog (HTML)
`games.yandex.ru/console/api/application`	Create a game draft
`games.yandex.ru/console/api/applications`	List all games
`games.yandex.ru/console/api/application/{id}`	Get/update game details
`games.yandex.ru/console/api/application/{id}/builds`	Upload build
`games.yandex.ru/console/api/application/{id}/moderation`	Submit for review
`games.yandex.ru/console/api/application/{id}/publish`	Publish game

The Yandex Games platform

Yandex Games is one of the largest HTML5 game platforms in the CIS region.
Developer documentation: yandex.ru/dev/games, with a library of over 2,000 games. The audience is predominantly 55+ (38%), with 58% women and 42% men. Games are monetized through in-game ads. The platform has 27 genre categories.

License

MIT

Available Tools

10 tools

yagames-categoriesA

List all available game categories/genres on Yandex Games

Inputs: no named parameters.

yagames-create-draftA

Create a new game draft in the Yandex Games Console. Requires YAGAMES_SESSION_COOKIE and YAGAMES_CSRF_TOKEN env vars

Inputs: title (required), category (required), ageRating (required), howToPlay (required), +9 more.

yagames-list-my-gamesA

List all games uploaded to your developer account. Requires auth env vars

Inputs: no named parameters.

yagames-popularA

Get popular games from Yandex Games catalog, optionally filtered by category

Inputs: category.

yagames-publishA

Publish a game that has passed moderation. Requires auth env vars

Inputs: appId (required).

yagames-searchB

Search games in the Yandex Games catalog by keyword

Inputs: query (required).

yagames-statusA

Check the current status of a game (draft, moderation, publish). Requires auth env vars

Inputs: appId (required).

yagames-submit-moderationA

Submit a game draft for moderation review. Takes 3-5 business days. Requires auth env vars

Inputs: appId (required).

yagames-update-draftC

Update an existing game draft. Requires authentication env vars

Inputs: appId (required), tags, title, category, +7 more.

yagames-upload-buildB

Upload a game ZIP archive as a new build. Requires authentication env vars

Inputs: appId (required), archivePath (required), version.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-09-06 14:55 across 10 tools

Disambiguation4/5

Most tools target distinct actions in the catalog or developer lifecycle. Search and popular both return catalog games but differ by keyword versus ranking, and status versus list-my-games have different scopes. These are minor overlaps, not true duplicates.

Naming Consistency3/5

All names share the consistent yagames- prefix and snake_case, but the action pattern is inconsistent: five use verb_noun like upload-build and create-draft, while others are bare verbs like search and publish, or nouns/adjectives like status, categories, and popular. This mixed convention is readable but not a uniform verb_noun scheme.

Tool Count5/5

Ten tools is well-scoped for the server's dual purpose of browsing the Yandex Games catalog and managing a developer's game lifecycle. No obvious bloat or overly narrow set.

Completeness4/5

The developer lifecycle is well covered: draft creation/update, build upload, moderation submission, publishing, and status checks are all present, plus catalog browsing via search, popular, and categories. Minor gaps exist such as no delete/unpublish or detailed single-game get, but agents can complete the primary workflow.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

Yandex Tools MCP
io.github.ruslan-mm18
MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika, Direct. Open source, by Seyka AI.
Search Marketing Monitoring
168
https://mcp.seyka.ru/mcp
RU Books MCP
io.github.books-service
MCP server for Russian books search, details, and recommendation candidates.
Search Art & Culture Entertainment & Media
2
https://knigochit.ru/mcp
AI Game Developer: MCP for Unity, Unreal and GodotA
io.github.IvanMurzak
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
App Automation Developer Tools Games & Gamification
314,630
https://ai-game.dev/mcp
Playgama MCP - Publish & Manage HTML5 GamesA
com.playgama.developer
Publish in seconds, get the audience, start monetization, get all analytics — without leaving your agent. Playgama MCP is a remote MCP server for game developers. Point Codex, Claude Code, Cursor or VS Code at it and your agent works inside your Playgama developer cabinet: it creates a game and fills in the form, uploads a build and polls until the engine analysis is done, uploads covers in the exact sizes the form requires, edits the in-app catalog and leaderboards, gets a QA Tool link, and publishes a sandbox — a public link anyone can play, with no moderation step. It can also bring the first players to that sandbox through Playgama DSP, with the first run per game free. 22 tools, 11 of them read-only; every write is annotated as destructive so your client asks first. Submitting to moderation, deleting and payouts are deliberately left out: the agent prepares everything, a human presses the button. Authentication is OAuth 2.1 with dynamic client registration — there is no token to copy. The client opens a browser on first use, and connected agents are listed and revocable in the cabinet. After the link is live the game takes its first players from the Playgama network, and Playgama DSP can send more the same day (beta). Once it clears the session threshold you can switch on advertising — Playgama Ad serves rewarded, interstitial and banner formats through one JS SDK (access by request). Playgama Wrap turns the same game into a standalone site on your own domain with player accounts, in-game purchases and indexable SEO pages (early access), and Playgama Bridge SDK gives one API for ads, leaderboards, payments and platform SDKs when you publish across platforms. Playtime, retention and revenue reports are in the developer dashboard, and payouts start at 100 USD. Product page: https://playgama.com/mcp/ Docs: https://wiki.playgama.com/playgama/mcp Tools reference: https://wiki.playgama.com/playgama/mcp/tools Connected agents: https://developer.playgama.com/mcp
Content Management Systems Developer Tools Games & Gamification
371
https://developer.playgama.com/api/mcp

Related MCP Servers

yadisk-mcp
Cloud Storage Search
Patr56
A
license
A
quality
D
maintenance
MCP server for Yandex Disk that enables file and folder management, search, upload/download, publishing, and trash operations through natural language.
Updated 7 months ago (2026-04-08 15:16 UTC)
22
19 PyPI
1
MIT
Yandex Webmaster MCP Server
Search Marketing
theYahia
A
license
A
quality
C
maintenance
MCP server for interacting with Yandex.Webmaster API to manage sites, retrieve search queries, and check indexing status. Requires an OAuth token.
Updated 2 months ago (2026-09-06 08:43 UTC)
13
77 npm
6
MIT
Yandex Cloud MCP Server
Cloud Platforms Virtualization Cloud Storage
theYahia
A
license
B
quality
B
maintenance
MCP server for managing Yandex Cloud infrastructure including Compute VMs, Object Storage, Serverless Functions, and Operations.
Updated 2 months ago (2026-09-03 05:09 UTC)
8
19 npm
1
MIT
yandex360-mcp
pa1ch
A
license
Not graded
quality
C
maintenance
MCP server that enables AI assistants to interact with Yandex 360 organization services, currently supporting Yandex Wiki for reading, editing, and searching pages.
Updated 3 months ago (2026-07-29 15:50 UTC)
MIT

yagames-mcp

Features

Tools

Public (no auth)

Authenticated (env vars required)

Quick start

Requirements

Install & run

Authenticated tools

Usage with opencode

Usage with Claude Desktop

npx (from npm)

Architecture

How it works

API endpoints

The Yandex Games platform

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

yadisk-mcp

Yandex Webmaster MCP Server

Yandex Cloud MCP Server

yandex360-mcp