ClawQL documentation
ClawQL registers core tools search and execute, plus optional sandbox_exec (remote code in a Cloudflare Sandbox via bridge), memory_ingest, and memory_recall (Obsidian vault), and optional ingest_external_knowledge (bulk Markdown + optional URL fetch). An internal GraphQL projection layer keeps API responses lean for OpenAPI 3, Swagger 2, and Google Discovery. The same tool set is available over stdio, Streamable HTTP, and (when enabled) gRPC via the reusable mcp-grpc-transport package—see Deployment and Kubernetes. Full tool reference (repo).
Optional cache (CLAWQL_ENABLE_CACHE) is in-process LRU scratch storage, not the vault — Session cache, cache-tool.md. Optional audit (CLAWQL_ENABLE_AUDIT) is an in-process event buffer for operator trails — enterprise-mcp-tools.md (#89).
Getting started
Install clawql-mcp, run it on stdio, then point your MCP client (e.g. Cursor or Claude Desktop) at the server. Optionally set CLAWQL_SPEC_PATH, CLAWQL_SPEC_URL, or CLAWQL_DISCOVERY_URL; if you set nothing, ClawQL loads a bundled multi-provider merge (Google top 50 + Cloudflare + GitHub).
Guides
Install
Install clawql-mcp, understand package size and binaries, and run with npx or from source.
MCP clients
Wire Cursor, Claude Desktop, or HTTP hosts with stdio, spec env, vault, and sandbox bridge.
Spec configuration
OpenAPI paths, URLs, Google Discovery, merged presets, and CLAWQL_* precedence.
Kubernetes
Docker Desktop via Helm (localhost:8080/mcp), auth, rebuilds, and Kustomize dev/prod deploy.
Helm
Helm chart at charts/clawql-mcp: install, values, GHCR image, optional Ingress and PVC.
Reference
Tools
Core search and execute; sandbox_exec, memory tools, ingest_external_knowledge (bulk Markdown + optional URL fetch); optional in-process cache (CLAWQL_ENABLE_CACHE) and optional audit ring buffer (CLAWQL_ENABLE_AUDIT).
GraphQL proxy
How in-process GraphQL keeps execute responses lean (single-spec) vs REST (multi-spec).
gRPC and Kubernetes
Optional protobuf MCP over gRPC (port 50051), Streamable HTTP on /mcp, ENABLE_GRPC, Docker Desktop and remote clusters.
Bundled specs
Provider presets shipped in the package and how CLAWQL_PROVIDER selects them.
Concepts
Architecture, design principles, and how planning vs execution affect context size.
Benchmarks
What the benchmark numbers mean and where to find reproducible artifacts in the repo.
Case study: Cloudflare docs
End-to-end MCP workflow: search, execute, memory_recall, memory_ingest — deploying docs.clawql.com and fixing Worker runtime issues.
Case study: Vault + GitHub session
memory_ingest at scale, issue triage and new tracking issues, prioritization, and shipping the enterprise audit tool with full docs and Helm wiring.