Skip to main content

Presets and filtering

Presets are allow lists that decide which capabilities are exposed to inbound clients. Each preset lists specific tools, prompts, and resources with an explicit enabled flag.

Why presets​

  • Keep system prompts small by exposing only what is required.
  • Enforce task specific toolsets across teams.
  • Switch contexts instantly without editing downstream servers.

Namespaced routing​

All inbound tool calls must be prefixed as serverId:toolName. The namespace ensures Broxy can route the call to the correct downstream server even when tool names overlap.

Filtering behavior​

  • Only entries marked enabled: true are exposed.
  • Missing tools or prompts are skipped with a warning.
  • When no preset is active, Broxy exposes an empty capability set.

Example​

{
  "id": "triage",
  "name": "Incident triage",
  "tools": [
    {"serverId": "search", "toolName": "query", "enabled": true},
    {"serverId": "metrics", "toolName": "getChart", "enabled": true}
  ],
  "prompts": [],
  "resources": []
}

Switch presets with the CLI --preset-id flag or via the desktop UI. Changes are applied without restarting clients.