Skip to main content

Cloudflare GraphQL

Connect AI tools to Cloudflare’s GraphQL API to get analytics data. The Cloudflare GraphQL MCP server gives AI assistants secure, programmatic access to Cloudflare analytics via GraphQL through the Model Context Protocol (MCP).

1. Overview

Cloudflare GraphQL is a remote, vendor-hosted MCP server provided by Cloudflare. You connect to it from Cequence AI Gateway; the server uses Streamable HTTP (the standard transport for remote MCP per Cloudflare’s MCP docs).

  • Server URL: https://graphql.mcp.cloudflare.com/mcp
  • Transport: HTTP (Streamable HTTP)
  • Hosted by: Cloudflare

2. Supported authentication types

TypeSupportedNotes
OAuth 2.0YesRequired. Uses Dynamic Client Registration (DCR); sign in with your Cloudflare account.
API keyNoNot used for this remote MCP server.

When you add Cloudflare GraphQL in Cequence AI Gateway, authentication is handled via OAuth 2.0 with Dynamic Client Registration. You sign in with your Cloudflare account and grant access during the gateway flow.

3. What can you do with this MCP server

With the Cloudflare GraphQL MCP server, you can:

  • Query analytics — Run GraphQL queries against Cloudflare’s GraphQL API from your AI client.
  • Get metrics and dimensions — Request traffic, performance, and other analytics data in natural language without writing GraphQL by hand.
  • Build reports — Generate summaries or reports from GraphQL analytics data.
  • Explore datasets — Access the same analytics datasets available in the GraphQL API (e.g. HTTP requests, bandwidth, security events) via natural language.

4. Prerequisites

Before adding Cloudflare GraphQL in Cequence AI Gateway, ensure you have:

  • Access to Cequence AI Gateway (e.g. beta.aigateway.cequence.ai)
  • A Cloudflare account with access to GraphQL Analytics API
  • A modern browser to complete the OAuth authorization flow
  • For OAuth authentication: an auth app with client credentials (client ID and client secret) in your Cloudflare (vendor) account, unless the server supports Dynamic Client Registration (DCR).

5. Example workflows

  • “Run a GraphQL query for HTTP requests by country for the last 7 days.”
  • “Get bandwidth and request counts for my zone [zone name].”
  • “Summarize top attack traffic from the GraphQL analytics.”

6. Connecting MCP server from Cequence AI Gateway

  1. Log in to Cequence AI Gateway.
  2. Choose your tenant.
  3. Go to App catalogue.
  4. Filter by Remote MCP server.
  5. Search for Cloudflare GraphQL and then select it.
  6. Click Create MCP server.
  7. Choose auth method. If OAuth, you need an auth app with client credentials in your vendor account (see Prerequisites).
  8. Complete the setup as prompted, select tools, and deploy.

Use the generated MCP server URL in your client as described in the Client Configuration docs. For detailed UI steps and screenshots, see Create a third-party MCP Server.

7. Additional information