Tools

The Worker exposes the following tools via tools/list. All accept and return JSON; argument schemas are advertised in the MCP protocol so any client can pick them up automatically.

Apps

gummble.apps.list

Browse the app catalogue with filters.

{ "q": "linear", "platform": "ios", "limit": 10 }

gummble.apps.get

Fetch a single app by slug or ID, including all screens and flows.

{ "slug": "linear" }

Screens

gummble.screens.list

Filter screens across the library.

{ "pattern": "onboarding", "platform": "ios", "limit": 20 }

gummble.screens.get

Fetch one screen by ID.

Flows

gummble.flows.list

List multi-step user journeys.

gummble.flows.get

Fetch a flow with its ordered screens.

Search

gummble.search.universal

Hybrid keyword + semantic across apps / screens / flows.

{ "q": "passwordless sign-in", "type": "screen", "limit": 10 }

gummble.search.visual

Image-similarity search. Pass a base64-encoded screenshot.

{ "image_base64": "iVBORw0KG…", "limit": 10 }

Errors

Tool errors map to JSON-RPC error objects per the MCP spec:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: pattern must be a non-empty string"
  }
}