Golemreach MCP Server

Kill something. Pass a creature id from your CREATURES list (e.g. "m245"), or pass monster:"rat" to hunt the nearest matching creature, or pass neither to fight the nearest hostile thing you can reach. This runs the whole fight, not one swing: it closes to range, attacks on the weapon's own cadence, drinks a health potion or casts a heal when your health drops, breaks off if you fall below the flee threshold, and by default loots the corpse afterwards. It returns when the monster is dead, you fled, or the time budget runs out. BEFORE YOU COMMIT: every creature in a look carries a `threat` figure — the damage per second it is expected to do to YOU, after your armour. Divide your health by it to see how many seconds you would survive. Under about fifteen seconds, do not take the fight. RANGED CHARACTERS: pass keepDistance. A paladin or a sorcerer that just attacks will be walked into melee by its own chase and eaten there; keepDistance makes the server RETREAT when the target closes inside the ring, which is the whole reason a bow is worth carrying. RETURNS: what happened, experience gained, damage taken, what you looted, and the world afterwards. COMMON FAILURES. "protection_zone" means you are standing on a `P` tile, where combat is impossible — those are the temple and the depot interiors, not the whole town, so one or two steps outside is usually enough. "not_found" means the creature id is stale; look again for a current one. And if nothing is in sight at all, you are in the wrong place: ask an NPC "where can I hunt?" and go there. Note that no monster will cross the warded bridges into town, so nothing can be lured home — you go to them.

Cast one spell. Name it by id ("light_healing") or by its incantation ("exura") — both work. Check the SPELLS READY line in any look first: the server pre-filters it to exactly the spells you can cast this instant given your vocation, level, magic level, mana and cooldowns. If a spell is not on that line, casting it will be rejected. The full catalogue is the resource golemreach://spells. Attack spells need targetId (or coordinates for the ones that land on a tile). Healing and support spells usually need nothing. RETURNS: what the spell did — damage dealt, health restored — and the world afterwards. COMMON FAILURES, all of which say exactly what is wrong: "wrong_vocation" (a knight cannot cast exura — knights drink potions instead, via golemreach_use), "insufficient_mana", "insufficient_magic_level", "out_of_range" (the message tells you the reach and your distance), and "cooldown" with the seconds left. Spells have both a per-spell cooldown and a shared group cooldown, so casting attack magic briefly locks all attack magic.

Join the game. This is always your first call. It registers an account, creates a character and walks it into the world in one step, then returns your first look at the world. Call it again later only if you were disconnected; it remembers your token and character between runs, so a second call resumes the same character rather than making a new one (pass fresh:true if you really want a new account). RETURNS: your character name, level and vocation, plus the standard world view — status line, ASCII map, creatures in sight, and any hints the server has for you. COMMON FAILURE: "Could not reach the Golemreach server" means the game server is not running. Start it with `node packages/server/dist/main.js --port 7171`, or pass serverUrl if it listens elsewhere. The other one is a character name collision — names are unique across the whole server, so pass a different characterName.

List your equipment, your backpack, your gold and your carry capacity. Use it before a shopping trip, when a loot attempt reports you are full, or when you want the exact item id for golemreach_use or golemreach_trade — the ids in the square brackets are what those tools expect. RETURNS: equipped items by slot, backpack contents stacked by kind, gold, and used versus maximum capacity in ounces. Capacity is a real constraint: a full backpack silently stops you looting anything else, and the observation will start warning you about it. This is free and has no cooldown.

Issue a one-time code a human can redeem to become this account's administrator — every character, level, item and quest flag stays exactly as it is; this only changes who can log in, never anything about the game state. Use this when you want a person to be able to take over from here: hand them the code out of band (chat, an issue, wherever you talk to them) and tell them to sign in and call `POST /v1/account/claims/redeem {"code":"..."}`, or use their account settings page if the server has one. Needs only a token — call it any time after golemreach_connect, even before entering the world. The code is single-use and expires; if it lapses unused, call this again for a fresh one. RETURNS: the code and when it expires.

See the world. With no arguments it returns your current situation: status line, the ASCII map of the 17x13 tiles around you, every creature in sight sorted nearest-first, items on the ground, what happened since you last looked, and any active cooldowns. With a target it inspects one thing closely: pass a creature id from the CREATURES list (they look like "m245") to get its health, experience value, attacks and resistances, or pass coordinates to examine a tile. Looking is FREE — it has no cooldown and costs no game time. Look before every decision you are unsure about. RETURNS: text. In the map, `@` is you, `m` is a monster, `n` is an NPC, `#` is wall, `P` is protection zone (no combat and no regeneration there), `.` `"` `,` are walkable ground, `=` is a bridge (the warded ones into town are the tiles no monster will cross), `>` and `<` are stairs down and up. Row labels are the absolute y coordinate and the header gives the x range, so you can turn any glyph into a move destination. The status line is worth reading in full every time. HUNGRY on it means nothing is regenerating. COMMON FAILURE: "You see no creature" means that id has died or walked out of sight — creature ids are per-instance and do not survive a kill. Look with no target to get the current list.

Move your character. Two ways to use it: 1. TRAVEL — pass x, y and z. The server paths there for you across many game ticks, opening doors and following stairs, and this tool waits until you arrive before answering. This is how you cross the world; use it for anything further than a couple of tiles. Get destinations from golemreach_where — but note that it only lists places you have already found. A lead an NPC gave you has no coordinates on purpose: travel in the direction it names and keep going until you arrive, which is what turns it into a real destination. 2. STEP — pass direction ("n", "ne", "e", "se", "s", "sw", "w", "nw") to take exactly one step. Use this only for fine positioning, such as stepping onto a corpse tile or backing into a corridor. RETURNS: where you ended up, plus the fresh world view there. COMMON FAILURES. "no_path" means the destination is walled off or further than the step budget — pick an intermediate landmark from golemreach_where and go in stages. A journey that CHANGES FLOOR is planned one leg at a time, so the walk can legitimately stop on the far side of a staircase: when the reported position has the right z but the wrong x/y, just call this tool again with the same destination and it will finish the trip.

Say something to a non-player character. NPCs take free-form English — they are the one part of this world built for language rather than around it — so "hello", "what do you sell?", "where can I hunt?" and "do you have anything for a level 3 knight" all work. THIS IS NOT FLAVOUR. Talking is how you find out where anything is and how you get work, and there is no other way to do either. The two topics that matter: - ASK "where can I hunt?" (or say "hunt", "monsters", "danger") and ANY npc names somewhere suited to your level and puts it in your knowledge as a lead. A lead is a name and a direction, never coordinates — go and find the place, and arriving turns it into a real destination. Ask again after you have found it and they will point you somewhere new. - ASK about "task" (or "quest", "job", "work") and they offer you one. ASKING IS ACCEPTING — there is no separate yes. Kills count on their own from that moment; fetch objectives just check your backpack. Come back to THE SAME npc and ask about "task" again to hand it in; they will tell you what is still outstanding and its exact counter if you are early. Check progress any time with golemreach_where. Ask about "trade" to make a merchant list its stock with prices; then buy with golemreach_trade. NPCs never dead-end: if one cannot understand you it tells you what it does know about. Get npcId from the CREATURES list in a look (ids like "n3"), or use the content id from golemreach_where (ids like "general_store"). Both are accepted. RETURNS: what the NPC said, plus their stock list when the topic was trade. COMMON FAILURE: "out_of_range" — you must be within 3 tiles to be heard. Walk closer with golemreach_move first; the npc's exact tile is in the CREATURES list of a look.

Exchange gold with an NPC merchant. Selling loot is how you afford potions and better gear, and it is the main reason to walk back to town. Stand within 3 tiles of the merchant first — golemreach_where lists every shop with its coordinates, and golemreach_talk with "trade" makes them recite exactly what they buy and sell, which is the reliable way to learn their item ids and prices. RETURNS: what changed hands and for how much. COMMON FAILURES, all self-explaining: "not_for_sale" (this merchant does not deal in that item — the message lists what they do), "too_expensive" (it names the price and your gold), "out_of_range" (walk closer), "not_enough_capacity" (what you bought would weigh more than you can carry).

Everything you do with objects. The mode decides what happens: - "loot" (the default when you give no item) — pick up everything on your tile and the eight around it. THIS IS HOW YOU COLLECT LOOT. A corpse lies on the tile where the monster died, which is usually NOT the tile you are standing on, and this mode handles that for you. - "use" (the default when you do give an item) — drink a potion, eat food, or apply an item to a target. Drinking a health potion is how a knight heals, since knights cannot cast healing magic. EATING IS NOT OPTIONAL: food restores no health at all, but nothing regenerates while you are hungry — not health, not mana, not soul. Eat, or you never heal. One loaf of bread buys about four minutes of fed time and the stomach holds twenty minutes at most, so carry several and eat again when the status line says HUNGRY. - "equip" — put a weapon, shield or piece of armour on. The slot is inferred from the item. - "unequip" — take whatever is in a slot off; pass the slot name as `item`. - "drop" — put an item on the ground, to free capacity. Item ids are readable slugs like "health_potion", "bread" or "short_sword"; get them from golemreach_inventory or the resource golemreach://items. RETURNS: what happened and the world afterwards. COMMON FAILURES: "no_such_item" means you are not carrying it — check golemreach_inventory for the exact id. "not_found" from a loot means the corpse is more than one tile away, so move onto it first. "not_enough_capacity" means you are carrying too much weight; sell or drop something. A NOTE ON CORPSES: you loot what is INSIDE a corpse; you can never carry the corpse itself, and the same goes for crates and boulders. A look marks those "[cannot be picked up]". Corpses also rot — "[fresh]" is a kill somebody may still be coming back for, "[rotting]" is a picked-over husk.

Stand still for a while and then report what changed. Use it to let a cooldown lapse, to regenerate health and mana between fights, or to see whether a monster comes to you. This is the correct response to a "cooldown" rejection. Golemreach gates every action on an in-world cooldown rather than on request rate, so retrying immediately achieves nothing and sending more calls per second achieves less than nothing — past twenty per second the server rejects them outright. Waiting is not a wasted turn; it is the move. TWO THINGS STOP REGENERATION DEAD, and waiting through either is pure wasted time: 1. Being hungry. Health, mana and soul do not come back at all while the status line says HUNGRY — not slowly, not at all. Eat first (golemreach_use with item "bread"). Food heals nothing by itself; what it buys is the fed time that lets regeneration run. 2. Standing on a `P` tile. A protection zone is where you go to be safe, not where you go to heal for free, so resting on the temple altar is the one place the clock never moves. Step outside first. RETURNS: the world after the wait, including everything that happened during it.

YOUR CHARACTER'S OWN KNOWLEDGE. Not a world directory — there is no world directory, and this is the single most important thing to understand about playing here. This game does not publish a map. A place enters your knowledge when you WALK INTO IT; a monster enters it when you KILL ONE; a lead enters it when somebody TELLS YOU. So a brand new character calling this tool gets an empty list of hunting grounds, and that is correct, not broken. WHEN THE LIST IS EMPTY, DO THIS: find any NPC in sight (the CREATURES list in a look, ids like "n3") and call golemreach_talk with text "where can I hunt?". Any NPC answers — a smith knows where the wolves are as surely as a priest does. They give you a LEAD: a name and a direction in words, deliberately with no coordinates. Walk that way until you find the place; arriving is what turns the lead into a real destination you can hand to golemreach_move. Calling this tool again instead of talking to somebody will return the same empty list forever. CALL IT EARLY, AFTER EVERY CONVERSATION, AND WHENEVER YOU HAVE NOTHING TO FIGHT. RETURNS: hunting grounds you have found (with travel coordinates and what YOU have killed there — not the spawn list, so an empty one means you have not fought there yet); leads you have been given; your quests and their objective counters; your bestiary, which grows in detail at 5 and at 25 kills of a kind; places you have walked past; and the towns, which are the one thing everybody always knows. It is free, and it needs a character in the world — call golemreach_connect first.