bunny-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
bunny-mcp
An MCP server for debugging bunny.net CDN sites and managing bunny Shield, the bunny.net web application firewall (WAF).
This is an unofficial project. It is not affiliated with or endorsed by bunny.net.
It covers pull zones (CDN sites), edge rules, cache purges, CDN statistics, origin error logs, and Shield: WAF settings, custom WAF rules, rate limits, bot detection and WAF event logs. It does not cover DNS, storage, Stream or edge scripts. For those, see anvme/bunnycdn-mcp or Digitizers/bunny-mcp.
What it does differently
Explains what rules will really do.
get_shield_zonereturnsnotesthat warn, for example, when Block rules only log because the zone's WAF execution mode is Log.Reads WAF event logs.
shield_event_logsshows what the WAF blocked, challenged or logged in the last 72 hours, grouped by rule, IP, JA4 fingerprint and more.Reports what changed. Update tools return a before-and-after diff.
update_pull_zonealso lists settings bunny.net changed that you did not ask for.Keeps responses small. Pull zones, edge rules, origin errors and event logs are summarised. Pass
detail: truefor the raw response.Hides credentials. Token authentication keys, AWS signing keys, TLS certificates and private keys, log forwarding tokens, and cookie or
Authorizationvalues in edge rule triggers are replaced with<hidden>, also in raw responses.
Related MCP server: Bunny.net MCP Server
Requirements
Node.js 20 or later
A bunny.net account API key, from Account settings > API key in the bunny.net dashboard. This key gives full access to the account.
Install
Claude Code:
claude mcp add bunny --env BUNNY_API_KEY=your-key -- npx -y @fullfatthings/bunny-mcpOther MCP clients (for example Claude Desktop):
{
"mcpServers": {
"bunny": {
"command": "npx",
"args": ["-y", "@fullfatthings/bunny-mcp"],
"env": { "BUNNY_API_KEY": "your-key" }
}
}
}Configuration
Variable | Meaning |
| Required. Your bunny.net account API key. |
| Set to |
Tools
Read tools:
Tool | Purpose |
| List pull zones with IDs, origins and hostnames. |
| One pull zone: hostnames, readable edge rules, and caching, origin and security settings. |
| Bandwidth, requests, cache hit rate and error responses. |
| Failed requests from bunny.net to your origin on one day, with counts by error. |
| WAF settings, custom rules, rate limits and bot detection, with |
| Requests the WAF blocked, challenged or logged in the last 72 hours. |
Write tools (not registered when BUNNY_READONLY=1):
Tool | Purpose |
| Change pull zone settings. |
| Purge one URL or a whole pull zone. |
| Create or update an edge rule. |
| Switch an edge rule on or off. |
| Delete an edge rule. |
| Change WAF settings, including adding or removing single rule IDs from lists. |
| Change bot detection mode and sensitivity. |
| Create or update a custom WAF rule. |
| Create or update a rate limit. |
| Delete a custom WAF rule or rate limit. |
To test a new WAF rule safely, save it with action Log, check shield_event_logs, then save it again with action Block.
Development
npm install
npm testTo release, run npm version patch (or minor or major). It updates package.json and server.json, commits, tags and pushes; the tag starts a GitHub Action that publishes to npm and the MCP registry.
Licence
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
This server cannot be deployed
Maintenance
Related MCP Connectors
Inspect pull zones, storage, DNS and video libraries on bunny.net, and purge caches.
DNS, email auth, TLS, BGP/RPKI, WHOIS and subnet tools with plain-English fixes, plus webhook URLs.
Debug background jobs — runs, traces, spans, schedules, queues and deployments.
Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables management of Cloudflare Ruleset Engine and WAF configurations through zone/account operations, ruleset management (add/update/delete rules), and access to Cloudflare documentation. Supports multi-zone and multi-account environments with built-in safety considerations.2MIT
- AlicenseBqualityDmaintenanceEnables interaction with Bunny.net APIs for Stream/Video, Storage, CDN Pull Zones, and DNS services. Provides 35 tools for managing video libraries, files, CDN configurations, and DNS records through Claude.37ISC
- AlicenseAqualityBmaintenanceEnables AI assistants to manage Bunny.net services such as pull zones, DNS, storage, video streaming, edge scripting, security, and Magic Containers through natural language.549 npmMIT
- AlicenseCqualityBmaintenanceEnables AI agents to inspect and manage Cloudflare zones through 29 tools covering DNS records, cache purges, zone settings, Rulesets, Worker metadata and read-only analytics. Read operations run freely while every mutation, such as a DNS edit or batch apply, stays behind explicit per-operation preview and confirmation with private, least-privilege token profiles.2954 npmAGPL 3.0