Back to Codex
Cloud Services·
advanced
·10 min read·Apr 4, 2026

How to Use the Cloudflare MCP Server for Edge Infrastructure

Manage Cloudflare Workers, KV stores, R2 buckets, and DNS settings through your AI agent using the Cloudflare MCP server.

CloudflareWorkersedge computingDNSKV storeR2

Use the Cloudflare MCP Server

The Cloudflare MCP server provides AI agents with access to Cloudflare's platform, including Workers, KV, R2, D1, and DNS management.

Prerequisites

  • Cloudflare account
  • API Token with appropriate permissions
  • Node.js 18+

Creating a Cloudflare API Token

  1. Go to Cloudflare Dashboard → My Profile → API Tokens
  2. Click Create Token
  3. Use a template or create custom with needed permissions:
    • Workers Scripts: Edit
    • Workers KV Storage: Edit
    • Workers R2 Storage: Edit
    • Zone DNS: Edit (if managing DNS)
  4. Copy the generated token

Configuration

json
{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "@cloudflare/mcp-server-cloudflare"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your_api_token",
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

Available Tools

Workers

  • code
    list_workers
    — List all Workers scripts
  • code
    get_worker
    — Read Worker code
  • code
    create_worker
    /
    code
    update_worker
    — Deploy Worker scripts
  • code
    delete_worker
    — Remove Workers

KV Store

  • code
    list_kv_namespaces
    — List KV namespaces
  • code
    get_kv_value
    — Read values
  • code
    put_kv_value
    — Write values
  • code
    list_kv_keys
    — List keys in a namespace

R2 Storage

  • code
    list_r2_buckets
    — List R2 buckets
  • code
    list_r2_objects
    — List objects in buckets
  • code
    get_r2_object
    — Read objects
  • code
    put_r2_object
    — Upload objects

DNS

  • code
    list_zones
    — List DNS zones
  • code
    list_dns_records
    — List DNS records
  • code
    create_dns_record
    — Add DNS records
  • code
    update_dns_record
    — Modify DNS records

Example Workflows

Worker Deployment

code
"Create a new Cloudflare Worker that redirects /old-page to /new-page and deploy it"

KV Data Management

code
"List all keys in the 'user-preferences' KV namespace and show the values for admin users"

DNS Management

code
"Add a CNAME record pointing blog.example.com to my-blog.netlify.app"

Tips

  • Use separate API tokens for different permission levels
  • Test Worker changes in a staging environment first
  • The AI can help write and debug Worker scripts