Tools

ClawQL exposes six tools when optional features are configured (see table below); the data plane for REST/Discovery APIs is search then execute. Agents call search to discover operations and parameters, then execute to run a chosen operationId with optional field selection. Canonical reference with examples.

A seventh tool, cache, is available when CLAWQL_ENABLE_CACHE is set — ephemeral in-process LRU storage, not the vault. See Session cache and cache-tool.md. An eighth optional tool, audit, is available when CLAWQL_ENABLE_AUDIT is set — in-process ring buffer for structured events (not durable) — enterprise-mcp-tools.md.

`search`

Searches the active OpenAPI/Discovery corpus by natural language intent and returns a short ranked list of matching operations (paths, methods, parameters, summaries). Work happens against an in-memory index inside the MCP process—full specs are not pasted into the model context.

`execute`

Runs a discovered operation by operationId with arguments shaped from the spec. Internally, single-spec mode prefers the GraphQL proxy so only requested fields flow back; multi-spec and some translation failures use REST directly. Agents do not author GraphQL; the server builds the internal query.

Typical workflow

1. search("delete a Cloud Run service")
   → top hits with operationId, method, path, parameters

2. execute("run.projects.locations.services.delete", {
     name: "projects/my-proj/locations/us-central1/services/my-svc"
   })
   → lean JSON (GraphQL-shaped or REST fallback)

See GraphQL layer for how execute uses OpenAPI→GraphQL in-process vs REST in multi-spec mode.

Optional tools

Tool	Needs
`sandbox_exec`	Deployed sandbox bridge Worker + `CLAWQL_SANDBOX_BRIDGE_URL` (remote sandbox; args include `code`)
`memory_ingest`, `memory_recall`	`CLAWQL_OBSIDIAN_VAULT_PATH` (writable vault directory); optional vector / hybrid DB — see repo docs
`ingest_external_knowledge`	Set `CLAWQL_EXTERNAL_INGEST=1`: bulk Markdown (`documents[]`) and optional URL fetch (`CLAWQL_EXTERNAL_INGEST_FETCH=1`) — external-ingest.md
`cache` (optional)	`CLAWQL_ENABLE_CACHE=1` — in-process LRU key/value only; not persisted — cache-tool.md, Session cache
`audit` (optional)	`CLAWQL_ENABLE_AUDIT=1` — in-process event ring buffer; not on disk — enterprise-mcp-tools.md (#89)

They do not replace execute for calling upstream APIs.