How to integrate Cloudflare api key MCP with Pi

Connect Pi to Cloudflare api key MCP. Add new a record to your dns zone, delete outdated cname record from domain, and more using natural language, with authentication handled for you.

Cloudflare api key logoCloudflare api key
Api Key

Cloudflare is a leading platform for website security, performance, and reliability. It helps protect and optimize your web infrastructure with robust API access.

103 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 api key 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 api key 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 api key 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 api key

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

bash
composio search "what can I do with Cloudflare api key?"
composio link cloudflare_api_key

On the first Cloudflare api key call, composio link cloudflare_api_key opens an OAuth prompt so you can authorize access. After that, every Cloudflare api key command works with your stored credentials automatically — just talk to Pi and it will search, execute, and chain Cloudflare api key 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 api key or request any Cloudflare api key-related task — it will prompt you to authorize Cloudflare api key on first use.

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

The Cloudflare api key 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 services, so your agent can create DNS records, manage security rules, delete zones, and automate zone configurations on your behalf.

  • Automated DNS record management: Instantly create, update, or delete DNS records—including A, CNAME, TXT, and MX types—across your Cloudflare zones to keep your domains running smoothly.
  • Zone lockdown and security automation: Add or remove Zone Lockdown rules to restrict access to specific URLs and IP ranges, helping you enforce security policies without manual intervention.
  • Ruleset creation and maintenance: Direct your agent to create new rulesets or modify existing ones, ensuring your web applications remain secure and compliant with evolving access requirements.
  • Comprehensive zone administration: Effortlessly delete entire zones or DNSSEC configurations for streamlined domain management and cleanup when needed.
  • Versioned ruleset management: Retrieve specific versions of entry point rulesets, giving you granular control and auditability over your security configurations.

Way Forward

With Cloudflare api key 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 api key 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 api key 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 api key action and event your agent gets out of the box.

Attach Worker Domain

Attach or update a custom hostname routed to a Cloudflare Worker.

Bulk Read KV Values

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

Configure Email Routing DNS

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

Create Access Application

Create a bookmark or self-hosted app with focused common settings.

Create Access Application Policy

Create a deprecated application-scoped inline Access policy.

Create Access Reusable Policy

Create an account-level reusable Cloudflare Access policy.

Create Account Token

Create an account token and return its secret value exactly once.

Create AI Chat Completion

Create an OpenAI-compatible Workers AI chat completion as one JSON response.

Create DNS Record

Tool to create a new DNS record in a Cloudflare zone.

Create Email Routing Rule

Create an Email Routing rule for a Cloudflare zone.

Create Zone Lockdown Rule

Tool to create a Zone Lockdown rule.

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 Temporary Credentials

Issue sensitive, short-lived R2 credentials; never log or persist them.

Create Rule in Ruleset

Tool to add a rule to an existing ruleset.

Create Ruleset

Creates a new Cloudflare ruleset at account or zone scope.

Create Turnstile Widget

Create a Turnstile widget and return its sitekey and sensitive verification secret.

Create Worker Deployment

Deploy existing Worker versions to live traffic by percentage.

Create Worker Version

Upload code, assets, and configuration as a new Worker version, optionally deploying it to 100% of traffic.

Create Zone

Create a pending Cloudflare zone; activation requires nameserver or partial-zone verification.

Delete Access Reusable Policy

Permanently delete one account-level reusable Cloudflare Access policy.

Delete DNS Record

Tool to delete a DNS record.

Delete DNSSEC

Tool to delete DNSSEC records for a zone.

Delete R2 Object

Permanently delete one R2 object by its complete key; this cannot be undone.

Delete Rule from Ruleset

Tool to delete a specific rule from a ruleset.

Delete Ruleset

Tool to delete all versions of a ruleset.

Delete a zone

Tool to delete an existing zone.

Deploy Worker Script

Use the deprecated legacy path to upload and immediately deploy one JavaScript module Worker script.

Execute D1 Query

Execute SQL against one Cloudflare D1 database.

Export DNS Records

Export a zone's matching DNS records as a BIND zone file.

Extract Data with Clairic

Extract typed values and calibrated estimates from text or embedded images.

Get Access Application

Retrieve one Cloudflare Access application by identifier.

Get Account Token

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

Get Cloudflare IP Addresses

Tool to retrieve IP addresses used on the Cloudflare or JD Cloud network.

Get DNSSEC

Retrieve a zone's DNSSEC status and signing details.

Get Email Routing Settings

Retrieve a zone's Cloudflare Email Routing configuration and enabled status.

Get Email Routing Setup

Inspect a zone's required Email Routing DNS records and catch-all rule.

Get Entrypoint Ruleset

Fetch the latest account redirect-phase entrypoint ruleset.

Get Entrypoint Ruleset Version

Retrieves a specific historical version of an entry point ruleset from Cloudflare.

Get KV Namespace

Retrieve metadata for one Cloudflare Workers KV namespace.

Get KV Value

Retrieve one Workers KV value as decoded text or base64 binary content.

Get Lockdown Rule

Tool to get a Zone Lockdown rule.

Get Pages Deployment

Retrieve one Cloudflare Pages deployment by UUID.

Get Pages Deployment Logs

Retrieve build log lines for one Cloudflare Pages deployment.

Get Pages Project

Retrieve one Cloudflare Pages project and its complete configuration.

Get Pages Project Domain

Retrieve one named custom domain from a Cloudflare Pages project.

Get Pages Upload Token

Return a sensitive short-lived JWT for Pages Direct Upload; do not log or persist it.

Get R2 Object

Downloads an object's stored content and metadata from a Cloudflare R2 bucket.

Get Regional Tiered Cache

Tool to get the regional tiered cache setting for a zone.

Get Ruleset

Tool to fetch the latest version of a ruleset by ID.

Get Turnstile Widget

Retrieve one Turnstile widget, including its sensitive verification secret.

Get User API Token

Retrieve metadata, policies, permissions, and status for one user token.

Get Worker Build

Retrieve status and source metadata for one Workers CI build.

Get Worker Schedules

Get the Cron Triggers configured for one Worker script.

Get Worker Script Content

Retrieve the deployed content of one Cloudflare Worker script.

Get Worker Script and Version 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 Workers Subdomain

Return the workers.dev subdomain configured for a Cloudflare account.

Get Worker Subdomain And Schedules

Read a Worker's workers.dev subdomain routing and cron schedules.

Get Worker Version

Retrieve one beta Worker version, optionally including module content.

Get Zone Details

Tool to get details for a specific zone.

Get Zone Setting

Retrieve one named Cloudflare zone setting, such as browser_cache_ttl.

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 Accounts

List accounts accessible to the credential for downstream account operations.

List Account Subscriptions

List billing subscriptions and plan details for one Cloudflare account.

List Account Tokens

List account-owned API tokens for inventory and lifecycle operations.

List Alert Policies

List notification policies configured for a Cloudflare account.

List D1 Databases

List one page of D1 databases in a Cloudflare account.

List DNS Records

List, search, sort, and filter DNS records for a Cloudflare zone.

List Email Routing Destination Addresses

List and filter Email Routing destination addresses for an account.

List Email Routing Rules

List and filter Email Routing rules configured for a Cloudflare zone.

List KV Keys

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

List Page Rules

List Page Rules for a zone; the legacy product is deprecated, not removed.

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 validation state.

List Pages Projects

List Cloudflare Pages projects in an account with page-based pagination.

List R2 Buckets

List and filter R2 buckets in a Cloudflare account.

List R2 Objects

List object metadata and keys in an R2 bucket with cursor pagination.

List Web Analytics Sites

List one page of Web Analytics site configurations for an account.

List Worker Build Triggers

List repository build triggers configured for a Worker external script ID.

List Worker Deployments

List deployment history for a classic Worker; the first result is active.

List Worker Domains

List custom domains routed to Workers in a Cloudflare account.

List Worker Routes

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

List Worker Scripts

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

List Worker Secrets

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

List Zone Certificate Packs

List one page of a zone's certificate packs, with status and deployment filters.

List Zone Rulesets

List a zone's rulesets and their identifiers, phases, and versions.

List Cloudflare Zones

Tool to list, search, sort, and filter Cloudflare zones.

Overwrite DNS Record

Overwrites a DNS record in a Cloudflare zone using the supported record fields, including type, name, content, TTL, proxy status, comments, tags, and settings.

Query Cloudflare GraphQL

Execute a Cloudflare GraphQL query using its dataset-specific token permissions.

Rerun Zone Activation Check

Triggers a new activation check for a zone with 'pending' status.

Run Workers AI Model

Run a selected Workers AI model with model-specific JSON input.

Update DNSSEC Status

Tool to update DNSSEC configuration for a zone.

Update Lockdown Rule

Updates a Zone Lockdown rule in a Cloudflare zone, supplying both the allowed IP addresses or CIDR ranges and the URL patterns.

Update Pages Project

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

Update Rule in Ruleset

Tool to update a specific rule in a ruleset.

Update Ruleset

Update a Cloudflare ruleset, creating a new version.

Update Cloudflare Zone

Tool to edit a Cloudflare zone.

Upload File to S3

Upload UTF-8 encoded text content to temporary storage for staging files used by actions requiring FileUploadable.

Upload Pages Assets

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

Upload R2 Object

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

FAQ

Frequently asked questions

Start with Cloudflare api key.It takes 30 seconds.

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

Start building