Assistants

AI & ACS

Install TheTowerSDK, connect an AI coding assistant through MCP, and optionally add Agentic Cognition Substrate so the assistant stays structured while it builds.

1. Connect An AI To The Package

After npm install thetowersdk, register this MCP server. The assistant can list exports, read catalogs, decode saves, plan paths, and fetch wiki pages.

{
  "mcpServers": {
    "thetowersdk": {
      "command": "node",
      "args": ["./node_modules/thetowersdk/mcp/server.mjs"]
    }
  }
}

Claude Code: claude mcp add thetowersdk -- node ./node_modules/thetowersdk/mcp/server.mjs

2. Give It The Oracles

Two knowledge sources the assistant can query for game mechanics.

The Tower Oracle

A knowledge graph of how mechanics relate, and the specific ways each has been misread. oracle_traps returns those before you model a mechanic; oracle_expand resolves acronyms from a closed set.

oracle_coverage reports how well a compartment is covered, and oracle_contradictions lists claims that disagree, ranked by source authority.

The Sheet Oracle

Reads a live Google Sheet, so the assistant works from a spreadsheet's own calculations. eval_formula evaluates a formula in the sheet and returns what it computes.

Works on any sheet shared with a Google service account. Registering a Service Account →

3. Give It a Real Save

adb-bridge pulls the current save from a phone or emulator and serves it locally, so an assistant builds and tests against a real account and sees it change as you play. Save File Docs →

4. Ask It To Design Tools

Sample asks below. With TheTowerSDK MCP and ACS, the agent researches the mechanic, confirms package exports, builds the tool, then checkpoints — wiki and catalogs first, UI second.

Lab cost tool

You ask

Design a lab cost tool with thetowersdk: lab picker, current level, and a table of coin cost + research time for the next 10 levels, formatted like the game.

What the agent does

1. ACS opens a labs task and records status (researching)
2. TheTowerSDK MCP loads wiki context for Labs before any UI is written
3. list_exports / get_export resolves LAB_CATALOG + game number formatters from the package
4. Only then scaffolds the picker, level input, and next-10 cost/time table
5. ACS checkpoints the slice and moves status to implementing → awaiting your review

Save reader tool

You ask

Build a save reader: drop in playerInfo.dat and show labs researched/maxed plus equipped modules.

What the agent does

1. ACS opens a save-reading task (researching)
2. Wiki + package docs for playerInfo / labs / modules are pulled through MCP first
3. Exports confirmed: decodePlayerInfoSaveBytes and lab/module extractors
4. Builds upload → decode → researched/maxed + equipped modules UI on those APIs
5. ACS checkpoints; incomplete saves surface extractor warnings instead of invented fields

Economy planner tool

You ask

Build an economy planner UI that runs the effective economy path for N steps and lists what was bought vs skipped (with reasons).

What the agent does

1. ACS opens an Effective Paths / economy task (researching)
2. Wiki + MCP context for Effective Paths before controls or tables exist
3. Resolves planEffectiveEconomyPath and config helpers from thetowersdk/mechanics
4. Builds step/variant controls; renders plan.steps and plan.excluded from the planner
5. ACS checkpoints each slice so the UI cannot drift into a hand-written priority list

Wiki-backed reference tool

You ask

Design a small in-app reference that loads Tower wiki pages as Markdown (starting with Golden Tower) so the tool can show cooldown and related sections from the wiki.

What the agent does

1. ACS opens a wiki-ingestion task (researching)
2. Loads Golden Tower (and related titles) via wiki_page / fetchFandomPageAsMarkdown first
3. Confirms the Markdown API and section shape from that live pull
4. Then scaffolds page picker + Markdown panel wired to the same fetch path
5. ACS checkpoints so later pages reuse that path instead of hardcoded wiki text

ACS

Agentic Cognition Substrate

ACS sits next to the assistant and governs how it may change your repo — checkpoints, staging, clear status. TheTowerSDK supplies Tower knowledge; ACS supplies the workflow. Tower players can request personal access with a Player ID.

TheTowerSDK

Game data, save reading, formulas, wiki text, and the MCP server above.

Package on GitHub

Agentic Cognition Substrate

Rules and tooling for AI-driven edits. Full overview on the ACS site.

Agentic Cognition Substrate

Full ACS & Licensing Docs → · Request Personal ACS →