Allows an AI client to search help articles, item databases, news archives, and player status for the DreamLand text MUD in English, Russian, and Ukrainian.
Also known as dreamland-mud/dreamland_web, help
- Stars
- 8
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Nov 16, 2026
- License
- GPL-3.0
What is DreamLand MUD MCP?
DreamLand MUD allows an AI client to search help articles, item databases, news archives, and player status for the DreamLand text MUD in English, Russian, and Ukrainian. It exposes 6 tools, such as help_search, help_get, help_categories.
Summary generated from the project's README
About DreamLand MUD MCP server
Accessing DreamLand MUD documentation and game data from within an AI client is what this server enables. It provides a read-only interface for players and developers to query help articles, item databases, news archives, and player status information. The server supports English, Russian, and Ukrainian languages, though untranslated text defaults to Russian.
Users can connect via a streamable HTTP endpoint without authentication, making it easy to add to Claude Desktop or other compatible clients. The toolset includes help_search for finding articles by facet words or phrases, item_search for filtering armor, weapons, and pets by stats or level, and who for checking player details like race, clan, and remorts. It also offers news_list to browse the archive and help_categories for browsing documentation.
Because the data is rendered for level-1 characters, the information is accessible to all players without level-gating. The server stays updated by re-reading local JSON data files whenever the game's data dumps change.
What you can do with it
- 1Filtering equipment and itemsLocate specific weapons or armor based on stats, level requirements, or magic types.
Written from the project's README. Every use case is checked against a quote from it.
How to install DreamLand MUD MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall DreamLand MUD MCP in Claude Code
$ claude mcp add --transport http help https://dreamland.rocks/mcp/helpInstall DreamLand MUD MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"help": {
"url": "https://dreamland.rocks/mcp/help"
}
}
}Install DreamLand MUD MCP in VS Code
.vscode/mcp.json
{
"servers": {
"help": {
"type": "http",
"url": "https://dreamland.rocks/mcp/help"
}
}
}Install DreamLand MUD MCP in VS Code CLI
$ code --add-mcp '{"name":"help","type":"http","url":"https://dreamland.rocks/mcp/help"}'Install DreamLand MUD MCP in Codex
$ codex mcp add help --url https://dreamland.rocks/mcp/helpInstall DreamLand MUD MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.help] url = "https://dreamland.rocks/mcp/help"
Install DreamLand MUD MCP in Gemini CLI
$ gemini mcp add -s user --transport http help https://dreamland.rocks/mcp/helpInstall DreamLand MUD MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"help": {
"url": "https://dreamland.rocks/mcp/help",
"type": "http"
}
}
}DreamLand MUD MCP tools 6
Detected from the READMEhelp_searchhelp_gethelp_categoriesitem_searchwhonews_list
Configuration
HELP_DATA
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubDreamLand help MCP server
Public, read-only MCP server over the DreamLand help corpus (the same articles as https://dreamland.rocks/help.html, in English, Russian and Ukrainian), the item searcher, the news archive and who is online. It serves only what the site and the Discord bot already show.
Endpoint: https://dreamland.rocks/mcp/help (Streamable HTTP, no auth).
claude mcp add --transport http dreamland-help https://dreamland.rocks/mcp/help
Claude Desktop / claude.ai: Settings -> Connectors -> Add custom connector, URL as above.
Tools
-
help_search(query, lang, limit): ids, titles, kinds and an excerpt. Same ranking as the site and the game client (static/site/js/helpsearch.js). A leading facet word narrows it:spell fire,race elf. A phrase that matches nothing as a whole falls back to its words. -
help_get(id | keyword, lang): the article as Markdown with links to the site, plus See also. A keyword several articles share returns the list to pick from. -
help_categories(lang),help_list(category, kind, lang): browse. -
item_search(type, query, level_min, level_max, slot, weapon_class, magic_type, stats, align, include_limited, sort, lang, limit): armor, weapons, magic items or pets with stats, who may use them, zone and the mob or room they come from. Same data and filters as https://dreamland.rocks/searcher.html (sharedstatic/site/js/itemsearch.js); no vnums, limited items marked. -
who(name, lang): who is in the game (race, clan, title, remorts), who is on the Discord bridge, this week's peak and unique players. With a name: race, clan, clan rank, remorts. The engine's public/whoservlet, the one the Discord bot calls; the list is cached for 30 seconds. -
news_list(query, limit),news_get(id): the news archive, newest first, posts as written (mostly Ukrainian). A query keeps posts with every word in the subject or text.
lang is en, ru or ua (uk works too). Untranslated text falls back to Russian, like the game.
Data and freshness
Reads static/data/help-index.json and help-body-{ru,en,ua}.json, which site.js/build-help.js writes from the game's dump, and re-reads them when the index changes. The dump is rendered for a level-1 character, so nothing immortal-only or level-gated is served. A help edit reaches the server as: content deploy -> plug reload web (or the hourly dump) -> site data build (drone, or the 30-minute timer).
News come from static/data/news-all.json, which site.js/build-news.js writes from the game's note dump (webdump news).
who asks MUD_API (default http://127.0.0.1:1235, the engine's servlet port on the same box).
Items come from static/data/db_{armor,weapon,magic,pets}.json: searcher.cpp dumps them to /tmp at boot and every 4 hours, drone copies them here. Only items placed by zone resets, outside clan and hidden zones, are in them; noident items show no stats. Each file is re-read when it changes.
Usage counters
stats.js counts, per UTC day, each tool call and each connecting client program (clientInfo.name from initialize). No IPs, no arguments. File: MCP_STATS, default ~/mcp-help-stats.json (live: /home/dreamland/mcp-help-stats.json), flushed every minute and on exit, 120 days kept.
Running
npm install
PORT=8003 HELP_DATA=../static/data node server.js
HELP_DATA=/path/to/data npm test # starts the server and calls every tool
node test.js --fresh # same, on live data fetched from dreamland.rocks/data
# (who asks MUD_API, default https://dreamland.rocks/api in tests)
node test.js https://dreamland.rocks/mcp/help # same checks against a running server
Live: dreamland-help-mcp.service (copy in this directory) on 127.0.0.1:8003, nginx location /mcp/help with a 5 r/s per-IP limit (nginx.conf here). Drone runs npm install on every deploy; the server exits when its own files change and systemd restarts it on the new code.
DreamLand MUD MCP questions
How do I add DreamLand MUD MCP to Claude Code?
Run claude mcp add --transport http help https://dreamland.rocks/mcp/help in your terminal. Add --scope user to make it available in every project.
How do I add DreamLand MUD MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does DreamLand MUD MCP provide?
It exposes 6 tools, including help_search, help_get, help_categories, item_search, who.
Can I search for specific items like armor or weapons?
Yes, you can search for armor, weapons, magic items, or pets using various filters like level, slot, and stats.