MCP.Market

tmodloader-mcp server

by musharna·io.github.musharna/tmodloader-mcp·v0.6.3·1 stars
No reviews yet

Drive a running tModLoader (Terraria) instance from an agent: launch, query, screenshot, read state.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

1 stars18 downloads/wk

Reviews

Write one

Nobody has reviewed tmodloader-mcp yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

tmodloader-mcp tools (25, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • api_search

    Find a type, field, property or method in the INSTALLED tModLoader.

  • build_mod

    Compile the configured mod source into a .tmod.

  • captures

    Every capture in the save directory, newest last.

  • commands

    What this side's mod says it serves, read from the mod itself.

  • diag

    Ask one side of the session what it currently sees, parsed.

  • heartbeat

    Why the game is not answering, for both sides at once.

  • inventory

    The worlds, characters and mods on this machine.

  • join

    Bring another character into the session that is already running.

  • launch

    Start tModLoader and wait until it can actually answer.

  • locked
  • log_files

    Which logs exist right now, and how many earlier runs are archived.

  • log_since

    Only what a log has gained since you last looked.

  • log_watch

    Block until a log line matches, instead of polling `log_since` by hand.

  • logs

    Tail one of tModLoader's logs, optionally filtered.

  • prune_captureswrite action

    Delete all but the newest `keep` captures, and say which went.

  • read_capture

    Return one capture's PNG as image content.

  • restart

    Stop, rebuild, and start again with the session's own settings.

  • save_restore

    Overwrite the world and characters with a snapshot.

  • save_snapshot

    Copy this world and its characters aside, so a run can be undone.

  • save_snapshots

    Every snapshot on this machine, newest first, with its age in seconds.

  • shot

    Capture a region of the game's own back buffer and return the PNG path.

  • status

    Whether a session is running, and what it is.

  • stopwrite action

    Kill only the processes this session started, and confirm they are gone.

  • trigger

    Ask the running game to do something, and return what it said.

  • wait_until

    Poll `diag` until one of its fields satisfies a comparison.

Public scan report

scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan15 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 2 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How tmodloader-mcp compares

Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 90% of 1,299 Productivity servers
Tools
25
the typical Productivity server has 7
Tools that change things
8%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 50% of 854 Productivity servers
Downloads a week
18
more than 5% of 427 Productivity servers with a package

What its tools let an agent do: 18 read · 3 create · 1 change · 3 run or deploy

Install tmodloader-mcp in Claude Code, Cursor or VS Code

claude mcp add tmodloader-mcp -- uvx tmodloader-mcp
Add to Cursor

What the publisher says

From the tmodloader-mcp repository's README, as published. We do not edit it. Read it on GitHub

tmodloader-mcp

Drive a running tModLoader instance from an agent — launch it, ask it questions, photograph it, and read its state back as structured data.

<!-- mcp-name: io.github.musharna/tmodloader-mcp -->

How it works · Quick start · Configuration · Known limits

Game engines have grown MCP servers — Unity, Unreal, Godot and Defold all have one, so an assistant can see a real scene instead of guessing from a prompt. tModLoader has not had one. This is that.

The tool staged its own screenshot — time:noon, teleport:spawn, spawn:1,25, shot:full — read from the game's back buffer, so a window in front of the game cannot be in the picture (How it works starts there). Trimmed of the unexplored dark below the terrain; otherwise exactly as returned.

Status: alpha — it has only ever run on one install; see

Known limits before adopting it. Nothing defaults to

anybody's install, the mod-side half is a folder you vendor

(responder/),

and CI compiles it with nothing of any mod's on the compile line.

Quick start

uv tool install tmodloader-mcp    # or: pip install tmodloader-mcp

# the two paths with no default — every plausible default names somebody's install
export TMODLOADER_SAVE_DIR="/mnt/c/Users/<you>/Documents/My Games/Terraria/tModLoader"
export TMODLOADER_MOD_SOURCE="$TMODLOADER_SAVE_DIR/ModSources/<YourMod>"

Then:

responder/ into your mod's source tree and subclass DevResponder. It is a folder of C#, not a PyPI dependency, because it compiles inside your mod.

  1. Vendor the responder — copy

Using it from Claude Code.

  1. Point your MCP client at the server — the block in

startasession prompt, which lists the worlds and characters that actually exist here.

  1. Ask the game something — launch, then diag. Or open with the

This needs WSL2 driving a Windows tModLoader — Requirements says why before anything else does.

How it works

The game is asked by writing a file it polls, not by sending it input:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

tmodloader-mcp: common questions

Is tmodloader-mcp server safe?
Yes, by our scan: it is graded A (92/100). Read the tmodloader-mcp safety report
How do I install tmodloader-mcp?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does tmodloader-mcp need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is tmodloader-mcp maintained?
The last commit was 34 days ago (2026-10-01). The latest release is v0.6.3.
What can I use instead of tmodloader-mcp?
Servers from other publishers that do the same job: Renforge MCP server, Argent MCP server and gflow-cli MCP server.
How does tmodloader-mcp compare with other Productivity MCP servers?
safety score 92/100 (higher than 90% of 1,299 Productivity servers); tools 25 (the typical Productivity server has 7); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to tmodloader-mcp

Same job from other publishers: the closest match first, then the best rated.

  • Renforge
    Inspect, drive and debug a running Ren'Py game: state, screenshots, guarded clicks, saves, builds.
    A
  • Argent
    Drive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agent
    A
  • gflow-cli
    Drive Google Flow from an agent: Veo video and Imagen image generation
    A
  • Buoy Gg
    Let AI agents read and drive a running React Native or Flutter app through Buoy's devtools.
    A
  • Unreal Engine
    EngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.
    B

More from musharna →