How to integrate Cloudflare MCP with Claude Agent SDK

Connect Claude Agent SDK to Cloudflare MCP. Add new a record for your domain, list all firewall rules for zone, and more using natural language, with authentication handled for you.

Cloudflare logoCloudflare
Api Key

Cloudflare is a global network that secures and accelerates web traffic. It helps protect your sites and APIs from attacks while ensuring reliable performance.

139 Tools

Introduction

This guide walks you through connecting Cloudflare to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Cloudflare agent that can manage DNS records and zones, deploy Workers and Pages, query D1 databases, store KV data, and run analytics queries through natural language commands.

This guide will help you understand how to give your Claude Agent SDK agent real control over a Cloudflare account through Composio's Cloudflare MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Cloudflare with

TL;DR

Here's what you'll learn:
  • Get and set up your Claude/Anthropic and Composio API keys
  • Install the necessary dependencies
  • Initialize Composio and create a Tool Router session for Cloudflare
  • Configure an AI agent that can use Cloudflare as a tool
  • Run a live chat session where you can ask the agent to perform Cloudflare operations

What is Claude Agent SDK?

The Claude Agent SDK is Anthropic's official framework for building AI agents powered by Claude. It provides a streamlined interface for creating agents with MCP tool support and conversation management.

Key features include:

  • Native MCP Support: Built-in support for Model Context Protocol servers
  • Permission Modes: Control tool execution permissions
  • Streaming Responses: Real-time response streaming for interactive applications
  • Context Manager: Clean async context management for sessions

What is the Cloudflare MCP server, and what's possible with it?

The Cloudflare MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Cloudflare account. It provides structured and secure access to your Cloudflare infrastructure, so your agent can perform actions like managing DNS records, configuring WAF lists, auditing firewall rules, and overseeing zones and account members—all on your behalf.

  • DNS record management: Effortlessly create or delete DNS records within any zone, allowing your agent to automate domain setup and maintenance tasks.
  • WAF list and firewall rule automation: Direct your agent to create, list, or delete Web Application Firewall (WAF) lists and audit firewall rules to enhance your site's security posture.
  • Zone administration: Enable your agent to create new zones when adding domains or delete zones that are no longer needed, streamlining domain onboarding and cleanup.
  • Account and member management: Let your agent list all Cloudflare accounts you have access to and enumerate members within each account for audit or collaboration purposes.
  • Comprehensive infrastructure visibility: Ask your agent to fetch and review your entire Cloudflare account structure, making it simple to monitor resources and configurations at scale.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Composio API Key and Claude/Anthropic API Key
  • Primary know-how of Claude Agents SDK
  • A Cloudflare account
  • Some knowledge of Python
2

Getting API Keys for Claude/Anthropic and Composio

Claude/Anthropic API Key
  • Go to the Anthropic Console and create an API key. You'll need credits to use the models.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install dependencies

npm install @anthropic-ai/claude-agent-sdk @composio/core dotenv

Install the Composio SDK and the Claude Agents SDK.

What's happening:

  • @composio/core provides Composio integration for Anthropic
  • @anthropic-ai/claude-agent-sdk is the core agent framework
  • dotenv/config loads environment variables
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates with Composio
  • USER_ID identifies the user for session management
  • ANTHROPIC_API_KEY authenticates with Anthropic/Claude
5

Import dependencies

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

dotenv.config();
What's happening:
  • We're importing all necessary libraries including the Claude Agent SDK and Composio
  • The dotenv.config() function loads environment variables from your .env file
  • This setup prepares the foundation for connecting Claude with Cloudflare functionality
6

Create a Composio instance and Tool Router session

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });

  // Create Tool Router session for Cloudflare
  const session = await composio.create(USER_ID, {
    toolkits: ['cloudflare'],
  });
  const mcpUrl = session?.mcp.url;
What's happening:
  • The function checks for the required COMPOSIO_API_KEY environment variable
  • We're creating a Composio instance using our API key
  • The create method creates a Tool Router session for Cloudflare
  • The returned url is the MCP server URL that your agent will use
7

Configure Claude Agent with MCP

const options: Options = {
  permissionMode: 'bypassPermissions',
  mcpServers: {
    composio: {
      type: 'http',
      url: mcpUrl,
      headers: { 'x-api-key': COMPOSIO_API_KEY }
    }
  },
  systemPrompt: 'You are a helpful assistant with access to Cloudflare tools via Composio.',
  maxTurns: 10,
};
What's happening:
  • We're configuring the Claude Agent options with the MCP server URL
  • permissionMode: 'bypassPermissions' allows the agent to execute operations without asking for permission each time
  • The system prompt instructs the agent that it has access to Cloudflare
  • maxTurns: 10 limits the conversation length to prevent excessive API usage
8

Create client and start chat loop

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}
What's happening:
  • The readline interface is created to handle user input and output
  • The query function is used to send the user's input to the agent
  • The chat loop continues until the user types 'exit' or 'quit'
9

Run the application

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}
What's happening:
  • The chat function is the entry point for the application
  • The try-catch block is used to handle any errors that occur

Complete Code

Here's the complete code to get you started with Cloudflare and Claude Agent SDK:

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });
  const session = await composio.create(USER_ID, {
    toolkits: ['cloudflare']
  });
  const mcp_url = session?.mcp.url;

  const options: Options = {
    permissionMode: 'bypassPermissions',
    mcpServers: {
      composio: {
        type: 'http',
        url: mcp_url,
        headers: { 'x-api-key': COMPOSIO_API_KEY }
      }
    },
    systemPrompt: 'You are a helpful assistant with access to Cloudflare tools via Composio.',
    maxTurns: 10,
  };

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}

Conclusion

You've successfully built a Claude Agent SDK agent that can interact with Cloudflare through Composio's Tool Router.

Key features:

  • Native MCP support through Claude's agent framework
  • Streaming responses for real-time interaction
  • Permission bypass for smooth automated workflows
You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.
TOOLS

Supported Tools

Every Cloudflare action and event your agent gets out of the box.

Bulk Read KV Values

Read up to 100 text or JSON values from a Workers KV namespace.

Bulk Write Workers KV Entries

Create or overwrite up to 10,000 entries in one Workers KV namespace.

Cancel Worker Build

Cancel a queued or running Cloudflare Workers CI build.

Capture Browser Snapshot

Render a URL or supplied HTML and return selected page representations.

Check Registrar Domains

Check authoritative registration availability and pricing for up to 20 domains.

Create Account API Token

Create an account-owned API token and return its one-time secret value.

Create Alert Policy

Create an account-level Cloudflare notification policy.

Create D1 Database

Create a D1 database with optional placement and replication settings.

Create DNS record

Tool to create a new DNS record within a specific zone.

Create Email Routing Address

Register an Email Routing destination; Cloudflare sends it a verification email.

Create KV Namespace

Create a classic or KV Instant namespace in a Cloudflare account.

Create WAF List

Create a new empty custom list for use in WAF rules and filters.

Create Pages Deployment

Create a Cloudflare Pages deployment from a Git branch or Direct Upload manifest.

Create Pages Project

Create a Cloudflare Pages project for a production branch.

Create Turnstile Widget

Create a Turnstile challenge widget for selected domains.

Create User API Token

Create a user API token carrying supplied grants.

Create Worker

Create a beta Worker resource and configure its observability, previews, subdomain, tags, and tail consumers.

Create Worker Deployment

Deploy existing Worker versions immediately to live traffic by percentage.

Create Worker Version

Upload code, assets, and configuration as a new Worker version without deploying it to production traffic.

Create Zone

Create a Cloudflare DNS zone for a domain, optionally specifying the account and zone setup mode.

Delete Account API Token

Permanently and irreversibly revoke an account-owned Cloudflare API token.

Delete DNS Record

Tool to delete a DNS record within a specific zone.

Delete WAF List

Tool to delete a WAF list.

Delete Pages Deployment

Delete a selected non-production Cloudflare Pages deployment.

Delete User API Token

Permanently revoke one user-owned Cloudflare API token.

Delete Worker

Permanently delete a beta Worker and its versions and deployments.

Delete Worker Script

Delete a classic Worker script.

Delete Zone

Tool to delete a zone.

Deploy Worker Script

Upload or replace a JavaScript module Worker script and create its latest version.

Deploy Worker With Assets

Upload static assets, create a Worker version, and deploy all traffic to it.

Download Worker Script

Download the raw source or multipart module bundle for a Worker script.

Execute D1 Query

Execute SQL against one Cloudflare D1 database.

Get Access Application

Retrieve one Cloudflare Access application by its exact application ID.

Get Account

Retrieve one Cloudflare account by its exact account ID.

Get Account Build Limits

Return whether an account has exhausted its Worker build minutes and when they refresh.

Get Account Member

Retrieve the identity, roles, policies, and status of an account member.

Get Account Token

Retrieve metadata and policies for one account-owned API token.

Get Bot Management Settings

Tool to retrieve a zone's Bot Management configuration (Bot Fight Mode / Super Bot Fight Mode / Enterprise Bot Management).

Get Current User

Retrieve identity and account-membership details for the current user.

Get D1 Database

Get details for one D1 database, optionally selecting response fields.

Get KV Namespace

Retrieve metadata for one Cloudflare Workers KV namespace.

Get KV Value

Retrieve a key's value from a Workers KV namespace.

List WAF Lists

Fetch WAF lists for a Cloudflare account without their items.

Get MCP Server

Retrieve one Access AI Controls MCP server and its synchronization state.

Get Pages Deployment

Retrieve one Cloudflare Pages deployment and its current build status.

Get Pages Deployment Logs

Retrieve build log lines for one Cloudflare Pages deployment.

Get Pages Project

Retrieve one Cloudflare Pages project and its configuration.

Get Pages Upload Token

Request a short-lived JWT for Cloudflare Pages Direct Upload assets.

Get R2 Bucket

Retrieve properties for one named Cloudflare R2 bucket.

Get R2 Object

Download an object's stored content and metadata from an R2 bucket.

Get Tunnel Configuration

Retrieve the current configuration of a remotely managed Cloudflare Tunnel.

Get User API Token

Retrieve metadata and policies for one user-owned API token.

Get Worker

Retrieve one beta Worker resource by its exact ID or name.

Get Worker Build Logs

Retrieve cursor-paginated log output for one Workers CI build.

Get Worker Preview Deployment

Retrieve a specific or latest deployment for a Worker Preview.

Get Workers AI Model Schema

Retrieve the input and output JSON Schemas for a Workers AI model.

Get Worker Script Content

Retrieve the deployed content of one Cloudflare Worker script.

Get Worker Script Settings

Retrieve a Worker script's metadata and runtime configuration.

Get Worker Script Subdomain

Inspect workers.

Get Worker Script Version

Retrieve detailed information for one classic Worker script version.

Get Worker Service Environment Content

Retrieve deployed content for a legacy Worker service environment.

Get Workers Subdomain

Return the workers.

Get Worker Version

Retrieve one beta Worker version; optional code modules may add megabytes.

Get Workflow

Retrieve one Workflow's configuration, metadata, schedules, and counts.

Get Workflow Instance

Retrieve logs, status, and execution details for one Workflow instance.

Get Zero Trust Organization

Retrieve the configuration of a Cloudflare Zero Trust organization.

Get Zone

Retrieve one Cloudflare zone and its configuration, status, and metadata.

Get Zone Ruleset Phase Entrypoint

Retrieve the latest active zone entrypoint ruleset for a Rulesets phase.

Get Zone Setting

Fetch one setting for a Cloudflare zone by setting name.

Inventory Developer Resources

Return one page each of KV namespaces, Workflows, and D1 databases.

List Access Applications

List and filter Cloudflare Access applications in an account.

List Access Reusable Policies

List reusable Cloudflare Access policies for an account.

List Account Members

List a page of Cloudflare account members with their user details, roles, permissions, status, and access policies when available.

List Accounts

List all Cloudflare accounts you have ownership or verified access to.

List Account Subscriptions

List billing subscriptions and plan details for one Cloudflare account.

List Account Tokens

List account-owned API token metadata and policies with pagination.

List D1 Databases

List one page of D1 databases in an account.

List DNS records

List and search one page of DNS records in a Cloudflare zone, including record IDs and properties.

List Email Routing Addresses

List one page of Email Routing destination addresses configured for an account, optionally filtering by verification status.

List Firewall Rules

List one page of firewall rules for a specific DNS zone for auditing.

List KV Keys

List key names and metadata in a Cloudflare Workers KV namespace.

List KV Namespaces

List Workers KV namespaces in a Cloudflare account.

List MCP Portals

List Cloudflare Access AI Controls MCP portals with pagination and search.

List Monitors

Tool to list all load-balancer monitors in a Cloudflare account.

List Pages Deployments

List production or preview deployments for a Cloudflare Pages project.

List Pages Project Domains

List custom domains attached to a Cloudflare Pages project, including their validation and verification state.

List Pages Projects

List Pages projects in a Cloudflare account.

List Pools

Tool to list all load balancer pools in a Cloudflare account.

List Queues

List queues owned by a Cloudflare account.

List R2 Objects

List object metadata in an R2 bucket with cursor pagination.

List Registrar Registrations

List domains registered through Cloudflare Registrar.

List Rule List Entries

List entries in one Cloudflare account rule list.

List Web Analytics Sites

List Cloudflare Web Analytics sites for an account.

List Tunnels

List Cloudflare Tunnel (cloudflared) tunnels in an account to discover tunnel IDs, names, and statuses.

List Turnstile Widgets

List Turnstile widgets configured for a Cloudflare account, returning widget summaries without secret keys.

List User API Tokens

List one page of metadata for API tokens created by the connected Cloudflare user without returning token secrets.

List Worker Builds

List one page of Workers CI builds associated with an immutable Worker tag.

List Worker Build Triggers

List Workers Builds trigger configurations associated with one Worker tag.

List Worker Deployments

List one page of deployment history for a classic Worker script.

List Worker Routes

List Worker route patterns and script assignments for a Cloudflare zone.

List Workers

List account Workers with optional sorting and page-based pagination.

List Workers Build Tokens

List Workers Builds authentication token metadata for an account, with optional pagination.

List Worker Scripts

List uploaded classic Worker scripts, optionally filtering by tag rules.

List Worker Script Versions

List classic Worker script versions, optionally filtering to deployable versions.

List Workers Domains

List custom domains routed to Workers in a Cloudflare account.

List Worker Secrets

List the names and types of secrets bound to one Worker script.

List Worker Telemetry Values

List unique values observed for a Workers telemetry field.

List Worker Versions

List paginated versions of a Cloudflare Worker.

List Workflow Instances

List Workflow executions with state, UTC date, and cursor filters.

List Workflows

List and search account Workflows.

List Zones

List, search, sort, and filter accessible Cloudflare zones.

Manage Worker Schedules

Get a Worker's Cron Triggers, or replace all triggers when schedules is supplied.

Query Analytics SQL

Execute a parameterized Cloudflare Analytics SQL SELECT statement.

Query GraphQL Analytics

Run a read-only query against Cloudflare's GraphQL Analytics API.

Query Worker Telemetry

Run a saved or ad-hoc Workers Observability telemetry query.

Replace Rules List Items

Replace every item in a Rules List and poll for the bulk operation outcome.

Rerun Zone Activation Check

Trigger a fresh activation check for a pending Cloudflare zone.

Roll Account Token

Irreversibly rotate an Account Owned API token secret.

Roll Back Pages Deployment

Promote a previous successful Pages deployment back to production.

Run Workers AI Model

Run a Workers AI model and return non-streaming JSON; streaming is unsupported.

Scrape Page Elements

Render a URL or supplied HTML and return elements matching CSS selectors.

Start Worker Asset Upload Session

Register a Worker static-asset manifest and return a one-hour JWT and hash buckets for later asset-upload calls; this action does not upload asset bytes.

Update Access Application

Replace one account-scoped Cloudflare Access application with a full PUT.

Update DNS record

Tool to update an existing DNS record within a specific zone.

Update WAF List

Tool to update the description of a WAF list (cannot update items).

Update Pages Project

Rename a Pages project or update its production branch, build configuration, deployment environments, or source repository settings.

Update Tunnel Configuration

Tool to update a remotely-managed Cloudflare Tunnel's configuration (ingress rules and routing).

Update Worker Build Trigger

Update commands, caching, and filters for a Workers build trigger.

Update Worker Preview Deployment

Create a new Preview deployment by merge-patching bindings or annotations on an existing Preview deployment.

Update Worker Script Settings

Patch Worker configuration and metadata, creating a new version.

Update Worker Script Subdomain

Enable or disable a Worker script and its previews on workers.

Update Zone

Tool to update properties of an existing zone; changes apply immediately to the live zone.

Update Zone Ruleset Phase Entrypoint

Replace a zone phase entrypoint ruleset.

Upload Pages Assets

Upload static assets and register their hashes for a Pages deployment.

Upload R2 Object

Upload binary content to an R2 key, replacing its content if it exists.

Upload Worker Assets

Upload one bucket of base64-encoded Worker static assets.

Upload Worker Script Version

Upload a module-syntax classic Worker version without deploying it.

Upsert Worker Secret

Add or replace one secret binding, creating a new Worker version.

Write KV Value

Create or replace a UTF-8 value in a Cloudflare Workers KV namespace.

FAQ

Frequently asked questions

With a standalone Cloudflare MCP server, the agents and LLMs can only access a fixed set of Cloudflare tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Cloudflare and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Agent SDK fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Cloudflare tools.

Yes, absolutely. You can configure which Cloudflare scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Cloudflare data and credentials are handled as safely as possible.

Start with Cloudflare.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cloudflare tool your agent needs.Free to start.

Start building