Skip to main content
Glama

mcp-cloudflare-dns

Cloudflare DNS MCP server for operators who need zone, record, cache, and page-rule control from an MCP client without opening the Cloudflare dashboard for every change.

Release posture: beta package, version 0.1.1 from pyproject.toml.

Choose your path

You are...

Start here

Then

Installing the server in Claude/Codex/Cursor

docs/start-here.md

Quick start below

Verifying what the server can touch

Available tools

docs/architecture.md

Auditing packaging or release metadata

pyproject.toml

server.json

Related MCP server: cloudflare-dns-mcp-server

Architecture

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  E[CF_API_TOKEN] --> S
  S --> T[Tool handlers]
  T --> R[Retry wrapper]
  R --> A[Cloudflare API]
  A --> R --> T --> C

Request flow

flowchart TD
  Q[Operator asks for a DNS change] --> H[Selected MCP tool]
  H --> I[Load token and build client]
  I --> J{Cloudflare call succeeds?}
  J -- yes --> K[Return normalized JSON result]
  J -- retryable --> L[Backoff and retry]
  L --> J
  J -- no --> M[Return error payload]

Quick start

  1. Install the package.

python -m pip install mcp-cloudflare-dns
  1. Export a token with DNS permissions.

export CF_API_TOKEN="your-cloudflare-api-token"
  1. Register it in your MCP client.

{
  "mcpServers": {
    "cloudflare-dns": {
      "command": "uvx",
      "args": ["mcp-cloudflare-dns"],
      "env": {
        "CF_API_TOKEN": "your-cloudflare-api-token"
      }
    }
  }
}

Available tools

Tool group

Tools

Purpose

Zone inventory

list_zones, get_zone, get_zone_settings

Inspect available zones and key settings

DNS records

list_dns_records, get_dns_record, create_dns_record, update_dns_record, delete_dns_record

Read and mutate records

Edge actions

purge_cache, list_page_rules

Invalidate cached content and inspect page rules

delete_dns_record and full-cache actions stay gated behind the destructive env flags described in docs/start-here.md.

Runtime proof

Claim

Proof

Package entry point is stable

mcp-cloudflare-dns = "cf.server:main" in pyproject.toml

Server is MCP-specific, not a generic CLI

FastMCP("mcp-cloudflare-dns") in cf/server.py

Cloudflare failures are retried

_call() in cf/server.py

Release artifacts are built

dist/ wheel and tarball are checked into the repo

Repo map

Path

Purpose

cf/server.py

FastMCP tool surface, env loading, retry wrapper

pyproject.toml

Package metadata, version, script entry point

server.json

Registry-facing metadata for MCP discovery

docs/start-here.md

Setup, env, validation, common failures

docs/architecture.md

Component map and request lifecycle

Validation

Check

Command

Import compiles

python -m compileall cf

Package builds

python -m build

README links stay local

rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

License

MIT

Project context for new tasks

Use INDEX.md to find task-specific contracts; consult prompt.md when product direction is relevant. Historical examples do not select the current task.

Available Tools

10 tools
create_dns_recordCreate Dns RecordC

Create a new DNS record.

Inputs: name (required), content (required), zone_id (required), record_type (required), +4 more. Returns: object

delete_dns_recordDelete Dns RecordA

Delete a DNS record. Requires CF_ALLOW_DESTRUCTIVE=true.

Inputs: zone_id (required), record_id (required). Returns: object

get_dns_recordGet Dns RecordA

Get a specific DNS record by zone ID and record ID.

Inputs: zone_id (required), record_id (required). Returns: object

get_zoneGet ZoneA

Get details for a specific Cloudflare zone by ID.

Inputs: zone_id (required). Returns: object

get_zone_settingsGet Zone SettingsA

Get key security and performance settings for a zone. Returns SSL mode, security level, minification, always-https, brotli, etc.

Inputs: zone_id (required). Returns: object

list_dns_recordsList Dns RecordsC

List DNS records for a zone.

Inputs: zone_id (required), name, record_type. Returns: result

list_page_rulesList Page RulesB

List page rules for a zone.

Inputs: zone_id (required), status. Returns: result

list_zonesList ZonesB

List all Cloudflare zones on this account.

Inputs: name_filter. Returns: result

purge_cachePurge CacheC

Purge Cloudflare cache for a zone.

Inputs: zone_id (required), urls, purge_everything. Returns: object

update_dns_recordUpdate Dns RecordA

Update an existing DNS record. Only the fields you provide will be changed.

Inputs: zone_id (required), record_id (required), ttl, comment, +2 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: zones, DNS records, zone settings, cache, and page rules are clearly separated. The DNS record tools follow a standard CRUD split with no ambiguity between get/list/create/update/delete.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (list_, get_, create_, update_, delete_, purge_). This makes the toolset predictable and easy to reason about.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its purpose. Each tool covers a meaningful operation without redundancy or excessive granularity.

    Completeness4/5

    DNS record management is fully covered with create, read, update, and delete operations. Zone lookup and settings read are present, but zone settings cannot be updated and page rules only support listing, leaving minor workflow gaps.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A token-efficient MCP server for managing Cloudflare DNS zones and records with full CRUD support and bulk operations. It can be deployed locally via stdio or as a Cloudflare Worker for remote HTTP access.
      -
    • A
      license
      C
      quality
      D
      maintenance
      A high-performance MCP server providing AI assistants with read-only access to the Cloudflare ecosystem. Query your entire Cloudflare infrastructure using natural language through Claude, Cursor, or any MCP-compatible client.
      390
      5
      MIT