arin_expand_as_set
Expand ARIN-managed AS-SET objects into concrete ASN numbers for network analysis, route filtering, and policy generation with configurable recursion depth.
Instructions
Efficiently expand AS-SET objects from the ARIN IRR database into concrete ASNs with configurable depth. This tool is specifically for the ARIN RIR (North America region - United States, Canada, parts of Caribbean). Use this instead of whois_query when you need ASNs from an ARIN AS-SET. CRITICAL: For 'top-level', 'direct', or 'immediate' members, use max_depth=1. For complete expansion, use max_depth=10+. Large AS-SETs may have nested structures - choose depth carefully to balance completeness vs speed. Automatically handles recursive expansion, deduplication, and cycle detection. Perfect for network analysis, route filtering, and policy generation for ARIN-managed AS-SETs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| setname | Yes | AS-SET name to recursively expand into concrete ASN numbers from ARIN IRR database. Examples: 'AS-COMCAST', 'AS-VERIZON', 'AS-ATT'. The tool will automatically resolve all nested AS-SETs and return a complete list of individual ASNs contained within the hierarchy from ARIN IRR records. | |
| max_depth | No | Maximum recursion depth for AS-SET expansion (1-20 levels, default: 10). IMPORTANT: Use depth=1 for 'top-level' or 'direct' members only. Use depth=2-3 for shallow analysis, depth=10 for complete expansion. Higher values provide more complete results but take much longer to process. For questions about 'immediate' or 'direct' members, always use depth=1. |