Cloudflare MCP Server
Exposes Cloudflare DNS, security, WAF rules, page-rule redirects, zone settings, and cache purge functionality through 16 structured tools that allow reading and modifying DNS records, managing firewall rules, creating redirects, and more.
Referenced as a sandbox environment for creating test zones to safely experiment with the Cloudflare MCP server's capabilities without affecting production infrastructure.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cloudflare MCP Server list DNS records for example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cloudflare MCP Server
Modern Model-Context-Protocol (MCP) server that exposes Cloudflare DNS, security, redirects and zone-settings functionality as structured tools which any compliant AI client (e.g. Claude Desktop) can invoke.
✨ Key Features
Rich Tool Catalog – 16 read & write operations covering DNS records, WAF rules, page-rule redirects, cache purge, zone settings and more.
Plug-and-Play with Claude Desktop – ships with STDIO transport so Claude immediately lists & calls tools; no extra adaptor required.
Type-Safe – written in TypeScript and powered by
@modelcontextprotocol/sdk, with zod schemas for every tool’s params & return value.Non-destructive by Default – destructive certificate-ordering functions are disabled out-of-the-box to prevent accidental cost.
Script Library & Tests – one-shot scripts for manual ops plus Jest integration/unit tests.
Related MCP server: Cloudflare Control
🚀 Quick Start
# 1. Clone & install
npm install
# 2. Configure credentials
cp config/.env.example .env
$EDITOR .env # put your CLOUDFLARE_API_TOKEN
# 3. Build & run the server (stdio)
npm run build
node dist/index.js # Claude Desktop will auto-detectNeed a sandbox? Cloudflare Workers Free Plan lets you create test zones.
🛠️ Tool Catalog
Category | Tool Name | Description |
General |
| Round-trip text for connectivity testing |
Zones |
| Enumerate zones the token can access |
Zones |
| Return full settings object |
Zones |
| Short settings summary |
DNS |
| Read all DNS RRsets |
DNS |
| Add a record |
DNS |
| Modify record |
DNS |
| Remove record |
Security |
| Read firewall rules |
Security |
| Add firewall rule |
Security |
| Edit firewall rule |
Security |
| Delete firewall rule |
Redirect |
| List redirects/page-rules |
Redirect |
| Create redirect |
Redirect |
| Delete redirect |
Cache |
| Purge URL or everything |
* Destructive operations – use with care.
SSL cert ordering/upload functions are intentionally not registered. Enable them by removing the filter in src/index.ts if required.
🧑💻 Development
# Watch-mode compile
npm run dev
# Run the full test suite
npm test
# Lint
npm run lintHandy demo scripts live under scripts/ (e.g. scripts/list-dns-demo.ts). All accept a --zone flag.
🏗️ Architecture
src/index.ts– entrypoint; merges tool maps and registers them withMcpServer.src/tools/– individual tool modules, each exporting{ tools, description }.src/cloudflare-client.ts– thin wrapper around axios + CF API base URL.tests/– Jest tests (unit + integration).
The server communicates over STDIO using JSON-RPC 2.0 as defined by the MCP SDK. See docs/API.md.
🤝 Contributing
PRs & issues are welcome! Please read REFERENCE.md for coding conventions and style guidelines.
Fork → feature branch → PR.
Ensure
npm testpasses.Describe the tool behaviour or bug clearly.
📜 License
MIT © 2025 Jeff Golden
Made with Windsurf
Available Tools
18 toolscloudflare-dns-mcp_create_dns_recordC
Create a new DNS record in a given zone
Inputs: content (required), name (required), type (required), zone_name (required), +6 more.
cloudflare-dns-mcp_create_redirectC
Create a single URL redirect (Page Rule) for the given zone
Inputs: source_url (required), target_url (required), zone_name (required), preserve_query_string, +3 more.
cloudflare-dns-mcp_create_security_ruleC
Create a custom firewall security rule for a zone
Inputs: action (required), expression (required), rule_name (required), zone_name (required), +2 more.
cloudflare-dns-mcp_delete_dns_recordC
Delete a DNS record by ID
Inputs: record_id (required), zone_name (required).
cloudflare-dns-mcp_delete_page_ruleC
Delete a page rule by ID
Inputs: rule_id (required), zone_name (required).
cloudflare-dns-mcp_delete_security_ruleC
Delete a firewall security rule
Inputs: rule_id (required), zone_name (required).
cloudflare-dns-mcp_echoB
Simple connectivity check that returns the same payload sent by the client.
Inputs: message.
cloudflare-dns-mcp_get_zone_settingsC
Get full settings object for a zone
Inputs: zone_name (required).
cloudflare-dns-mcp_list_dns_recordsC
List DNS records for a zone or across all zones
Inputs: include_metadata, name_filter, record_type, zone_name.
cloudflare-dns-mcp_list_page_rulesC
List all page rules (redirects) for a zone
Inputs: zone_name (required), status.
cloudflare-dns-mcp_list_ssl_certsC
List SSL certificate packs for a zone
Inputs: zone_name (required).
cloudflare-dns-mcp_list_waf_rulesC
List Web Application Firewall (WAF) rules for a zone
Inputs: zone_name (required), rule_type.
cloudflare-dns-mcp_list_zonesC
List all zones in the account
Inputs: include_details, status_filter.
cloudflare-dns-mcp_list_zone_settingsC
Retrieve all settings for a specific zone
Inputs: zone_name (required).
cloudflare-dns-mcp_purge_cacheC
Purge Cloudflare cache for a zone
Inputs: zone_name (required), purge_type, targets.
cloudflare-dns-mcp_update_dns_recordC
Update an existing DNS record by ID
Inputs: record_id (required), zone_name (required), content, name, +7 more.
cloudflare-dns-mcp_update_security_ruleC
Update an existing firewall security rule
Inputs: rule_id (required), zone_name (required), action, description, +3 more.
cloudflare-dns-mcp_update_zone_settingsB
Update settings for a zone (destructive operation)
Inputs: settings (required), zone_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools have clear, distinct purposes targeting specific Cloudflare resources like DNS records, page rules, security rules, zones, SSL certificates, WAF rules, and cache. However, 'list_zone_settings' and 'get_zone_settings' appear redundant, as both seem to retrieve zone settings, which could cause confusion. Otherwise, the overlap is minimal.
Tool names follow a highly consistent pattern with the prefix 'cloudflare-dns-mcp_' and a clear verb_noun structure (e.g., create_dns_record, list_zones, update_zone_settings). All tools use snake_case uniformly, making them predictable and easy to parse for an agent.
With 18 tools, the count is slightly high but reasonable for a Cloudflare server covering DNS, security, caching, and zone management. It provides comprehensive coverage without being overwhelming, though it borders on the heavier side for typical MCP scopes.
The tool set offers strong coverage for core Cloudflare operations, including CRUD for DNS records, security rules, and page rules, along with listing zones, SSL certs, WAF rules, and cache management. Minor gaps include no update for page rules or SSL certs, and the echo tool feels out of place, but agents can work around these.
Related MCP Connectors
Manage hosts, redirects, SSL, and traffic analytics from Claude and other AI assistants.
Zero-dependency Cloudflare Worker gateway turning websites and REST APIs into MCP tools.
29 DNS, SEO, SSL, security, WHOIS & mail tools for AI agents. Pay per call (x402) or card API key.
The bridge from K2 agents through Wrangler to your master AI - safe, approval-gated Cloudflare ops.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to manage Cloudflare resources through natural language, including DNS records, zone management, Workers KV storage, cache purging, and analytics. Supports comprehensive Cloudflare operations with secure API token authentication.132MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Cloudflare infrastructure including DNS records, cache purging, SSL settings, Workers, and analytics through the Cloudflare API. Eliminates dashboard context-switching by allowing natural language control of domain management and infrastructure operations.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Cloudflare REST API for managing DNS records, zones, and other Cloudflare resources.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage Cloudflare DNS records, including listing zones and records, and creating, updating, or deleting DNS records.681 npmMIT