Cloudflare API (Code Mode) Remote MCP Server
Cloudflare's API MCP (mcp.cloudflare.com/mcp) runs in code mode โ instead of fixed tools it lets agents search the OpenAPI catalog and execute calls against your account's API surface.
ไธญๆ็ฎไป
Cloudflare ๅฎๆนไปฃ็ ๆจกๅผ MCP ๆๅกๅจใAI ไปฃ็ๅฏๆ็ดข Cloudflare API ๆฅๅฃๅนถๆง่กๅทฒ่ฎค่ฏ็ API ่ฐ็จ๏ผ่ฆ็ๅ จ้จ Cloudflare ไบงๅใ
Maintainer of Cloudflare API? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp"
}
}
}claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"cloudflare-api": {
"type": "http",
"url": "https://mcp.cloudflare.com/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.cloudflare.com/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"cloudflare-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.cloudflare.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"cloudflare-api": {
"serverUrl": "https://mcp.cloudflare.com/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.cloudflare-api] url = "https://mcp.cloudflare.com/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"cloudflare-api": {
"type": "streamableHttp",
"url": "https://mcp.cloudflare.com/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"cloudflare-api": {
"httpUrl": "https://mcp.cloudflare.com/mcp"
}
}
}๐งฐ Cloudflare API MCP Tools & Schema (4)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| search_api_endpoints ~60 tok | ๐ข Read | Search the Cloudflare OpenAPI catalog for endpoints. | query*: string |
| execute_api_code ~63 tok | ๐ Write | Execute JavaScript calling the Cloudflare API with your authenticated context. | code*: string |
| list_accounts ~39 tok | ๐ข Read | List Cloudflare accounts accessible to your token. | โ |
| get_api_schema ~57 tok | ๐ข Read | Get the request/response schema of a specific API endpoint. | endpoint*: string |
๐ก๏ธ Security, Quality & Context Token Audit
Every tool definition (name + description + input schema) is injected into your LLMโs context on every request โ Estimate per-call LLM token cost โ
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- OAuth 2.1 with PKCE S256 enforced
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ Supported
- PKCE S256
- โ Supported
- Scopes
account:read- Protected resource metadata
- https://mcp.cloudflare.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Cloudflare API MCP Endpoint Overview & Security Guide
Cloudflare API MCP โ Remote MCP Server
Rather than shipping hundreds of single-purpose tools, Cloudflare's API MCP uses code mode: the agent searches the full OpenAPI catalog, writes a small script and executes it against your authenticated API context โ one endpoint for every Cloudflare product.
Official Cloudflare API MCP Endpoint & Transport Architecture
- Endpoint URL:
https://mcp.cloudflare.com/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Cloudflare API MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Cloudflare API MCP uses OAuth 2.1 โ the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ PKCE and Dynamic Client Registration, so no manual client setup is needed โ and simply open a browser consent screen.
Of the 4 cataloged tools, 3 are read-only and 1 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.
Common Troubleshooting & Connection Tips
- 401 Unauthorized on connect โ that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - Code-mode tools execute JavaScript against the API โ review what the agent intends to run.
- OAuth grants read/write according to the token scopes you approve.
๐ How to Connect
- Copy the Cloudflare API MCP endpoint URLThe remote endpoint is https://mcp.cloudflare.com/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp. Cursor: add"cloudflare-api": { "url": "https://mcp.cloudflare.com/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Complete the OAuth consentOn first connection your client opens a Cloudflare consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
- Verify with the online inspectorPaste https://mcp.cloudflare.com/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Cloudflare API MCP's 4 tools respond.
โ FAQ
What is the Cloudflare API MCP remote MCP endpoint?
The primary endpoint is https://mcp.cloudflare.com/mcp. It is an official first-party server operated by Cloudflare, speaking the Streamable HTTP transport.
How do I authenticate with Cloudflare API MCP?
Cloudflare API MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.
I'm getting a 401 Unauthorized from Cloudflare API MCP โ what's wrong?
A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.
Which MCP clients work with Cloudflare API MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does Cloudflare API MCP expose?
4 tools are cataloged in this directory โ including `search_api_endpoints`, `execute_api_code`, `list_accounts` and more. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus โ no account or token required.
Vercel's official remote MCP server. Agents can list deployments, fetch build logs and search Vercel docs with a token-authorized connection.
Sentry's hosted MCP server for error monitoring. Agents can inspect issues, search events and resolve regressions directly from your IDE.