get_zone_analytics

Retrieve analytics data for a Cloudflare zone including requests, bandwidth, threats, and pageviews within specified time ranges to monitor performance and security metrics.

Instructions

Get analytics data for a zone including requests, bandwidth, threats, and pageviews.

Input Schema

TableJSON Schema

Name	Required	Description
`zone_id`	Yes	The zone ID
`since`	No	Start time (ISO 8601 format or relative like '-1440' for last 24h)
`until`	No	End time (ISO 8601 format or relative like '-0')

Implementation Reference

src/cloudflare_mcp_server/__init__.py:634-644 (handler)

The handler function that implements get_zone_analytics by preparing parameters and calling the Cloudflare API endpoint for zone analytics dashboard.

async def _get_zone_analytics(self, args: dict) -> Any:
    """Get zone analytics."""
    params = {}
    if args.get("since"):
        params["since"] = args["since"]
    if args.get("until"):
        params["until"] = args["until"]

    return await self._make_request(
        f"/zones/{args['zone_id']}/analytics/dashboard", params=params
    )

src/cloudflare_mcp_server/__init__.py:384-398 (schema)

Input schema for get_zone_analytics tool, specifying zone_id as required and optional since/until date parameters.

inputSchema={
    "type": "object",
    "properties": {
        "zone_id": {"type": "string", "description": "The zone ID"},
        "since": {
            "type": "string",
            "description": "Start time (ISO 8601 format or relative like '-1440' for last 24h)",
        },
        "until": {
            "type": "string",
            "description": "End time (ISO 8601 format or relative like '-0')",
        },
    },
    "required": ["zone_id"],
},

src/cloudflare_mcp_server/__init__.py:430-431 (registration)
Registration/dispatch in the call_tool method that handles invocation of get_zone_analytics by calling its handler.
```
elif name == "get_zone_analytics":
    result = await self._get_zone_analytics(arguments)
```

src/cloudflare_mcp_server/__init__.py:381-399 (registration)

Tool registration in list_tools() method, defining the tool's metadata and schema for MCP server discovery.

Tool(
    name="get_zone_analytics",
    description="Get analytics data for a zone including requests, bandwidth, threats, and pageviews.",
    inputSchema={
        "type": "object",
        "properties": {
            "zone_id": {"type": "string", "description": "The zone ID"},
            "since": {
                "type": "string",
                "description": "Start time (ISO 8601 format or relative like '-1440' for last 24h)",
            },
            "until": {
                "type": "string",
                "description": "End time (ISO 8601 format or relative like '-0')",
            },
        },
        "required": ["zone_id"],
    },
),

Cloudflare MCP Server