rocks.dreamlandPublished by dreamland.rocksOfficial publisherv1.1.0Updated Nov 6, 2026
Help, item search, news and who is online for DreamLand, a text MUD. EN/RU/UA, read-only.
Read-only MCP access to DreamLand, a text MUD: help articles, item search, game news and who is online, in English, Russian and Ukrainian.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/rocks.dreamland%2Fhelp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"dreamland-mud": {
"type": "http",
"url": "https://dreamland.rocks/mcp/help"
}
}
}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 Desktop / claude.ai: Settings -> Connectors -> Add custom connector, URL as above.
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 (shared static/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 /who servlet, 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.
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.
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.
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.
Source: mcp-help/README.md at commit 9bf2c2d
Search DreamLand help
Find help articles by keyword, title or text. Exact keywords rank first, then title and keyword-prefix matches, then hits in the article text. A leading facet word narrows the search like in game: "spell fire", "skill sword", "race elf", "class", "command", "zone", "religion", "clan" (RU/UA forms work too). Returns ids for help_get.
langlimitqueryrequiredRead a DreamLand help article
The full text of one help article as Markdown, with links to related articles. Pass the id from help_search, or a keyword: an exact title wins, a keyword several articles share returns them to pick from, anything else gets the best search hit.
idlangkeywordDreamLand help categories
The categories of the help index with article counts, in reading order for a newcomer. Pass a key to help_list.
langList DreamLand help articles
Every article in one category and/or of one kind, sorted by title. Example: category "classes"; kind "spell"; both: category "magic", kind "spell".
kindlangcategorySearch DreamLand items
Armor and gear, weapons, magic items (potions, pills, scrolls, wands, staves) or pets from the game world, with their stats, who may use them and the zone and mob they come from: the same data as https://dreamland.rocks/searcher.html. Only items placed in the world by zone resets are listed. Sorted by level, or by one bonus, highest first.
langslotsorttyperequiredalignlimitquerystatslevel_maxlevel_minmagic_typeweapon_class+1 moreWho is playing DreamLand
Characters in the game right now with race, clan, title and remorts, people on the Discord bridge, and this week's peak and unique players. With a name: that character's race, clan, clan rank and remorts, online or not. The same data the game's Discord bot shows.
langnameDreamLand news
Game news posted by the immortals, newest first: id, date, author, subject. A query keeps posts whose subject or text has every word of it. Posts are in the language they were written in, mostly Ukrainian, the oldest Russian. Read one with news_get.
limitqueryRead a DreamLand news post
The full text of one news post. Pass the id from news_list; without one, the newest post.
id100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
claude mcp add --transport http dreamland-help https://dreamland.rocks/mcp/helpnpm installPORT=8003 HELP_DATA=../static/data node server.jsHELP_DATA=/path/to/data npm test # starts the server and calls every toolnode 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