Preset basics

A preset is an allow list that defines the capabilities Broxy publishes to clients.

Why presets exist

• Many MCP servers expose large tool sets.
• Clients perform better with a focused tool list.
• Presets let you switch context quickly without changing client config.

Where you edit presets (UI)

• Open the Presets screen.
• Click the + button to create a preset or select an existing one.
• Use the Tools, Prompts, and Resources sections to pick what to expose.

What a preset controls

• Tools: always a strict allow list.
• Prompts: allow list if provided; otherwise include all prompts from in-scope servers.
• Resources: allow list if provided; otherwise include all resources from in-scope servers.

In-scope servers

Only servers referenced by a preset are considered "in scope". If a server is not referenced, none of its capabilities are published to clients.

Built-in presets

Broxy reserves a few preset ids that are not backed by files:

• __empty__: exposes no capabilities.
• __all_enabled__: exposes all tools/prompts/resources from enabled servers.