Add Internet quality Radar tool

Author: andre-j3sus

apps/radar/README.md

@@ -23,6 +23,7 @@ Currently available tools:
 | **IP Addresses**       | `get_ip_details`                | Provides details about a specific IP address                                                                          |
 | **Internet Services**  | `get_internet_services_ranking` | Gets top Internet services                                                                                            |
 | **Internet Speed**     | `get_internet_speed_data`       | Retrieves summary of bandwidth, latency, jitter, and packet loss, from the previous 90 days of Cloudflare Speed Test. |
+| **Internet Quality**   | `get_internet_quality_data`     | Retrieves a summary or time series of bandwidth, latency, or DNS response time from the Radar Internet Quality Index. |
 | **Layer 3 Attacks**    | `get_l3_attack_data`            | Retrieves L3 attack data, including timeseries, top attacks, and breakdowns by dimensions like `protocol`.            |
 | **Layer 7 Attacks**    | `get_l7_attack_data`            | Retrieves L7 attack data, including timeseries, top attacks, and breakdowns by dimensions like `mitigationProduct`.   |
 | **Traffic Anomalies**  | `get_traffic_anomalies`         | Lists traffic anomalies and outages; filter by AS, location, start date, and end date                                 |

apps/radar/src/tools/radar.ts

@@ -1,3 +1,5 @@
+import { z } from 'zod'
+
 import { getCloudflareClient } from '@repo/mcp-common/src/cloudflare-api'
 import { PaginationLimitParam, PaginationOffsetParam } from '@repo/mcp-common/src/types/shared'
 
@@ -19,6 +21,7 @@ import {
 	EmailRoutingDimensionParam,
 	EmailSecurityDimensionParam,
 	HttpDimensionParam,
+	InternetQualityMetricParam,
 	InternetServicesCategoryParam,
 	InternetSpeedDimensionParam,
 	InternetSpeedOrderByParam,
@@ -627,4 +630,49 @@ export function registerRadarTools(agent: RadarMCP) {
 			}
 		}
 	)
+
+	agent.server.tool(
+		'get_internet_quality_data',
+		'Retrieves a summary or time series of bandwidth, latency, or DNS response time percentiles from the Radar Internet Quality Index (IQI).',
+		{
+			dateEnd: DateEndArrayParam.optional(),
+			asn: AsnArrayParam,
+			continent: ContinentArrayParam,
+			location: LocationArrayParam,
+			format: z.enum(['summary', 'timeseriesGroups']),
+			metric: InternetQualityMetricParam,
+		},
+		async ({ dateEnd, asn, location, continent, format, metric }) => {
+			try {
+				const client = getCloudflareClient(agent.props.accessToken)
+				const r = await client.radar.quality.iqi[format]({
+					asn,
+					continent,
+					location,
+					dateEnd,
+					metric,
+				})
+
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify({
+								result: r,
+							}),
+						},
+					],
+				}
+			} catch (error) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Error getting Internet quality data: ${error instanceof Error && error.message}`,
+						},
+					],
+				}
+			}
+		}
+	)
 }

apps/radar/src/types/radar.ts

@@ -307,3 +307,7 @@ export const InternetSpeedOrderByParam = z
 		'JITTER_LOADED',
 	])
 	.describe('Specifies the metric to order the results by. Only allowed for top locations and ASes')
+
+export const InternetQualityMetricParam = z
+	.enum(['BANDWIDTH', 'DNS', 'LATENCY'])
+	.describe('Specifies which metric to return (bandwidth, latency, or DNS response time).')