
Cloudflare MCP, Cloudflare's official MCP servers
Lets Claude, ChatGPT, Cursor and other AI assistants manage your Cloudflare account, like Workers, DNS and storage, and search Cloudflare's docs.
Use the main Cloudflare server at mcp.cloudflare.com. It reaches the whole Cloudflare API, so your assistant can list zones, edit DNS records or check a Worker. The single-product servers, such as Documentation, Browser Run and Container, are optional extras. It changes your live account, so approve only the permissions the job needs when you sign in.
Good for
- Developers who build and deploy on Cloudflare Workers and want their assistant to check and change settings
- Site owners who manage DNS, caching and security rules by asking in plain words
- Ops and platform teams who automate Cloudflare account work from CI with an API token
- Anyone writing Cloudflare code who wants current docs in the chat, no account needed
Works in
2 supported · 5 with issues · 7 should work
Tap an app to see how to set it up and any known problems.
Cloudflare's docs cover the plugin in the Cursor Marketplace, or adding the server URL to your MCP config. developers.cloudflare.com
Cloudflare's skills repo covers installing the plugin from the cloudflare/skills URL. GitHub
Cloudflare's docs cover the plugin from the cloudflare/skills marketplace, or adding the server URL as an HTTP server.
Known problems
- Open
Logging out or switching accounts drops the sign-in, so each server needs a new browser login
Workaround: Pass a Cloudflare API token as an Authorization Bearer header instead of OAuth.
Since Aug 2026 · GitHub
- Open
Server would not start from .mcp.json until "type": "http" was added to the entry
Workaround: Add "type": "http" next to the url in .mcp.json.
Since Feb 2026 · GitHub
Listed in Claude's connectors directory as Cloudflare Developer Platform, which points at an older server.
Known problems
- Open
The main API server refuses the desktop app's sign-in redirect
Workaround: Connecting the same server from the Claude Code CLI worked for the reporter.
Since Sep 2026 · GitHub
Cloudflare's skills repo covers adding the cloudflare plugin from its marketplace.
No Cloudflare docs for Gemini CLI. Any client with remote server support can use the URL.
Known problems
- Open
Workers Bindings tool schemas fail strict function-calling checks and break the whole request
Since May 2026 · GitHub
Cloudflare ships an official ChatGPT plugin that signs you in to the API server with OAuth.
Known problems
- Open
Sign-in window shows 'Client metadata is temporarily unavailable' before the consent screen
Since Oct 2026 · GitHub
- Open
Connect hangs or opens a blank page on Android, with the plugin and a custom connector
Since Oct 2026 · GitHub
- Open
Sign-in succeeds and the server is listed, but no Cloudflare tools reach the chat
Since Sep 2026 · GitHub
- Fixed
Plugin showed only skills, with no Connect button or tools
Reported Aug 2026 · GitHub
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Cloudflare MCP
Claude Code
- 1
Copy this prompt.
Add the Cloudflare MCP server to Claude Code. Run this command: claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
This is Cloudflare's main API server. It covers the whole Cloudflare API through code execution, and the first connection sends you to Cloudflare to approve the permissions you choose. For CI or scripts, create a Cloudflare API token and send it in an Authorization: Bearer <token> header instead. Cloudflare also runs single-product servers: Documentation (https://docs.mcp.cloudflare.com/mcp, no sign-in), Browser Run and Container, each at its own address ending in /mcp. The old /sse addresses were retired and return 410, so use /mcp only.
From the vendor's docs. Source.
Tools
Searches Cloudflare's developer docs
(Documentation server) Looks up current Cloudflare documentation for a question, so the assistant answers from up-to-date reference instead of memory.
Try: “How do I set up a Workers cron trigger? Check the Cloudflare docs.”
Read ·
search_cloudflare_documentationSearches Cloudflare docs from the API server
(Cloudflare API server) Searches Cloudflare developer documentation alongside the API tools, so you can look up how a feature works before changing it.
Try: “Look up the Cloudflare docs on D1 limits.”
Read ·
docsShows which Cloudflare account is connected
(Cloudflare API server) Returns the ID of the connected user or account token, plus email or name. Useful to confirm which account the assistant is acting on.
Try: “Which Cloudflare account am I connected as?”
Read ·
whoamiCalls Cloudflare API endpoints with code
(Cloudflare API server) Lets the assistant write JavaScript that calls the Cloudflare API on your account, for example to list zones or change settings. Results are capped at about 6,000 tokens.
Try: “List all zones in my Cloudflare account.”
Delete ·
executeTurns a web page into Markdown
(Browser Run server) Fetches a page and converts it to Markdown, which is easier for an assistant to read than raw HTML.
Try: “Fetch https://example.com/pricing as Markdown.”
Read ·
get_url_markdownFetches a page's HTML
(Browser Run server) Loads a page in a remote browser and returns its HTML, including content added by scripts.
Try: “Get the HTML of https://example.com.”
Read ·
get_url_html_contentTakes a screenshot of a web page
(Browser Run server) Captures an image of a page, optionally at a viewport size you choose.
Try: “Screenshot https://example.com at mobile width.”
Read ·
get_url_screenshotRenders a web page as a PDF
(Browser Run server) Renders a page to a PDF document you can save or share.
Try: “Make a PDF of https://example.com/report.”
Read ·
get_url_pdfGets a page's HTML and screenshot together
(Browser Run server) Returns both the HTML and a screenshot of a page in one call.
Try: “Snapshot https://example.com so I can compare text and layout.”
Read ·
get_url_snapshotPulls page elements by CSS selector
(Browser Run server) Extracts the elements on a page that match a CSS selector, such as all product titles.
Try: “Scrape every h2 on https://example.com/blog.”
Read ·
scrape_url_elementsExtracts structured data from a page with AI
(Browser Run server) Uses AI to pull structured JSON from a page, guided by a prompt and an optional JSON schema.
Try: “Extract product names and prices from this page as JSON.”
Read ·
get_url_jsonLists the links on a page
(Browser Run server) Returns every link found on a web page.
Try: “List all links on https://example.com.”
Read ·
get_url_linksStarts crawling a whole website
(Browser Run server) Starts an asynchronous crawl of a site and returns a job ID to check later.
Try: “Crawl https://example.com/docs and collect the pages.”
Read ·
start_crawlChecks a crawl job and returns its pages
(Browser Run server) Returns the status and collected records of a crawl started with start_crawl.
Try: “Is crawl job abc123 done? Show the results.”
Read ·
get_crawl_resultStops a running crawl
(Browser Run server) Cancels a crawl job that is still running.
Try: “Cancel crawl job abc123.”
Runs code ·
cancel_crawlLists open remote browser sessions
(Browser Run server) Shows the active Browser Run sessions on your account.
Try: “What browser sessions are open on my account?”
Read ·
list_browser_sessionsCloses a remote browser session
(Browser Run server) Closes a Browser Run session by its session ID.
Try: “Close browser session xyz789.”
Delete ·
kill_browser_sessionStarts or restarts a sandbox container
(Container server) Starts a fresh sandbox container. Containers are temporary and only guaranteed to last about 10 minutes, so nothing is saved.
Try: “Start a new sandbox container.”
Runs code ·
container_initializeRuns a shell command in the sandbox
(Container server) Runs a command in the sandbox shell. Use it to run Node or Python code safely away from your own machine.
Try: “Run python3 --version in the sandbox.”
Runs code ·
container_execWrites a file in the sandbox
(Container server) Creates or overwrites a file in the sandbox work directory.
Try: “Write a hello.py file in the sandbox that prints hello.”
Write ·
container_file_writeReads a file or folder in the sandbox
(Container server) Returns the contents of a file or directory in the sandbox.
Try: “Show me the contents of hello.py in the sandbox.”
Read ·
container_file_readLists files in the sandbox
(Container server) Lists everything in the sandbox work directory.
Try: “What files are in the sandbox?”
Read ·
container_files_listDeletes a file or folder in the sandbox
(Container server) Removes a file or directory from the sandbox.
Try: “Delete hello.py from the sandbox.”
Delete ·
container_file_deleteUsed by the assistant behind the scenes
Finds the right Cloudflare API endpoints
(Cloudflare API server) Lets the assistant write JavaScript that queries the Cloudflare API spec to find endpoints for a task, such as listing DNS records.
Try: “Find the API endpoint for purging cache on a zone.”
Read ·
searchChecks the sandbox is reachable
(Container server) Pings the container to confirm it is up and responding.
Try: “Is my sandbox container still running?”
Read ·
container_ping
Read from the source code
Pros and cons
Good
- One server at mcp.cloudflare.com reaches the whole Cloudflare API.
- Hosted by Cloudflare, so nothing runs on your machine.
- Sign-in with your Cloudflare account lets you pick the permissions, and you can drop write scopes.
- An API token works for CI and scripts.
- The Documentation server needs no account and answers from current Cloudflare docs.
- Cloudflare publishes plugins for Claude Code, Cursor, Codex and VS Code.
Watch out
- It can change and delete live resources, so permissions need care.
- Many single-product servers are deprecated and still show up in the Claude directory and MCP Registry.
- Each server asks for its own sign-in, and Claude Code loses it when you log out.
- ChatGPT sign-in hangs or ends with no tools for some users.
- Turning code mode off passes Codex's tool limit and the server is dropped.
- Some features may need a paid Cloudflare Workers plan.
Permissions
medium risk · 4 things to watch
Medium risk
The main server can change or delete real resources on your Cloudflare account, including DNS and Workers. Sign in with only the permissions you need, or use a read-only API token.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
It can change and delete things on your live account
Signed-in servers can create, change and delete Workers, KV, R2, D1 and DNS. Grant only the permissions the job needs, or use a read-only token. github.com
The MCP Registry lists the wrong token header
The registry entry says 'Authentication'; the servers expect 'Authorization: Bearer <token>'. One user got 401 errors from the registry's name. github.com
Docs and Blog servers are open to anyone
These two need no sign-in and only read public Cloudflare content. A maintainer confirmed this is expected. github.com
Memory bugs in the code sandbox runtime were fixed
Check Point found memory bugs in workerd, the runtime under Code Mode, in August 2026. Cloudflare fixed its hosted platform and no CVEs were assigned. research.checkpoint.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Use a Cloudflare API token with only read permissions as the Bearer token, or untick write scopes under Edit Permissions on the OAuth consent screen. The Docs and Blog servers only read public content. |
|---|---|
| Talks to | mcp.cloudflare.com. docs.mcp.cloudflare.com. Code Mode runs generated code in an isolate with outbound fetch off by default |
| Scopes |
|
Alternatives
Use the official Cloudflare server; it is the pick for almost everyone. Two community servers run on your own machine instead, but each has only a few GitHub stars.
| Server | Official | Runs | Sign-in | Can change things | GitHub stars |
|---|---|---|---|---|---|
| Cloudflare MCP (official)This page | Official | Hosted | Account or token | Yes | 4.4K |
| Cloudflare MCP Pro | Community | Local | – | – | 3 |
| mcp-server-cloudflare (ofershap) | Community | Local | – | – | 4 |
What people say
People like how much one Cloudflare server covers and dislike the sign-in friction and the leftover deprecated servers.
What people like
- The main API server reaches the whole Cloudflare API with a handful of tools that cost about 1,000 tokens of context.
- Splitting tools by product gives smaller surfaces that teams find easier to reason about.
- Sign-in downscopes the token to the permissions you approve.
Common complaints
- Most product servers are now deprecated, and the Claude directory and MCP Registry still point people at them.
- Every server needs its own OAuth sign-in, and those sign-ins are lost when the client resets its credentials.
- ChatGPT connections are unreliable: sign-in hangs or finishes with no tools attached.
- Chained tool calls on Observability can fill Claude's context and cut replies off.
In their words
“Thank you for splitting the servers by domain; the smaller surfaces are the ones enterprises can reason about.”javmann100GitHub issueAug 2026
“Today (2026-08-30) that cost me six browser re-authorizations, one per Cloudflare server (`api`, `bindings`, `observability`, `ai-gateway`, `auditlogs`, `graphql`), none of which had actually expired on your side.”ryofukutaniGitHub issueSep 2026
“Reinstalling/re-authenticating has been attempted many times. The MCP integration became usable only once; almost every other attempt ends in the state described above.”get-off-my-trainGitHub issueOct 2026
“The same Cloudflare MCP works in Claude, and Cloudflare Dashboard works. ChatGPT integration reinstall/retry did not help.”trvny
2 more quotesFewer quotes
“It is OAuth 2.1 compliant, using Workers OAuth Provider to downscope the token to selected permissions approved by the user when connecting. The agent only gets the capabilities the user explicitly granted.”Matt CareyGitHub issueFeb 2026
“For me adding mcp servers to claude code using the `.mcp.json` file - i needed to add `"type": "http"` to the installation to get it to start.”henkisdabro
Questions
Which Cloudflare MCP server should I use?
Use the main Cloudflare API server. Cloudflare's docs say most people should, because it already covers the full Cloudflare API. Add a single-product server, such as Documentation or Browser Run, only if you want a small set of purpose-built tools.
Is the Cloudflare MCP server free?
Yes, connecting is free. Cloudflare's README notes some features may need a paid Workers plan, depending on the products you use.
What is the Cloudflare MCP server URL?
https://mcp.cloudflare.com/mcp for the main API server. The Documentation server is https://docs.mcp.cloudflare.com/mcp. Add the URL in your AI app and sign in with your Cloudflare account.
Do the deprecated Cloudflare servers still work?
Yes. Ten servers are deprecated: AI Gateway, Audit Logs, AutoRAG, DNS Analytics, GraphQL, Logpush, Observability, Radar, Workers Bindings and Workers Builds. Their tools still run but get no new features, and Cloudflare asks you to move to the main server, which covers the same APIs.
Why does my Cloudflare MCP URL ending in /sse fail?
Cloudflare retired every /sse URL on October 22, 2026, and they now return 410 Gone. Change the URL to end in /mcp, for example https://docs.mcp.cloudflare.com/mcp.
Why does the Claude connector show different tools?
The Cloudflare Developer Platform entry in Claude's directory points at the Workers Bindings server, which is deprecated. The official MCP Registry entry is also out of date and lists older servers and retired /sse URLs. For the current tools, add the main server as a custom connector using the install box above.
Do I need an API token, or can I sign in?
Signing in is the default: you approve permissions on Cloudflare when you connect. For CI or scripts with no browser, send a Cloudflare user or account API token as a Bearer token in the Authorization header.
Does the Cloudflare documentation server need an account?
No. The Documentation server is open and needs no sign-in, because it only reads public Cloudflare docs.
Can it delete things, and can I make it read-only?
Yes, it can create, change and delete resources such as Workers, KV, R2, D1 and DNS records. To limit it, untick write scopes under Edit Permissions when you sign in, or use an API token that has only read permissions.
Should I still use npx @cloudflare/mcp-server-cloudflare?
No. That local package dates from March 2025 and the maintainer is retiring it. Connect to the hosted /mcp URLs instead.
Examples
Manage account resources through the main Cloudflare API server
Add an A record for api.example.com pointing to 192.0.2.1
SourceLook up current Cloudflare docs while writing a Worker (Documentation server, no sign-in)
Using the Cloudflare docs, how do I bind a D1 database to my Worker in wrangler.jsonc?
SourceFetch a page as markdown or take a screenshot (Browser Run server)
Fetch https://example.com as markdown and take a screenshot of it.
SourceDebug a Worker from its logs (Observability server, deprecated; the main server reaches the same data)
Can you tell me about any potential issues on this particular worker 'my-worker-name'?
Source
Information
updated Nov 2, 2026
- Publisher
- Cloudflare (official)
- Endpoint
https://docs.mcp.cloudflare.com/mcp- Transport
- Streamable HTTP
- Auth
- OAuth
- License
- Apache-2.0
- Last commit
- Oct 22, 2026
- Open issues
- 41
- Listed in
- Official MCP registry, Docker MCP Catalog
Cloudflare docs: MCP servers for CloudflareGitHubOfficial MCP RegistryChangelogIssues
Other Cloudflare MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 26Hide
- Cloudflare API MCP Server · github.com
- Cloudflare MCP servers README · github.com
- MCP servers for Cloudflare · developers.cloudflare.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- Code Mode: give agents an entire API in 1,000 tokens · blog.cloudflare.com
- Optional OAuth scopes · developers.cloudflare.com
- Registry and directory list deprecated servers · github.com
- Docs server open access · github.com
- When agentic glue melts · research.checkpoint.com
- Deprecate product servers · github.com
- Retire /sse endpoints · github.com
- Cloudflare Developer Platform connector · claude.com
- Retire the local npm package · github.com
- Cloudflare Skills plugin · github.com
- Cloudflare ChatGPT plugin: OAuth succeeds but no MCP tools are exposed · github.com
- What stops an agent on a domain-specific server changing production DNS or Workers? · github.com
- Document static API-token auth · github.com
- [ChatGPT] OAuth connection hangs for official Cloudflare plugin and custom MCP · github.com
- [Connection guide] Claude Code · github.com
- Workers Observability README · raw.githubusercontent.com
- Cloudflare MCP Pro · github.com
- mcp-server-cloudflare · github.com
- Codex drops the server with code mode off · github.com