Ketoy
Tooling

Ketoy MCP

A knowledge layer for AI coding agents. It tells your agent what Ketoy supports before it writes a line.

The Ketoy MCP is a knowledge layer for AI coding agents. It answers one question with authority: is this supported in Ketoy, and if not, how do you bridge it. Your agent stops guessing and writes code that compiles to KBC.

It is read-only. It never writes code for you. It tells your agent what works, by what mechanism, and where the escape hatch is. The support matrix is extracted from the SDK source, so the answers stay accurate to the code.


Connect

The server is live at http://mcp.ketoy.dev/mcp.

bash
# Claude Code
claude mcp add --transport http ketoy http://mcp.ketoy.dev/mcp
  • Claude.ai and Desktop: add it as a Custom Connector (HTTP) pointing at http://mcp.ketoy.dev/mcp.
  • Codex, Cursor, and Windsurf: add an HTTP MCP server entry with the same URL.

What it needs

Nothing. No account, no API key, no database. It is pure compute serving bundled knowledge, hosted on Cloudflare Workers. Supported MCP protocol versions: 2025-06-18, 2025-03-26, 2024-11-05.


Tools

Point your agent at these. ketoy_overview and ketoy_check_support carry most of the value.

ToolUse it for
ketoy_overviewOrientation and the adapter, capability, and language decision tree. Call it first.
ketoy_check_supportAsk before using any Compose component or API. Supported? by what mechanism? escape hatch if not.
ketoy_validatePaste a snippet for a heuristic pre-check: will this compile to KBC?
ketoy_listEnumerate a category: composables, constructors, defaults, shapes, modifiers, tokens, capabilities, canvas, language.
ketoy_capabilitiesDefine, register, and wire capabilities. Room, DataStore, Retrofit, and navigation recipes.
ketoy_viewmodelTyped ViewModels, local state, effects, lifecycle, and the limits.
ketoy_setupGradle, BOM, the ketoy { } DSL, Hilt, signing, and version caveats.
ketoy_buildBuild the .ktx locally with Gradle, with advisories and gotchas.
ketoy_debugMap a KetoyBC: error or crash to a fix.
ketoy_cliThe Cloud CLI for auth, apps, push, and rollback.
ketoy_searchFree-text search over everything.

How your agent uses it

The pattern is simple. Before writing UI, the agent checks support. Before building, it validates. When a build fails, it debugs.

  1. Orient. Call ketoy_overview to learn the shape of what Ketoy allows.
  2. Check. Before using a composable or API, call ketoy_check_support. The answer says whether it is catalogued, how it renders, and how to bridge it if not.
  3. Validate. Paste the draft into ketoy_validate to catch forbidden APIs and uncatalogued composables before you compile.
  4. Debug. When you hit a KetoyBC: error, ketoy_debug maps the symptom to the fix.

Next: ship what your agent builds with the Ketoy CLI.