How to connect

Broxy exposes two inbound connection styles: STDIO and HTTP. Choose the one that matches your client's capabilities.

STDIO connection

STDIO is used when the client launches Broxy as a subprocess.

Example MCP config:

{
  "mcpServers": {
    "broxy": {
      "command": "/Applications/broxy.app/Contents/MacOS/broxy",
      "args": ["--stdio-proxy"]
    }
  }
}

Notes:

• STDIO is local-only and uses the current preset.
• Keep stdout clean for the protocol; Broxy logs to stderr in STDIO mode.

HTTP connection

HTTP is used when the client connects to a local port.

Default endpoints:

• Streamable HTTP: http://localhost:3335/mcp
• SSE endpoint: http://localhost:3335/sse

Example MCP config:

{
  "mcpServers": {
    "broxy": {
      "url": "http://localhost:3335/mcp"
    }
  }
}

Notes:

• If your client requires SSE, use /sse instead of /mcp.
• The port is configured in the Settings screen under "HTTP port".

Quick verification

If your client can list tools, a successful connection should show tools prefixed with the server id, for example github_search.