How to integrate Cloudflare MCP with Pi

Connect Pi 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.

171 Tools

Introduction

Pi is a minimal, self-extensible coding agent that lives in your terminal — one agent loop over Claude, GPT-5, Gemini, Grok, DeepSeek, and 20+ other providers, with maximum extension surface and minimum product opinion. Its core ships four tools (read, write, edit, bash) and self-extends at runtime through skills, extensions, and packages.

This guide explains the easiest and most robust way to connect your Cloudflare account to Pi. You can do this through either Composio Connect CLI or Composio Connect MCP. Because Pi already runs shell commands as first-class tools and ships no built-in MCP, the CLI is the recommended path — it's faster to set up, needs no server config, and chains multi-step tasks more reliably. The MCP path is also fully supported through Pi's official pi-mcp-adapter extension.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Cloudflare with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Pi. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Connect Cloudflare to Pi with Composio

Prerequisites: Install Pi

Pi needs Node.js 18+ (Node 22 recommended). Install the agent globally with npm:

bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

On Linux or macOS you can use the installer script instead:

bash
curl -fsSL https://pi.dev/install.sh | sh

Then run pi in any project directory and authenticate your model provider — use /login inside Pi for subscription providers (Claude Pro/Max, ChatGPT, GitHub Copilot), or set an API key such as ANTHROPIC_API_KEY before starting. Confirm it's working:

bash
pi --version

Full first-run details are in the Pi Quickstart.

Option 1: Composio CLI (recommended)

Pi runs shell commands as first-class tools, so the Composio Universal CLI is the most natural fit — no MCP server to configure and reliable multi-step tool chaining. Install and authenticate:

bash
# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Log in to Composio
composio login

Connect to Cloudflare

Ask Pi to connect to Cloudflare, or simply request any Cloudflare-related task. Under the hood Pi calls Composio commands like any other shell tool:

bash
composio search "what can I do with Cloudflare?"
composio link cloudflare

On the first Cloudflare call, composio link cloudflare opens an OAuth prompt so you can authorize access. After that, every Cloudflare command works with your stored credentials automatically — just talk to Pi and it will search, execute, and chain Cloudflare tools as needed.

Option 2: Composio MCP

Pi's core intentionally ships no built-in MCP, but the official pi-mcp-adapter extension adds full MCP support — exposing every server through a single lightweight proxy tool (~200 tokens) instead of loading hundreds of tool definitions into context.

1. Install the MCP adapter extension

bash
pi install npm:pi-mcp-adapter

Restart Pi after installation.

2. Add the Composio MCP server

Create (or edit) a .mcp.json file in your project root, or ~/.config/mcp/mcp.json for a user-global setup:

bash
{
  "mcpServers": {
    "composio": {
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

The adapter connects lazily by default — the server won't start until Pi actually calls one of its tools, and cached metadata keeps search and describe working without a live connection.

3. Authenticate

Run /mcp-auth inside Pi to open the authentication modal and select composio from the list. Complete the sign-in in your browser, then on the consent screen click Allow access to authorize Composio. Once approved, the server shows as connected inside Pi:

Pi /mcp-auth modal listing the composio MCP server
Composio OAuth consent screen with the Allow access button
Composio MCP server connected inside Pi

4. Done!

Confirm the server is live with /mcp to open the interactive panel, then ask Pi to connect to Cloudflare or request any Cloudflare-related task — it will prompt you to authorize Cloudflare on first use.

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.

Way Forward

With Cloudflare connected, Pi can now act on your behalf whenever you ask it to.

From here, you can extend Pi further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Pi can do for you.
  • Build workflows across tools: Once multiple apps are connected, Pi can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Lean into Pi's extension surface: Wrap common Cloudflare flows as Pi skills or prompt templates so recurring tasks become one-line commands, and use directTools in the MCP adapter to promote your most-used Cloudflare tools into Pi's tool list directly.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

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

Add Pages Project Domain

Attach a custom domain to a Cloudflare Pages project.

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.

Configure Email Routing DNS

Enable Email Routing and add and lock its required MX and SPF records.

Create Access Application

Create an account-scoped Cloudflare Access application.

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 R2 Bucket

Create an R2 bucket with optional placement and storage settings.

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 Build Trigger

Create a repository-backed Workers build trigger.

Create Worker Deployment

Deploy existing Worker versions immediately to live traffic by percentage.

Create Worker Route

Create a URL pattern route for a Cloudflare Worker.

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.

Create Zone Ruleset

Create a ruleset at the zone level.

Delete Access Application

Permanently delete one account-scoped Cloudflare Access application.

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.

Export DNS Records

Export up to 5,000,000 stored DNS records as a downloadable BIND file.

Get Access Application

Retrieve one Cloudflare Access application by its exact application ID.

Get Access Reusable Policy

Retrieve one reusable Cloudflare Access policy by its policy UUID.

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 Email Routing Catch-All Rule

Retrieve a zone's Email Routing catch-all rule and enabled state.

Get Email Routing Settings

Retrieve Email Routing configuration and status for a Cloudflare zone.

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 Portal

Retrieve one Access AI Controls MCP portal and its configured servers.

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 Project Domain

Return one custom domain's configuration and validation status.

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 Bucket Lock

Return the object-lock rules configured for an R2 bucket.

Get R2 Managed Domain

Retrieve the managed r2.dev domain configuration for an R2 bucket.

Get R2 Object

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

Get SSL Verification

Retrieve SSL verification details and optionally retry verification immediately.

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.dev and preview URL availability for a Worker script.

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.dev subdomain configured for a Cloudflare account.

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 Zaraz Configuration

Retrieve the latest preview or published Zaraz configuration for a zone; secret variable values are excluded.

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 DNSSEC

Retrieve DNSSEC status and key configuration for a Cloudflare zone.

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.

Inspect Zone Rulesets

List a zone's rulesets, or retrieve one complete ruleset by identifier.

Inventory Developer Resources

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

List Access Application Policies

List policies attached to one Cloudflare Access application.

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 Email Routing Rules

List one page of Email Routing rules configured for a Cloudflare zone.

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 Page Rules

List Page Rules configured for a Cloudflare zone.

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 Buckets

List and filter R2 buckets in 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 Zaraz Configuration History

List one offset/limit window of published Zaraz configuration history for a Cloudflare zone.

List Zones

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

List Zone Settings

List all settings available for a Cloudflare zone.

Manage Worker Schedules

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

Manage Zone Ruleset Rule

Create a rule in a zone ruleset or update one selected rule.

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.

Replace Zaraz Configuration

Replace a zone's complete Zaraz configuration.

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 Page Speed Test

Start a Cloudflare Observatory page speed test in a selected region.

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.

Start Worker Build

Start a Workers CI run that executes the trigger's configured build and deploy commands and may deploy the Worker.

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 Email Routing Catch-All Rule

Configure forwarding, dropping, or Worker handling for unmatched routed email.

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

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.

Update Zone Setting

Update one Cloudflare zone setting using its value or enabled request form.

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

Start with Cloudflare.It takes 30 seconds.

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

Start building