Skip to content

Bundled providers

Bundled providers are on-disk OpenAPI / Discovery / GraphQL specs under providers/. They power search and execute — they are not MCP plugins and have no Plugin.onRegister hook.

Available by default, loaded only when opted in — same spirit as horizontal MCP plugins.

No-config default

Fresh install with no provider selection loads nothing from the catalog (native GraphQL/gRPC only when configured). Core MCP tools (search, execute, audit, cache) still register.

Opt-in (preferred)

Mechanism Example
Instance providers.pack CLAWQL_INSTANCE_SPEC=\{"providers":\{"pack":"default"\}\}
Instance providers.enabled \{"providers":\{"enabled":["github","linear"]\}\}
Helm providers.pack: default (chart default is none)

Curated pack default

Provider Notes
Cloudflare Edge/DNS/Workers APIs
GitHub REST automation
Slack Web API (powers optional notify when enabled)
Linear Bundled GraphQL-only vendor
Notion Official REST OpenAPI
Onyx Enterprise search spec (pair with Onyx MCP tool when enabled)

Other packs

pack / CLAWQL_PROVIDER Behavior
none Explicit empty (same as no-config)
default / default-providers Curated six-vendor pack above
all-providers Every bundled vendor + Google top-50 + AWS top-50
google, aws, atlassian Focused merged presets
CLAWQL_BUNDLED_PROVIDERS=a,b,… Custom explicit subset

Only CLAWQL_ENABLE_DOCUMENTS=0 trims the document/IDP vendor set from all-providers.

Deprecated env flags

CLAWQL_ENABLE_GOOGLE / CLAWQL_ENABLE_AWS / CLAWQL_ENABLE_CLOUDFLARE no longer select the provider stack. Use providers.enabled: ["google"] or pack: "google" / all-providers instead.

Precedence

  1. CLAWQL_SPEC_PATHS
  2. CLAWQL_BUNDLED_PROVIDERS
  3. Instance providers (CLAWQL_INSTANCE_SPEC)
  4. CLAWQL_PROVIDER (merged pack or single vendor)
  5. Empty stack when nothing else is set

Single-spec mode (CLAWQL_SPEC_PATH, CLAWQL_PROVIDER=cloudflare, …) bypasses the merge rules above.

See also