Claude MarketplacesSubmit
gunnargrosch avatar

Doom Mcp

gunnargrosch/doom-mcp

Yes, you can run DOOM in Claude. This MCP server embeds the actual DOOM engine via FFI and exposes three tools: doom_start to launch a game with configurable difficulty and level, doom_action to issue movement and combat commands over a specified number of ticks, and doom_screenshot to capture frames. Each action returns structured game state including HP, ammo, visible enemies with distances and angles, nearby items, and a small PNG thumbnail. The AI sees what's on screen and can either follow your directions move by move or play autonomously. Ships with Freedoom but accepts custom WADs via environment variable. Works on Windows, macOS, and Linux through npx.

GitHub stars
10
tools
3
transport
STDIO
last updated
Mar 13, 2026
View on GitHub

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

doom_startStart or restart DOOM. Safe to call at any time — if a game is already running it restarts cleanly without needing a new session.

Start or restart DOOM. Safe to call at any time — if a game is already running it restarts cleanly without needing a new session.

No parameter schema in public metadata yet.

doom_actionAdvance the game. All listed actions are held simultaneously for the tick duration.

Advance the game. All listed actions are held simultaneously for the tick duration.

No parameter schema in public metadata yet.

doom_screenshotSave a full-resolution 320x200 screenshot to the system temp directory and open it in the default image viewer. Does not advance the game (beyond a brief pause for the frame to settle).

Save a full-resolution 320x200 screenshot to the system temp directory and open it in the default image viewer. Does not advance the game (beyond a brief pause for the frame to settle).

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

DOOM via MCP

MCP Registry npm version npm downloads License: MIT

Can it run DOOM? Yes - your AI coding assistant can run DOOM.

Play DOOM in Claude Code, Cursor, or any MCP-compatible client. The AI sees the game, fights demons, navigates levels, and reports what's happening - or you direct it move by move.

> Let's play DOOM!

  Starting E1M1 on medium difficulty...

  HP:100 Armor:0 | Pistol (key:2) | Ammo: 50b 0s 0r 0c | Kills:0 | E1M1
  No enemies in sight. Exploring the corridor ahead.

> Go forward and find some enemies

  Sprinting down the hallway... I can see an opening ahead.

  HP:100 Armor:0 | Pistol (key:2) | Ammo: 50b 0s 0r 0c | Kills:0 | E1M1
  ENEMIES IN SIGHT (aim for angle~0 then fire): Imp (HP:60) to your left (turn_left ~9) nearby

  There's an Imp to the left! Turning to face it...

> Shoot it!

View the full README on GitHub

Details

Repository
github.com/gunnargrosch/doom-mcp
Package
doom-mcp
Transport
STDIO
Registry
MCP registry, active