English Français العربية

io.github.mrfentmen/zork-mcp

Official registry Games, sports and entertainment

Use this MCP server to plays classic text adventure games. The LLM is the player, explore, solve...

Source code Documentation

What can you do with io.github.mrfentmen/zork-mcp?

  • list_games, available games
  • start_game(gameId), start/restart, returns your first room
  • act(command), look, go north, take the lantern, use lantern,
  • hint, a nudge for the current room
  • score, treasures, moves, win status

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package zork-mcp
Claude Code 
claude mcp add zork-mcp -- npx -y zork-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "zork-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "zork-mcp@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. zork mcp
  2. Games
  3. Tools
  4. Run
  5. Example session
  6. Add a game

zork mcp

A text adventure interpreter as an MCP server. The AI is the player, it explores, solves puzzles, fights trolls, and collects treasure, turn by turn, through tool calls.

Games

  • colossal dungeon, a Zork style dungeon: a grue in the dark, a toll collecting troll, a locked grate, five treasures.
  • brainrot manor, a meme palace. Collect the aura artifacts. Become the main character.

Tools

  • list_games, available games
  • start_game(gameId), start/restart, returns your first room
  • act(command), look, go north, take the lantern, use lantern, attack troll with sword, inventory...
  • hint, a nudge for the current room
  • score, treasures, moves, win status

Run

npm install && npm run build && node dist/index.js

Example session

  1. start_game("colossal-dungeon")
  2. act("take the lantern") → act("use lantern")
  3. act("go north"), a troll blocks you...
  4. act("attack troll with sword")
  5. ...find all 4 treasures to win

Add a game

Games are pure data, see src/games.ts. Rooms, items with use-effects, hints, and treasures are all declarative; no engine changes needed.

Frequently asked questions

What is io.github.mrfentmen/zork-mcp?

Use this MCP server to plays classic text adventure games. The LLM is the player, explore, solve...

How do I install io.github.mrfentmen/zork-mcp?

It runs on your machine. In Claude Code: claude mcp add zork-mcp -- npx -y zork-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.mrfentmen/zork-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.mrfentmen/zork-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.mrfentmen/zork-mcp?

It is published by mrfentmen. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.