Skip to content

Tools Reference

Jump to bottom
Herve Hildenbrand edited this page Jan 20, 2026 · 4 revisions

Tools Reference

BGP Explorer provides 23 tools that Claude can use to investigate routing questions. This page documents each tool.

Tool Categories

Category Tools Description
Search search_asn Find ASNs by company name
Lookups lookup_prefix, get_asn_announcements, get_asn_details, get_routing_history Query prefix and ASN information
Analysis analyze_as_path, compare_collectors Path diversity and collector comparison
Security get_rpki_status, check_prefix_anomalies, get_anomalies RPKI validation and hijack detection
Monitoring start_monitoring, stop_monitoring Real-time anomaly detection
Network Testing ping_from_global, traceroute_from_global Global reachability testing
Relationships get_as_peers, get_as_upstreams, get_as_downstreams, check_as_relationship, get_as_connectivity_summary AS relationship data
IXP & Contacts get_ixps_for_asn, get_networks_at_ixp, get_ixp_details, get_network_contacts IXP presence and contact lookup

Search Tools

search_asn

Search for ASNs by organization or company name.

Parameters:

Name Type Required Description
query string Yes Organization name to search (e.g., "Google", "Cloudflare")

Example:

> Show me Kentik's ASNs

Claude calls search_asn("Kentik") and returns matching ASNs.

Lookup Tools

lookup_prefix

Get BGP routing information for an IP prefix.

Parameters:

Name Type Required Description
prefix string Yes IP prefix in CIDR notation (e.g., "8.8.8.0/24")

Returns: Origin ASN(s), AS paths, visibility from collectors

get_asn_announcements

List all prefixes announced by an ASN.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: List of IPv4 and IPv6 prefixes

get_asn_details

Get detailed information about an ASN.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: Announcements, upstream providers, downstream customers, routing behavior

get_routing_history

Get historical routing information for a prefix or ASN.

Parameters:

Name Type Required Description
resource string Yes IP prefix or ASN (e.g., "8.8.8.0/24" or "AS15169")
start_date string Yes Start date in ISO format (YYYY-MM-DD)
end_date string Yes End date in ISO format (YYYY-MM-DD)

Returns: Timeline of origin changes and routing events

Analysis Tools

analyze_as_path

Analyze AS path diversity and characteristics.

Parameters:

Name Type Required Description
prefix string Yes IP prefix in CIDR notation

Returns: Path diversity metrics, upstream ASNs, transit ASNs, prepending detection

compare_collectors

Compare routing views across different RIPE RIS collectors.

Parameters:

Name Type Required Description
prefix string Yes IP prefix in CIDR notation

Returns: Collector-by-collector comparison, consistency check

Security Tools

get_rpki_status

Check RPKI validation status for a prefix/origin pair.

Parameters:

Name Type Required Description
prefix string Yes IP prefix in CIDR notation
origin_asn integer Yes Origin ASN to validate

Returns: Validation status (valid/invalid/not-found)

check_prefix_anomalies

Check a prefix for potential hijack indicators (works without bgp-radar).

Parameters:

Name Type Required Description
prefix string Yes IP prefix in CIDR notation

Returns: Risk level, MOAS detection, RPKI status, origin changes, visibility analysis

get_anomalies

Get recent BGP anomalies from bgp-radar.

Parameters:

Name Type Required Description
event_type string No Filter: "hijack", "leak", or "blackhole"
prefix string No Filter by affected prefix
asn integer No Filter by affected ASN

Returns: List of detected anomalies with severity and details

Note: Requires bgp-radar to be running (/monitor start)

Monitoring Tools

start_monitoring

Start real-time BGP anomaly monitoring.

Parameters:

Name Type Required Description
collectors array No RIS collectors to monitor (default: configured collectors)

Note: Requires bgp-radar to be installed

stop_monitoring

Stop real-time BGP anomaly monitoring.

Parameters: None

Network Testing Tools

ping_from_global

Perform ping measurements from globally distributed probes.

Parameters:

Name Type Required Description
target string Yes IP address or hostname
locations array No Location filters (country codes, continent codes, region names)

Location examples:

  • Country codes: "US", "DE", "FR", "GB", "JP"
  • Continent codes: "EU", "NA", "AS"
  • Region names: "Europe", "North America"

traceroute_from_global

Perform traceroute from globally distributed probes.

Parameters:

Name Type Required Description
target string Yes IP address or hostname
locations array No Location filters

Relationship Tools

get_as_peers

Get all networks that peer with an AS.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: List of peer ASes with visibility percentage

get_as_upstreams

Get upstream transit providers for an AS.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: List of upstream ASes with visibility percentage

get_as_downstreams

Get downstream customers of an AS.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: List of downstream ASes with visibility percentage

check_as_relationship

Check the relationship between two ASes.

Parameters:

Name Type Required Description
asn1 integer Yes First ASN
asn2 integer Yes Second ASN

Returns: Relationship type (peer/upstream/downstream), visibility breakdown

get_as_connectivity_summary

Get a connectivity summary for an AS.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: Counts and top examples for upstreams, peers, downstreams

IXP & Contact Tools

get_ixps_for_asn

Get all IXPs where an ASN is present.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: List of IXPs with connection details

get_networks_at_ixp

Get all networks present at an IXP.

Parameters:

Name Type Required Description
ixp string Yes IXP name or ID

Returns: List of participating networks

get_ixp_details

Get detailed information about an IXP.

Parameters:

Name Type Required Description
ixp string Yes IXP name or ID

Returns: Location, participant count, website

get_network_contacts

Get contact information for a network from PeeringDB.

Parameters:

Name Type Required Description
asn integer Yes Autonomous System Number

Returns: NOC, abuse, technical contacts with emails and phone numbers

Tool Availability

Not all tools are available in every configuration:

Tool Requires
start_monitoring, stop_monitoring, get_anomalies bgp-radar
ping_from_global, traceroute_from_global Globalping
get_ixps_for_asn, get_networks_at_ixp, get_ixp_details, get_network_contacts PeeringDB
get_as_peers, get_as_upstreams, get_as_downstreams, check_as_relationship, get_as_connectivity_summary Monocle

All other tools require only RIPE Stat (always available).

Next Steps

Clone this wiki locally