How do I install ClawQL?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ClawQL need an API key?

No required environment variable is listed on this record.

What transport does ClawQL use?

ClawQL runs locally over stdio.

ClawQL MCP server

Q: When was ClawQL last checked?

Last checked 2026-10-27. MCP server: search + execute over OpenAPI 3, Swagger 2, or Google Discovery, with optional internal GraphQL for lean API responses. Bundled multi-provider specs (GCP top 50, Cloudflare, Jira, GitHub, Slack, Sentry, n8n) let agents discover operations without loading full API definitions into context.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add danielsmithdevelopment-clawql -- npx -y clawql-mcp@7.2.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "danielsmithdevelopment-clawql": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked

Overview

About ClawQL

MCP server: search + execute over OpenAPI 3, Swagger 2, or Google Discovery, with optional internal GraphQL for lean API responses. Bundled multi-provider specs (GCP top 50, Cloudflare, Jira, GitHub, Slack, Sentry, n8n) let agents discover operations without loading full API definitions into context.

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

ClawQL

ClawQL provides the Agentic Gateway as the Foundational Platform for Auditable Production AI.

The Agentic Gateway is an MCP + OpenAI-compatible control plane for API discovery and execution with a token-efficient search -> execute workflow over OpenAPI, Google Discovery, and optional native GraphQL and gRPC sources (see CLAWQL_GRAPHQL_URL / CLAWQL_GRAPHQL_SOURCES / CLAWQL_GRPC_SOURCES in .env.example and ADR 0002). GraphQL-only vendors (e.g. Linear) need no OpenAPI spec: use CLAWQL_PROVIDER=linear (bundled SDL under providers/linear/ + LINEAR_API_KEY), or point CLAWQL_GRAPHQL_URL at their HTTP endpoint and auth headers, or load search from CLAWQL_GRAPHQL_SCHEMA_PATH / CLAWQL_GRAPHQL_INTROSPECTION_PATH (or per-source schemaPath / introspectionPath) when upstream introspection is disabled — without CLAWQL_SPEC_* / CLAWQL_PROVIDER, the default bundled REST specs are not loaded.

Enterprise topology: Zero-Trust Agentic Fabric (Regional Hubs · Dedicated Virtual Gateways · Edge Gateways). GTM: inference-first playbook.

What You Get

Feature tiers (aligned with the architecture diagram — details in docs/readme/configuration.md):

ClawQL Core (always on — no opt-out): search, execute, audit, cache — same band in the diagram; ring-buffer semantics for audit and LRU semantics for cache in docs/mcp/enterprise-mcp-tools.md and docs/mcp/cache-tool.md.
Default on — opt out: memory_ingest / memory_recall, and the document stack (ingest_external_knowledge, plus knowledge_search_onyx when CLAWQL_ENABLE_ONYX=1). Use CLAWQL_ENABLE_MEMORY=0 or CLAWQL_ENABLE_DOCUMENTS=0 to hide; vault path still required for real disk I/O on memory / ingest.
Default off — opt in: sandbox_exec (CLAWQL_ENABLE_SANDBOX=1), schedule, notify, knowledge_search_onyx (needs CLAWQL_ENABLE_ONYX=1 and documents on), ouroboros_* — see docs/mcp/mcp-tools.md. When enabled, CLAWQL_SANDBOX_BACKEND: omit = bridge; auto = Seatbelt → Docker → bridge.
Stdio and HTTP MCP server modes
Bundled provider specs for offline lookup and multi-provider workflows

Primary package: clawql-mcp (7.0.0 — Agentic Gateway entry; default stack, vault-first onboarding, opt-in operator scaffold — RELEASE_NOTES_v7.0.0.md · announcement drafts: docs/announcements/announcement-drafts-v7.0.0.md)
Repo: https://github.com/danielsmithdevelopment/ClawQL

Container images on GHCR (Docker / Helm)

Prebuilt images live on GitHub Container Registry under ghcr.io/danielsmithdevelopment/ (clawql-mcp, clawql-website, clawql-dashboard, clawql-panguard-mcp-bridge). They are supposed to be public so anyone can docker pull without credentials and Kubernetes defaults (Kyverno) can verify signatures. If docker pull returns denied, the registry package is still private — see docker/README.md § GHCR visibility (checklist + make ghcr-packages-public for maintainers).

Quick Start

Install:

npm install clawql-mcp

Run with a slim server (no bundled OpenAPI catalog loaded). Opt into the curated pack when you want it:

npx -p clawql-mcp clawql init --interactive   # vault-first onboarding
npx -p clawql-mcp clawql mcp-config           # MCP JSON for Cursor
# Optional curated pack (CF + GitHub + Slack + Linear + Notion + Onyx):
CLAWQL_INSTANCE_SPEC='{"providers":{"pack":"default"}}' npx -p clawql-mcp clawql-mcp
# Or: CLAWQL_PROVIDER=default npx -p clawql-mcp clawql-mcp
npx -p clawql-mcp clawql-mcp

For every bundled vendor plus Google top-50 and AWS top-50:

CLAWQL_PROVIDER=all-providers npx clawql-mcp

Then configure your MCP client (Cursor/Claude Desktop) to connect — or paste the agent setup prompt into your agent.

Documentation Map

Top-level docs index: docs/README.md

Start here

Zero-Trust Agentic Fabric: docs/architecture/zero-trust-agentic-fabric.md — /architecture/agentic-fabric
Getting started: docs/readme/getting-started.md
Set up with your agent: docs/getting-started/agent-setup-prompt.md · init walkthrough spec: docs/getting-started/clawql-init-walkthrough-spec.md
Plugins hub: docs/plugins/README.md — /plugins
Configuration and env precedence: docs/readme/configuration.md
Deployment and client config: docs/readme/deployment.md (Kubernetes list links docs/deployment/docker-desktop-istio-observability.md for Istio + Prometheus/Grafana/Tempo/Kiali/OTel on Docker Desktop)
Benchmarks and case studies: docs/readme/benchmarks.md
Development notes: docs/readme/development.md
Tool workflow skills: docs/skills/README.md

Core references

Modularization ground truth: docs/design/modularization-implementation-status.md
Plugin model & registry: docs/design/clawql-plugin-model.md, docs/reference/clawql-plugin-registry.md
MCP tools and examples: docs/mcp/mcp-tools.md
Workflow recipes: docs/recipes/README.md
Memory and vault workflows: docs/memory/memory-obsidian.md
Cache tool: docs/mcp/cache-tool.md
Enterprise MCP notes (audit threat model, future metrics/governance): docs/mcp/enterprise-mcp-tools.md
Slack notify tool: docs/mcp/notify-tool.md
Onyx knowledge tool: docs/mcp/onyx-knowledge-tool.md
Ouroboros package and integration: docs/ouroboros/clawql-ouroboros.md

Deployments

Docker: docker/README.md
Cloud Run: docs/deployment/deploy-cloud-run.md
Kubernetes: docs/deployment/deploy-k8s.md
Helm chart (clawql-mcp): docs/deployment/helm.md
IDP umbrella chart (clawql-idp): docs/deployment/clawql-idp-helm.md — full-stack profile via values-idp-full.yaml
IDP observability bundle: docs/observability/README.md (Grafana dashboard + trace/metrics guide)
OpenClaw + Slack IDP runbook: docs/openclaw/slack-first-idp-runbook.md
Agent PR → Argo CD GitOps: docs/gitops/agent-pr-argocd-pipeline.md
Tailscale / Headscale (beginner guide): docs/deployment/tailscale-and-headscale-for-clawql.md (website /tailscale)
Headscale runbook + ACL starter: docs/deployment/headscale-tailnet.md, docs/deployment/headscale-acls-clawql.hujson

IDP (intelligent document processing)

Eight bundled vendors (Nextcloud, Docling, Tika, Gotenberg, Stirling, Paperless, Onyx, Coneshare) compose via search / execute or optional MCP tools (run_idp_pipeline, classify_document, extract_document). Hub: docs/providers/idp-pipeline.md · matrix: docs/roadmap/idp-master-requirements-matrix.md · OpenClaw profile: docs/openclaw/openclaw-idp-skill-profile.md

Security and supply chain

Security overview and shipped controls: docs/security/README.md
Golden image pipeline (CI → scan → push → sign → Kyverno enforcement): docs/security/golden-image-pipeline.md
Defense in depth reference: docs/security/clawql-security-defense-in-depth.md
Engineering deliverables matrix (shipped/partial/planned): docs/security/clawql-security-defense-deliverables.md
Docker SBOM/sign/scan operator notes: docker/README.md
npm publish hardening (pack → scan → publish, provenance): docs/security/npm-supply-chain.md
Deploy-time image signature enforcement (admission / Kyverno): docs/security/image-signature-enforcement.md

Providers and specs

Provider matrix and presets: providers/README.md
Google Discovery helpers: docs/providers/google-apis-lookup.md
AWS top-50 preset: docs/providers/aws-apis-lookup.md, docs/providers/aws-onboarding.md

Architecture (Short Version)

Agent calls search to discover relevant operations without loading entire specs into prompt context.
Agent calls execute with operation details.
For OpenAPI/Discovery operations: in single-spec mode, ClawQL prefers an internal OpenAPI-to-GraphQL path (REST fallback on failure); in multi-spec mode, execute uses REST per owning spec.
For native operations (when configured): execute calls HTTP GraphQL or gRPC unary directly — same search index, routed by operation metadata — see ADR 0002.

Notes

Core (search, execute, audit, cache) has no opt-out — no CLAWQL_ENABLE_* gate for those tools.
A writable CLAWQL_OBSIDIAN_VAULT_PATH is required to read/write the vault for memory_* and bulk ingest_external_knowledge.
For full environment variable details, see .env.example and docs/mcp/mcp-tools.md.

Add this server

Host a copy with our keys and logs.

Server facts

About ClawQL

Tools

Questions

How do I install ClawQL?

Does ClawQL need an API key?

What transport does ClawQL use?

When was ClawQL last checked?

Documentation

ClawQL

What You Get

Container images on GHCR (Docker / Helm)

Quick Start

Documentation Map

Start here

Core references

Deployments

IDP (intelligent document processing)

Security and supply chain

Providers and specs

Architecture (Short Version)

Notes