Skip to content

Commit 2c68d15

Browse files
committed
feat(radar): add new tools, bug fixes, and improve README prompts
- Fix error message in get_traffic_anomalies (was incorrectly showing 'IP details') - Fix L3 attack description (application layer → network layer) - Fix unused orderBy parameter in get_internet_speed_data - Enhance get_ip_details to include full ASN info from /entities/asns/ip - Add get_internet_services_timeseries tool - Add get_outages_by_location tool - Add get_traffic_anomalies_by_location tool - Add get_bgp_routing_table_ases tool - Add get_bgp_top_ases_by_prefixes tool - Add new type definitions: BgpRoutesAsesSortByParam, TrafficAnomalyStatusParam - Reorganize README prompt examples with separate DNS and Email sections - Remove Geolocations section, add more prompts for CT, Email, DNS
1 parent e06c778 commit 2c68d15

File tree

3 files changed

+305
-36
lines changed

3 files changed

+305
-36
lines changed

apps/radar/README.md

Lines changed: 41 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ Currently available tools:
1515
| **AI** | `get_ai_data` | Retrieves AI-related data, including traffic from AI user agents, as well as popular models and model tasks |
1616
| **Events, Outages & Traffic Anomalies** | `get_annotations` | Retrieves annotations including Internet events, outages, and anomalies from various Cloudflare data sources |
1717
| | `get_outages` | Retrieves Internet outages and anomalies with detected connectivity issues |
18+
| | `get_outages_by_location` | Gets outage counts aggregated by location - identify which countries have the most outages |
1819
| | `get_traffic_anomalies` | Lists traffic anomalies and outages; filter by AS, location, start date, and end date |
20+
| | `get_traffic_anomalies_by_location` | Gets traffic anomalies aggregated by location - shows which countries have the most detected outage signals |
1921
| **AS112** | `get_as112_data` | Retrieves AS112 DNS sink hole data for reverse DNS lookups of private IP addresses (RFC 1918) |
2022
| **Autonomous Systems** | `list_autonomous_systems` | Lists ASes; filter by location and sort by population size |
2123
| | `get_as_details` | Retrieves detailed info for a specific ASN |
@@ -31,6 +33,8 @@ Currently available tools:
3133
| | `get_bgp_pfx2as` | Gets prefix-to-ASN mapping |
3234
| | `get_bgp_ip_space_timeseries` | Retrieves announced IP address space over time (IPv4 /24s and IPv6 /48s) - useful for detecting route withdrawals |
3335
| | `get_bgp_routes_realtime` | Gets real-time BGP routes for a prefix using RouteViews and RIPE RIS collectors |
36+
| | `get_bgp_routing_table_ases` | Lists all ASes in global routing tables with routing statistics (prefix counts, RPKI status) |
37+
| | `get_bgp_top_ases_by_prefixes` | Gets top ASes ordered by announced prefix count - shows which networks have the largest routing footprint |
3438
| **Bots** | `get_bots_data` | Retrieves bot traffic data by name, operator, category (AI crawlers, search engines, etc.) |
3539
| | `list_bots` | Lists known bots with details (AI crawlers, search engines, monitoring bots) |
3640
| | `get_bot_details` | Gets detailed information about a specific bot by slug |
@@ -52,12 +56,13 @@ Currently available tools:
5256
| **Geolocations** | `list_geolocations` | Lists available geolocations (ADM1 - states/provinces) with GeoNames IDs |
5357
| | `get_geolocation_details` | Gets details for a specific geolocation by GeoNames ID |
5458
| **HTTP** | `get_http_data` | Retrieves HTTP request data with geoId filtering for ADM1 (states/provinces) |
55-
| **IP Addresses** | `get_ip_details` | Provides details about a specific IP address |
59+
| **IP Addresses** | `get_ip_details` | Provides details about a specific IP address including full ASN details (name, country, population estimates) |
5660
| **Internet Services** | `get_internet_services_ranking` | Gets top Internet services |
61+
| | `get_internet_services_timeseries` | Tracks internet service ranking changes over time (e.g., how ChatGPT ranks over months) |
5762
| **Internet Quality & Speed** | `get_internet_quality_data` | Retrieves a summary or time series of bandwidth, latency, or DNS response time from the Radar Internet Quality Index |
5863
| | `get_internet_speed_data` | Retrieves summary of bandwidth, latency, jitter, and packet loss, from the previous 90 days of Cloudflare Speed Test |
5964
| | `get_speed_histogram` | Gets speed test histogram data showing distribution of results for bandwidth, latency, or jitter |
60-
| **Layer 3 Attacks** | `get_l3_attack_data` | Retrieves L3 attack data, including timeseries, top attacks, and breakdowns by dimensions like `protocol` |
65+
| **Layer 3 Attacks** | `get_l3_attack_data` | Retrieves network layer (L3/DDoS) attack data, including timeseries, top attacks, and breakdowns by dimensions |
6166
| **Layer 7 Attacks** | `get_l7_attack_data` | Retrieves L7 attack data, including timeseries, top attacks, and breakdowns by dimensions like `mitigationProduct` |
6267
| **Leaked Credentials** | `get_leaked_credentials_data` | Retrieves trends in HTTP auth requests and compromised credential detection |
6368
| **NetFlows** | `get_netflows_data` | Retrieves network traffic patterns with geoId filtering for ADM1 (states/provinces) |
@@ -76,92 +81,102 @@ Currently available tools:
7681
**Traffic & Network Analysis**
7782

7883
- `What are the most used operating systems?`
79-
- `Show me HTTP traffic trends from Lisbon, Portugal (use geoId).`
84+
- `Show me HTTP traffic trends from Lisbon, Portugal.`
8085
- `What is the TCP reset and timeout rate globally?`
8186
- `Show me network traffic patterns for California.`
87+
- `Compare HTTP traffic between mobile and desktop devices.`
88+
- `What percentage of traffic uses IPv6 vs IPv4?`
8289

8390
**Autonomous Systems & BGP**
8491

8592
- `What are the top 5 ASes in Portugal?`
8693
- `Get information about ASN 13335.`
8794
- `What are the relationships (peers, upstreams) for Cloudflare's AS?`
88-
- `Show me recent BGP hijack events.`
95+
- `Show me recent BGP hijack events with high confidence.`
8996
- `Which prefixes have the most BGP updates?`
9097
- `What AS announces the prefix 1.1.1.0/24?`
9198
- `Show me IPv6 announced address space for Portugal over the last 30 days.`
9299
- `Compare IPv4 vs IPv6 BGP address space trends for AS13335.`
93100
- `Get real-time BGP routes for prefix 1.1.1.0/24.`
94-
- `Monitor announced IPv6 space changes for a specific country to detect route withdrawals.`
101+
- `List the top ASes by prefix count in Germany.`
102+
- `Which ASes have the most IPv6 address space globally?`
103+
- `Show me BGP route leak events from the last week.`
95104

96105
**Security & Attacks**
97106

98107
- `Show me application layer attack trends from the last 7 days.`
99108
- `What are the top L3 attack vectors?`
100109
- `Show me leaked credential detection trends.`
101110
- `Scan https://example.com for security analysis.`
111+
- `Which industries are most targeted by DDoS attacks?`
102112

103113
**Bots & Crawlers**
104114

105115
- `What AI crawlers are most active?`
106116
- `List all known AI crawler bots.`
107117
- `How are websites configuring robots.txt for AI crawlers?`
108118
- `What percentage of sites block vs allow AI crawlers?`
109-
- `Show me crawler traffic by industry vertical.`
119+
- `Show me crawler traffic by industry.`
110120

111-
**DNS & Email**
121+
**DNS**
112122

113123
- `What are the most common DNS query types to 1.1.1.1?`
114-
- `Show me AS112 DNS sink hole data by protocol.`
124+
- `Show me AS112 DNS queries by protocol.`
125+
- `What is the DNSSEC adoption rate?`
126+
- `Show me DNS query trends by response code.`
127+
128+
**Email**
129+
115130
- `What are the email security threat trends?`
131+
- `Show me email routing data by encryption status.`
132+
- `What percentage of emails fail DMARC validation?`
133+
- `Which TLDs send the most malicious emails?`
116134

117-
**Certificates & TLS**
135+
**Certificate Transparency**
118136

119137
- `What are the most active Certificate Authorities?`
120138
- `List Certificate Transparency logs.`
121139
- `Show me certificate issuance trends by validation level.`
140+
- `Get details for the CT log argon2026h1.`
141+
- `What is the top Certificate Authority and show me its details.`
122142

123-
**Rankings & Services**
143+
**Rankings & Internet Services**
124144

125145
- `What are the top trending domains?`
126146
- `Compare domain rankings in the US and UK.`
127-
- `Give me rank details for google.com in March 2025.`
128147
- `What are the top Internet services in the E-commerce category?`
129-
- `Track how google.com and facebook.com rank over the last 30 days.`
148+
- `Track how google.com ranks over the last 30 days.`
149+
- `How has ChatGPT's ranking changed over the last 6 months?`
130150

131151
**TLDs**
132152

133-
- `List all generic TLDs.`
153+
- `List all country-code TLDs.`
134154
- `Show me details about the .io TLD.`
135155
- `Give me a ranking of TLDs based on DNS magnitude.`
136156

137157
**Speed & Quality**
138158

139159
- `Show me the bandwidth distribution histogram for the US.`
140-
- `What is the latency histogram for Portugal?`
141-
- `Compare speed test distributions across different regions.`
160+
- `What is the average latency in Portugal?`
161+
- `Which countries have the fastest internet speeds?`
162+
- `Show me top ASes by download bandwidth.`
142163

143164
**Outages & Events**
144165

145-
- `List me traffic anomalies in Syria over the last year.`
146166
- `Show me recent Internet outages.`
147-
- `What outages affected Portugal in the last 30 days?`
167+
- `Which countries have the most Internet outages?`
168+
- `Show me verified traffic anomalies by location.`
148169

149170
**Cloud & Infrastructure**
150171

151-
- `What are the top 5 AWS regions in terms of traffic?`
172+
- `What are the top AWS regions by traffic?`
152173
- `Compare latency between Azure and GCP regions.`
153174
- `What is the connection success rate for cloud providers?`
154175

155-
**Geolocations**
156-
157-
- `List available geolocations for Portugal.`
158-
- `What is the GeoNames ID for Lisbon?`
159-
- `Show me HTTP traffic specifically for the Lisbon area.`
160-
161176
**IP Information**
162177

163-
- `What are the details of IP address 1.1.1.1?`
164-
- `What ASN owns this IP address?`
178+
- `What are the details of IP address 8.8.8.8?`
179+
- `Give me full information about IP 1.1.1.1 including ASN details.`
165180

166181
## Access the remote MCP server from any MCP Client
167182

0 commit comments

Comments
 (0)