About Zeus Dev Helper
Zeus Dev Helper is an MCP server published by koten-ai in the Developer Tools category: coach first Zeus Client app to green (stdio MCP).
Recent commit activity is the strongest signal that reported issues will get attention.
Install
uvx
uvx zeus-dev-helper-mcppip
pip install zeus-dev-helper-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (15)
bind_contractCopy a stamped `contract.hash` only. With no path, the source is the live bootstrap `chat_request`. A directory pointer is not a catalog. Refuses empty / local compute
Parameters not published.
diagnose_errorMap a symptom, hop name, and result keys to a failure class and one generated-file change
Parameters not published.
doctorHealth. `detail=health\
Parameters not published.
explain_scopeLive public `:8080` `chat_request.json` summary: entity types, display fields, text-search fields, FK fields, and list/detail/search verbs. When that body has no `## MINI-SCHEMA` heading, parse `bootstrap.chat_request`. A failed stamp leaves entity types empty. `fetch_chat_request` stays template only
Parameters not published.
next_stepCurrent item plus recommended tools and resource links
Parameters not published.
readiness_checkLive gates: healthz / readyz / version, auth, bootstrap. Marks **1.2** done only when the URL is set and, on a `run_turn` path, the process has an LLM key
Parameters not published.
recommend_surfaceIntent → Client surface + do-not list
Parameters not published.
sample_support_packRead-only paste for a beer, travel, or yelp-demo gate failure. Writes nothing and calls no Zeus API. Session ids stay in `support_pack_from_turn`
Parameters not published.
scaffold_appCLI or FastAPI (`app_kind=cli\
Parameters not published.
set_prereqStore non-secret prereqs (presence flags only; `has_llm_key` is not the key)
Parameters not published.
Show all 15 tools
smoke_test_agentOne Client `run_turn`. Needs `[agent]` extra and `LLM_API_KEY`, `XAI_API_KEY`, or `OPENAI_API_KEY` in this process
Parameters not published.
smoke_test_zeusNo LLM: readiness plus a read-only describe
Parameters not published.
start_projectInit checklist; `sample=travel` (UI default), `sample=beer` (catalog UI, `run_turn`), `sample=demo_yelp` (clone `demo_yelp`), or `sample=api`
Parameters not published.
use_sampleTravel UI clone, beer catalog clone (`demo_beer_sample`, `python main.py`, `run_turn`, `chat_request` omitted), `sample=catalog` from `explain_scope`, or yelp demo clone (`sample=demo_yelp`, sets `DEMO_YELP_SAMPLE_DIR`; downloads public photos into `frontend/public/business-images/<id>/`, no API key; live search and business page, review text from the source document)
Parameters not published.
website_greenInstall, start, and check the catalog page (named list card, page ids, search when Pour is on). A title-cased `doc_key` is not a search card. A describe 200 is not this check
Parameters not published.
Ask AI
✦
Ask AI about Zeus Dev Helper
Powered by Claude · Grounded in docs
I know everything about Zeus Dev Helper. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.
Releases
v0.7.7v0.7.7 · 10 Oct 20260.7.7 Fixed ZDM-23 `load_process_login` reads a mode-600 env file into this process. The password is not a tool argument. `set_prereq` stays presence flags only. `readiness_check` returns…
v0.7.6v0.7.6 · 6 Oct 20260.7.6 Fixed ZDM-18 `diagnose_error` takes a symptom, optional `req_id`, hop name, HTTP status, and the top-level keys of the hop result. It does not take a document body, and it does not…
v0.7.5v0.7.5 · 25 Sep 20260.7.5 Added ZDM-11 Helper MCP tool failures write one stderr line, `zeus_dev_helper.tool.failed`, in the Zeus Client family text shape. `source.file` is package-relative…
v0.7.4v0.7.4 · 23 Sep 20260.7.4 Changed ZDM-8 Host install docs no longer pin `localhost:8080` as the only `ZEUS_URL` example. README / `docs/HOST-MATRIX.md` lead with remote-host examples (`http://<zeus-host>:8080` /…
v0.7.3v0.7.3 · 18 Sep 20260.7.3 Changed License — project is now BSD-3-Clause (was proprietary). Aligns with `kotenai-zeus-client` / `demo_travel_sample`. See `LICENSE`, `pyproject.toml`, and README.