Skip to main content
Glama
Cloudflare MCP Server

Cloudflare MCP Server

by jeffgolden

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-detect

Need a sandbox? Cloudflare Workers Free Plan lets you create test zones.


🛠️ Tool Catalog

Category

Tool Name

Description

General

echo

Round-trip text for connectivity testing

Zones

list_zones

Enumerate zones the token can access

Zones

get_zone_settings

Return full settings object

Zones

list_zone_settings

Short settings summary

DNS

list_dns_records

Read all DNS RRsets

DNS

create_dns_record*

Add a record

DNS

update_dns_record*

Modify record

DNS

delete_dns_record*

Remove record

Security

list_waf_rules

Read firewall rules

Security

create_security_rule*

Add firewall rule

Security

update_security_rule*

Edit firewall rule

Security

delete_security_rule*

Delete firewall rule

Redirect

list_page_rules

List redirects/page-rules

Redirect

create_redirect*

Create redirect

Redirect

delete_page_rule*

Delete redirect

Cache

purge_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 lint

Handy 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 with McpServer.

  • 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.

  1. Fork → feature branch → PR.

  2. Ensure npm test passes.

  3. Describe the tool behaviour or bug clearly.


📜 License

MIT © 2025 Jeff Golden

Made with Windsurf

Available Tools

18 tools
cloudflare-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

    B3.2/5.0

    Scored across 18 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      13
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -