documentation

agents and MCP

Give MCP-compatible agents authenticated Brok tools.
Streamable HTTP MCP

connect an agent

Configure an MCP-compatible client with Brok’s authenticated endpoint. Keep the key in the agent host’s secret configuration.

{
  "mcpServers": {
    "brok": {
      "type": "http",
      "url": "https://api.brok.fyi/v1/mcp",
      "headers": { "Authorization": "Bearer $BROK_API_KEY" }
    }
  }
}
tools

available capabilities

  • web_searchAccepts query and returns structured search results.
  • understand_imageAccepts prompt and image_url and returns a model description.

The server supports MCP initialize, tools/list, and tools/call. Tool calls are authenticated, attributed, and visible in Usage.