accounts_list
List all accounts in your Cloudflare account
set_active_account
Set active account to be used for tool calls that require accountId
zones_list
List all zones under a Cloudflare account
zone_details
Get details for a specific Cloudflare zone
graphql_schema_search
Search the Cloudflare GraphQL API schema for types, fields, and enum values matching a keyword
Use this tool when:
- You are unsure which dataset to use for your query.
- A user is looking for specific types, fields, or enum values in the Cloudflare GraphQL API schema.
IMPORTANT GUIDELINES:
- DO NOT query for dimensions unless the user explicitly asked to group by or show dimensions.
- Only include fields that the user specifically requested in their query.
- Keep queries as simple as possible while fulfilling the user's request.
Workflow:
1. Use this tool to search for dataset types by keyword.
2. When a relevant dataset type is found, immediately use graphql_schema_details to get the complete structure of that dataset.
3. After understanding the schema structure, proceed directly to constructing and executing queries using the graphql_query tool.
4. Do not use graphql_schema_overview or graphql_complete_schema after finding the relevant dataset - these are redundant steps.
This tool searches the Cloudflare GraphQL API schema for any schema elements (such as object types, field names, or enum options) that match a given keyword. It returns schema fragments and definitions to assist in constructing valid and precise GraphQL queries.
graphql_schema_overview
Fetch the high-level overview of the Cloudflare GraphQL API schema
Use this tool when:
- A user requests insights into the structure or capabilities of Cloudflare’s GraphQL API.
- You need to explore available types, queries, mutations, or schema relationships exposed by Cloudflare’s GraphQL interface.
- You're generating or validating GraphQL queries against Cloudflare’s schema.
- You are troubleshooting or developing integrations with Cloudflare’s API and require up-to-date schema information.
This tool returns a high-level summary of the Cloudflare GraphQL API schema. It provides a structured outline of API entry points, data models, and relationships to help guide query construction or system integration.
graphql_type_details
Fetch detailed information about a specific GraphQL type (dataset)
IMPORTANT: After exploring the schema, DO NOT generate overly complicated GraphQL queries that the user didn't explicitly ask for. Only include fields that were specifically requested.
Use this tool when:
- You need to explore the fields by the type name (dataset) for detailed information
- You're building or debugging GraphQL queries and want to ensure the correct usage of schema components
- You need contextual information about how a certain concept or object is represented in Cloudflare's GraphQL API.
Guidelines for query construction:
- Keep queries as simple as possible while fulfilling the user's request
- Only include fields that the user specifically asked for
- Do not add dimensions or additional fields unless explicitly requested
- When in doubt, ask the user for clarification rather than creating a complex query
graphql_complete_schema
Fetch the complete Cloudflare GraphQL API schema (combines overview and important type details)
graphql_query
Execute a GraphQL query against the Cloudflare API
IMPORTANT: ONLY execute the EXACT GraphQL query provided by the user. DO NOT generate complicated queries that the user didn't explicitly ask for.
CRITICAL: When querying, make sure to set a LIMIT (e.g., first: 10, limit: 20) otherwise the response may be too large for the MCP server to process.
Use this tool when:
- A user provides a GraphQL query and expects real-time data from Cloudflare's API.
- You need to retrieve live information from Cloudflare, such as analytics, logs, account data, or configuration details.
- You want to validate the behavior of a GraphQL query or inspect its runtime results.
This tool sends a user-defined GraphQL query to the Cloudflare API and returns the raw response exactly as received. When filtering or querying by time, use ISO 8601 datetime format (e.g., "2020-08-03T02:07:05Z").
For each query execution, a clickable GraphQL API Explorer link will be provided in the response. Users can click this link to open the query in Cloudflare's GraphQL Explorer interface where they can further modify and experiment with the query.
Guidelines:
- Only use the exact query provided by the user. Do not modify or expand it unless explicitly requested.
- Always suggest including limits in queries (e.g., first: 10, limit: 20) to prevent response size issues.
- If a query fails due to size limits, advise the user to add or reduce limits in their query.
graphql_api_explorer
Generate a Cloudflare GraphQL API Explorer link
Use this tool when:
- A user asks for any GraphQL queries and wants to explore them in the Cloudflare GraphQL API Explorer.
- You want to provide a shareable link to a specific GraphQL query for the user to explore and modify.
- You need to help the user visualize or interact with GraphQL queries in a user-friendly interface.
This tool generates a direct link to the Cloudflare GraphQL API Explorer with a pre-populated query and variables.
The response includes a clickable Markdown link that users can click to open the query in Cloudflare's interactive GraphQL playground.
The original query and variables are also displayed for reference.