Add Internet speed and services ranking Radar tools

Author: andre-j3sus

apps/radar/README.md

@@ -10,17 +10,19 @@ Internet traffic insights, trends and other utilities.
 
 Currently available tools:
 
-| **Category**           | **Tool**                  | **Description**                                                                                                                |
-| ---------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| **HTTP Requests**      | `get_http_requests_data`  | Fetches HTTP request data (timeseries, summaries, and grouped timeseries across dimensions like `deviceType`, `botClass`)      |
-| **L7 Attacks**         | `get_l7_attack_data`      | Fetches L7 attack data (timeseries, summaries, and grouped timeseries across dimensions like `mitigationProduct`, `ipVersion`) |
-| **Autonomous Systems** | `list_autonomous_systems` | Lists ASes; filter by location and sort by population size                                                                     |
-|                        | `get_as_details`          | Retrieves detailed info for a specific ASN                                                                                     |
-| **IP Addresses**       | `get_ip_details`          | Provides details about a specific IP address                                                                                   |
-| **Traffic Anomalies**  | `get_traffic_anomalies`   | Lists traffic anomalies; filter by AS, location, start date, and end date                                                      |
-| **Domains**            | `get_domains_ranking`     | Get top or trending domains                                                                                                    |
-|                        | `get_domain_rank_details` | Get domain rank details                                                                                                        |
-| **URL Scanner**        | `scan_url`                | Scans a URL via [Cloudflare’s URL Scanner](https://developers.cloudflare.com/radar/investigate/url-scanner/)                   |
+| **Category**           | **Tool**                        | **Description**                                                                                                                |
+| ---------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| **HTTP Requests**      | `get_http_requests_data`        | Fetches HTTP request data (timeseries, summaries, and grouped timeseries across dimensions like `deviceType`, `botClass`)      |
+| **L7 Attacks**         | `get_l7_attack_data`            | Fetches L7 attack data (timeseries, summaries, and grouped timeseries across dimensions like `mitigationProduct`, `ipVersion`) |
+| **Internet Speed**     | `get_internet_speed_data`       | Retrieve summary of bandwidth, latency, jitter, and packet loss, from the previous 90 days of Cloudflare Speed Test.           |
+| **Autonomous Systems** | `list_autonomous_systems`       | Lists ASes; filter by location and sort by population size                                                                     |
+|                        | `get_as_details`                | Retrieves detailed info for a specific ASN                                                                                     |
+| **IP Addresses**       | `get_ip_details`                | Provides details about a specific IP address                                                                                   |
+| **Traffic Anomalies**  | `get_traffic_anomalies`         | Lists traffic anomalies; filter by AS, location, start date, and end date                                                      |
+| **Domains**            | `get_domains_ranking`           | Get top or trending domains                                                                                                    |
+|                        | `get_domain_rank_details`       | Get domain rank details                                                                                                        |
+| **Internet Services**  | `get_internet_services_ranking` | Get top Internet services                                                                                                      |
+| **URL Scanner**        | `scan_url`                      | Scans a URL via [Cloudflare’s URL Scanner](https://developers.cloudflare.com/radar/investigate/url-scanner/)                   |
 
 This MCP server is still a work in progress, and we plan to add more tools in the future.
 

apps/radar/src/tools/radar.ts

@@ -17,6 +17,7 @@ import {
 	DomainParam,
 	DomainRankingTypeParam,
 	HttpDimensionParam,
+	InternetServicesCategoryParam,
 	IpParam,
 	L7AttackDimensionParam,
 	LocationArrayParam,
@@ -186,6 +187,46 @@ export function registerRadarTools(agent: RadarMCP) {
 		}
 	)
 
+	agent.server.tool(
+		'get_internet_services_ranking',
+		'Get top Internet services',
+		{
+			limit: PaginationLimitParam,
+			date: DateListParam.optional(),
+			serviceCategory: InternetServicesCategoryParam.optional(),
+		},
+		async ({ limit, date, serviceCategory }) => {
+			try {
+				const client = getCloudflareClient(agent.props.accessToken)
+				const r = await client.radar.ranking.internetServices.top({
+					limit,
+					date,
+					serviceCategory,
+				})
+
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify({
+								result: r,
+							}),
+						},
+					],
+				}
+			} catch (error) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Error getting Internet services ranking: ${error instanceof Error && error.message}`,
+						},
+					],
+				}
+			}
+		}
+	)
+
 	agent.server.tool(
 		'get_domains_ranking',
 		'Get top or trending domains',
@@ -376,4 +417,46 @@ export function registerRadarTools(agent: RadarMCP) {
 			}
 		}
 	)
+
+	agent.server.tool(
+		'get_internet_speed_data',
+		'Retrieve summary of bandwidth, latency, jitter, and packet loss, from the previous 90 days of Cloudflare Speed Test.',
+		{
+			dateEnd: DateEndArrayParam.optional(),
+			asn: AsnArrayParam,
+			continent: ContinentArrayParam,
+			location: LocationArrayParam,
+		},
+		async ({ dateEnd, asn, location, continent }) => {
+			try {
+				const client = getCloudflareClient(agent.props.accessToken)
+				const r = await client.radar.quality.speed.summary({
+					asn,
+					continent,
+					location,
+					dateEnd,
+				})
+
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify({
+								result: r,
+							}),
+						},
+					],
+				}
+			} catch (error) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Error getting Internet speed data: ${error instanceof Error && error.message}`,
+						},
+					],
+				}
+			}
+		}
+	)
 }

apps/radar/src/types/radar.ts

@@ -26,6 +26,26 @@ export const DomainRankingTypeParam: z.ZodType<RankingTopParams['rankingType']>
 	.enum(['POPULAR', 'TRENDING_RISE', 'TRENDING_STEADY'])
 	.describe('The ranking type.')
 
+export const InternetServicesCategoryParam = z
+	.array(
+		z.enum([
+			'Generative AI',
+			'E-commerce',
+			'Cryptocurrency Services',
+			'Email',
+			'Fast Fashion',
+			'Financial Services',
+			'News',
+			'Social Media',
+			'Weather',
+			'Jobs',
+			'Low cost E-commerce',
+			'Messaging',
+			'Metaverse & Gaming',
+		])
+	)
+	.describe('Filters results by Internet service category.')
+
 export const DateParam = z.string().date().describe('Filters results by date.')
 
 export const DateListParam = z.array(DateParam).describe('Filters results by date.')