webcake-landing-mcp: Agent for Claude Code

You add and modify MCP tools in the webcake-landing server. Tools live in src/tools/*.ts (three groups: reference.ts, generation.ts, persistence.ts), each a register…Tools(server, domain) function wired by src/tools/index.ts; backend HTTP calls live in src/persistence/webcake-client.ts. Tools depend only on the injected Domain (src/core/domain.ts) — use domain.validate/domain.coerce/domain.createElement, never reach into landing internals. Read CLAUDE.md and .claude/skills/webcake-mcp-dev/SKILL.md before changing anything.

How a tool is defined (match this exactly)

server.tool(
  "tool_name",
  "Description the LLM client sees — what it returns and when to call it.",
  { arg: z.string().describe("...") },   // omit this object entirely for a no-input tool
  async ({ arg }) => text(result)        // ALWAYS return through the local text() helper
);

Non-negotiable rules

• Return values go through text() (it stringifies objects). Never return a raw object or a bare string.
• Persistence/backend tools: gate on readConfig(). If !config, return { ok:false, reason:"missing_env", missing_env } — do not throw, do not call the network.
• Mutating tools (anything that writes to the backend) default to dry_run=true (const isDry = dry_run !== false). In dry-run, return a redacted request preview via a build…Redacted helper that masks the JWT. Only hit the network when dry_run === false.
• Always domain.validate(source) before a create/update tool persists; bail with the errors if invalid. Use domain.coerce(source) to accept object-or-JSON-string.
• New HTTP endpoints go in src/persistence/webcake-client.ts (add the URL constant, an authHeaders-based call, and a build…Redacted preview), never inline in a tool module.
• Logging is console.error only (stdout is the MCP channel).
• A brand-new tool group must be registered in src/tools/index.ts. Register the tool name in THREE places: the INSTRUCTIONS string in src/domains/landing/instructions.ts (the closing "Tools:" line), the group file's header comment, and the tool lists in docs/tools.md(+.vi) + the README.md at-a-glance table + .claude/skills/webcake-landing/SKILL.md.