bunkerweb-mcp MCP Server

A production-ready MCP server that exposes BunkerWeb's internal API to large language models via a constrained tool interface. The server provides both HTTP (for testing) and WebSocket (for MCP clients) JSON-RPC…

Local serverstdio

What is the bunkerweb-mcp Server?

bunkerweb-mcp source profile. From the maintainer documentation: “A production-ready MCP server that exposes BunkerWeb's internal API to large language models via a constrained tool interface. The server provides both HTTP (for testing) and WebSocket (for MCP clients) JSON-RPC endpoints, strict input validation, and a resilient async client with retries.”

Local setup

The project provides a local client configuration using /path/to/your/.venv/bin/bunkerweb-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares BUNKERWEB_BASE_URL, BUNKERWEB_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_bunkerweb_docsSemantic search across BunkerWeb documentation (query, limit, category)
pingCheck API reachability
healthRead the API health probe
list_instancesList registered BunkerWeb instances
reload_instancesReload configuration across all instances (test flag supported)
reload_instanceReload a specific instance (hostname, optional test)
list_bansRetrieve active bans
ban_ipBan one or multiple IPs (bans array with ip, exp, reason, service)
unban_ipRemove bans (bans array with ip, optional service)
list_servicesList services (with_drafts flag)
get_serviceFetch details for a specific service (service, full, methods, with_drafts)
delete_serviceDelete a service (service)
logs_listList active and uncompressed rotated BunkerWeb log sources
logs_readRead bounded recent lines (source, optional literal query, limit, cursor)

How to install the bunkerweb-mcp Server

{
  "mcpServers": {
    "bunkerweb": {
      "type": "stdio",
      "command": "/path/to/your/.venv/bin/bunkerweb-mcp",
      "env": {
        "BUNKERWEB_BASE_URL": "http://<bunkerweb-api-host>:8888",
        "BUNKERWEB_API_TOKEN": "YOUR_BUNKERWEB_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
BUNKERWEB_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
BUNKERWEB_API_TOKENDeclared in the maintainer’s client configuration.Optional