Cloudflare Workers Bindings MCP Server
The Workers Bindings MCP connects agents to your Cloudflare account resources โ Workers, D1, KV and R2 โ after an OAuth login. Great for infrastructure Q&A and inspection.
- Provider
- Cloudflare โ
- Source
- https://github.com/cloudflare/mcp-server-cloudflare โ
- Categories
- โ๏ธ Cloud, Infrastructure & DevOps
ไธญๆ็ฎไป
Cloudflare ่ฎค่ฏ็็ปๅฎ็ฎก็ MCP ๆๅกๅจใAI ไปฃ็ๅฏๅๅบ Workersใๆฅ่ฏข D1 ๆฐๆฎๅบใๆฅ็ KV ๅฝๅ็ฉบ้ดๅ R2 ๅญๅจๆกถใ
Legacy SSE endpoint
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"cloudflare-workers": {
"url": "https://bindings.mcp.cloudflare.com/mcp"
}
}
}claude mcp add --transport http cloudflare-workers https://bindings.mcp.cloudflare.com/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"cloudflare-workers": {
"type": "http",
"url": "https://bindings.mcp.cloudflare.com/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://bindings.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-workers": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://bindings.mcp.cloudflare.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"cloudflare-workers": {
"serverUrl": "https://bindings.mcp.cloudflare.com/mcp"
}
}
}๐งฐ Tools exposed by Cloudflare Workers Bindings MCP (4)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| workers_list | ๐ข Read | List Workers scripts in the account. | accountId: string |
| d1_database_query | ๐ Write | Run a SQL query against a D1 database. Can modify data depending on the statement. | accountId: stringdatabaseId*: stringquery*: string |
| kv_namespace_list | ๐ข Read | List KV namespaces in the account. | accountId: string |
| r2_bucket_list | ๐ข Read | List R2 buckets in the account. | accountId: string |
๐ OAuth 2.1 & Security
- Auth type
- OAuth 2.1
- Dynamic Client Registration
- โ Supported
- PKCE S256
- โ Supported
- Protected resource metadata
- https://bindings.mcp.cloudflare.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Guide
Cloudflare Workers Bindings MCP โ Remote MCP Server
The Workers Bindings server is Cloudflare's authenticated MCP for account inspection: after OAuth it can enumerate your Workers, query D1 databases, and list KV namespaces and R2 buckets. It is read-oriented but the D1 query tool executes real SQL, so treat it with the same care as dashboard access.
Endpoint & Transport
- Endpoint URL:
https://bindings.mcp.cloudflare.com/mcp - Legacy SSE endpoint:
https://bindings.mcp.cloudflare.com/sse - Transport: Streamable HTTP + legacy SSE
Authentication
Cloudflare Workers Bindings 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.
Available Tools (4)
| Tool | Safety | Description |
|---|---|---|
workers_list |
read | List Workers scripts in the account. |
d1_database_query |
write | Run a SQL query against a D1 database. Can modify data depending on the statement. |
kv_namespace_list |
read | List KV namespaces in the account. |
r2_bucket_list |
read | List R2 buckets in the account. |
Connect in 30 Seconds
Claude Code โ one command:
claude mcp add --transport http cloudflare-workers https://bindings.mcp.cloudflare.com/mcp
Cursor โ add to ~/.cursor/mcp.json:
{ "mcpServers": { "cloudflare-workers": { "url": "https://bindings.mcp.cloudflare.com/mcp" } } }
VS Code โ add to .vscode/mcp.json:
{ "servers": { "cloudflare-workers": { "type": "http", "url": "https://bindings.mcp.cloudflare.com/mcp" } } }
Claude Desktop & stdio clients โ bridge with mcp-remote:
{ "mcpServers": { "cloudflare-workers": { "command": "npx", "args": ["-y", "mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"] } } }
On first connect your client opens a browser OAuth consent screen โ approve it and tools become available immediately.
Troubleshooting
- 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. - Which URL should I use? Prefer
https://bindings.mcp.cloudflare.com/mcp(Streamable HTTP). The SSE URL is only for older clients pinned to the pre-2025-03-26 spec. - "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely. - OAuth uses your Cloudflare account โ the agent sees the resources your user can see.
- d1_database_query executes arbitrary SQL against selected databases.
๐ How to Connect
- Copy the Cloudflare Workers Bindings MCP endpoint URLThe remote endpoint is https://bindings.mcp.cloudflare.com/mcp. A legacy SSE endpoint is also available at https://bindings.mcp.cloudflare.com/sse.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http cloudflare-workers https://bindings.mcp.cloudflare.com/mcp. Cursor: add"cloudflare-workers": { "url": "https://bindings.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://bindings.mcp.cloudflare.com/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Cloudflare Workers Bindings MCP's 4 tools respond.
โ FAQ
What is the Cloudflare Workers Bindings MCP remote MCP endpoint?
The primary endpoint is https://bindings.mcp.cloudflare.com/mcp, with a legacy SSE endpoint at https://bindings.mcp.cloudflare.com/sse. It is an official first-party server operated by Cloudflare, speaking the Streamable HTTP + legacy SSE transport.
Should I use Cloudflare Workers Bindings MCP's /mcp or /sse endpoint?
Use https://bindings.mcp.cloudflare.com/mcp โ Streamable HTTP is the current MCP transport and what every modern client defaults to. https://bindings.mcp.cloudflare.com/sse exists only for clients still on the legacy HTTP+SSE transport from the 2024 spec.
How do I authenticate with Cloudflare Workers Bindings MCP?
Cloudflare Workers Bindings 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 Workers Bindings 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 Workers Bindings MCP?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http cloudflare-workers https://bindings.mcp.cloudflare.com/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, and Claude Desktop via the `mcp-remote` bridge.
What tools does Cloudflare Workers Bindings MCP expose?
4 tools are cataloged in this directory โ including `workers_list`, `d1_database_query`, `kv_namespace_list` 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
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.
Cloudflare's authenticated observability MCP server. Query Worker logs, trace events and error analytics from any MCP client.