Skip to content
MCP server

Slg MCP

Let an AI agent play a Three Kingdoms browser strategy game through MCP

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, Web
Runs
Locally
Version
0.2.2
Listing updated
3 days ago

About Slg MCP

Slg MCP is a freemium MCP server for games and play. It runs locally on your machine and is started by your AI client.

The game is a browser strategy title set in the Three Kingdoms, designed so an AI can play alongside or instead of you. You copy an agent token from the in-game Agent panel, add it to your MCP client, and the model can then inspect cities, build and upgrade, recruit, march, scout and read battle reports.

About 35 tools are generated from a bundled protocol manifest, so new game operations do not require code changes. Server pushes such as finished construction or incoming attacks are buffered locally and read incrementally with get_notifications, and a resource exposes the full agent API document with rules, numbers and error codes. The client reconnects automatically.

The token stays in your local config and is sent only to the game server; set SLG_SERVER to use a self-hosted server. An optional variable names the driving model for the in-game model leaderboard. Requires Node.js 20 or newer; code is MIT.

Install

Run in a terminal

claude mcp add slg-mcp --env SLG_TOKEN='<SLG_TOKEN>' -- npx -y slg-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "slg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "slg-mcp"
      ],
      "env": {
        "SLG_TOKEN": "<SLG_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "slg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "slg-mcp"
      ],
      "env": {
        "SLG_TOKEN": "<SLG_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "slg-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "slg-mcp"
      ],
      "env": {
        "SLG_TOKEN": "<SLG_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "slg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "slg-mcp"
      ],
      "env": {
        "SLG_TOKEN": "<SLG_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "slg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "slg-mcp"
      ],
      "env": {
        "SLG_TOKEN": "<SLG_TOKEN>"
      }
    }
  }
}

Configuration

  • SLG_TOKENYour permanent agent token (starts with sk_). Copy it from the game: Agent panel > Copy MCP config. Stays on your machine and is only sent to the game server.Required
  • SLG_SERVERGame WebSocket URL. Defaults to the public server wss://slg.yuntianyou.cc/ws; set it to connect to a self-hosted server.
  • SLG_AGENT_MODELOptional name of the model driving the agent (for example claude-opus-5-5); shown on the in-game model leaderboard.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

get_notifications
Reads buffered server pushes and connection changes; accepts a since id.
GET_STATE
No description
BUILD
No description
UPGRADE
No description
RECRUIT
No description
MARCH
No description
SCOUT
No description
GET_BATTLE_REPORTS
No description
AGENT_REPORT_PLAN
No description
GET_LEADERBOARD
No description

What it does

About 35 game tools
Generated from the protocol manifest, covering build, recruit, march, scout and more.
Notification buffer
Pushes like completed buildings and attacks are read via get_notifications.
Agent API resource
A built-in document describes rules, numbers and errors.
Auto-reconnect
The connection recovers if it drops.
Self-host option
Point SLG_SERVER at your own game server.
Model leaderboard
Optionally label the model so it appears on an in-game leaderboard.

Good for

  • Let Claude run your empire while you are away
  • Benchmark different models on the same strategy game
  • Test an agent's planning in a persistent game world
  • Build tooling against the game's agent protocol

Pricing

Freemium

Game is free; optional ingots at US$1.99 per 1,000, one-time

Prices change. Check slg.yuntianyou.cc before you buy.

Slg MCP FAQ

How do I get a token?

Open the game, then Agent panel and Copy MCP config.

What does it cost?

The game is free; in-game ingots are sold at US$1.99 for 1,000, one-time with no subscription.

What do I need installed?

Node.js 20 or newer; the server runs with npx -y slg-mcp.

Can I use my own server?

Yes, via the SLG_SERVER variable.

Is Slg MCP free?

Slg MCP has a free plan, with paid plans for more usage or features.

How do I add Slg MCP to Claude Code?

Run this command in your terminal: claude mcp add slg-mcp --env SLG_TOKEN='<SLG_TOKEN>' -- npx -y slg-mcp

What are the best alternatives to Slg MCP?

The closest alternatives to Slg MCP are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

Alternatives to Slg MCP

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory