get_zone_analytics

Instructions

Implementation Reference

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

  Tool registration: 'get_zone_analytics' is registered as an MCP Tool with name, description, and inputSchema (zone_id required, optional since/until timestamps).

  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"],
      },
  ),

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

  Handler implementation: _get_zone_analytics builds query params (since, until) from args and calls the Cloudflare API endpoint /zones/{zone_id}/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: accepts zone_id (required), since (optional ISO/relative), until (optional ISO/relative).

  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:27-59 (helper)

  Helper: _make_request is the underlying HTTP helper used by _get_zone_analytics to make authenticated requests to the Cloudflare API.

  async def _make_request(
      self,
      endpoint: str,
      method: str = "GET",
      data: Optional[dict] = None,
      params: Optional[dict] = None,
  ) -> Any:
      """Make a request to the Cloudflare API."""
      url = f"{CLOUDFLARE_API_BASE}{endpoint}"
      headers = {
          "Authorization": f"Bearer {self.api_token}",
          "Content-Type": "application/json",
      }
  
      try:
          response = await self.client.request(
              method=method,
              url=url,
              json=data,
              params=params,
              headers=headers,
          )
          response.raise_for_status()
          result = response.json()
  
          if not result.get("success"):
              errors = result.get("errors", [])
              raise Exception(f"Cloudflare API error: {json.dumps(errors)}")
  
          return result.get("result")
  
      except httpx.HTTPError as e:
          raise Exception(f"HTTP error occurred: {str(e)}")