Server IDs and tool names

Every server has a unique server id. Broxy uses it as a namespace prefix for tools so clients can route requests to the correct server.

Why the prefix exists

Different servers can expose tools with the same name. Broxy avoids collisions by prefixing every tool with the server id:

• Downstream tool name: search
• Client-visible name: github_search

Clients must call tools using the prefixed name.

Prompts and resources are **not** prefixed; they are routed using the preset routing maps.

How server IDs are created

• In the desktop UI, Broxy generates a server id from the server name.
• If you edit mcp.json manually, the map key under mcpServers becomes the server id.

Best practices

• Keep ids short, lowercase, and stable.
• Avoid spaces; use hyphens if needed.
• Avoid underscores in new ids (the tool namespace uses _ as a delimiter).
• If you change a server id, update presets that reference it.