{"uid":"cap_S_gQWMIQb3_gfq0a2UsTE","slug":"swift-bot-labs-toolbox-ip-cidr-aggregation-526a060a","name":"Swift Bot Labs Toolbox – IP CIDR Aggregation","description":"62 small, deterministic utility APIs (DNS and e-mail checks, web extraction, EVM decoding, x402 checks, IP math, JSON/CSV, hashing, conversions). No account or API key: pay per call in USDC with x402.","url":"https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/aggregate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cidrs":{"type":["array","string"],"items":{"type":"string","maxLength":64},"maxItems":1000,"maxLength":40000,"description":"CIDR blocks or single IPs (JSON array, or a comma/space separated string)"}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"cidr-aggregate","result":{"cidrs":["10.0.0.0/22","192.168.1.5/32"],"input":4,"output":2,"invalid":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pDmlVnmpXoCUZ0jEa6SNf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Aggregates and summarizes a list of CIDR blocks or individual IPs into the minimal set of covering supernets, reporting input/output counts and any invalid entries.","exampleAgentPrompt":"Can you aggregate these CIDR blocks into the smallest possible set of supernets: 10.0.0.0/24, 10.0.1.0/24, 10.0.2.0/24, 10.0.3.0/24, 192.168.1.5 — and tell me how many were invalid?","exampleUseCases":[{"title":"Firewall allowlist consolidation","prompt":"I have a firewall allowlist with these 50 CIDR entries and individual IPs — can you aggregate them into the minimal set of covering supernets so I can simplify the rules? Here's the list: 10.0.0.0/24, 10.0.1.0/24, 10.0.2.0/23, 172.16.0.0/16, 192.168.0.1, 192.168.0.2."},{"title":"Cloud egress IP range reduction","prompt":"Our cloud vendor gave us this list of egress IPs: 35.190.0.0/17, 35.190.128.0/18, 35.190.192.0/19 — can you aggregate them into as few CIDR blocks as possible and flag any that are malformed?"},{"title":"BGP prefix list cleanup","prompt":"I need to clean up our BGP prefix list before a network migration — here are 200 prefixes in a comma-separated string, please aggregate them into the minimal covering CIDRs and tell me how many I started with versus how many remain."}],"resultDescription":"Returns a JSON object with ok status, the tool name ('cidr-aggregate'), and a result object containing: an array of aggregated CIDR strings (minimally covering supernets), the count of input CIDRs/IPs provided, the count of output aggregated CIDRs, and an array of any invalid/unparseable entries that were ignored.","failureModes":["Malformed CIDR notation in input causes entries to be placed in the 'invalid' array rather than aggregated","Exceeding 1000 CIDR items or 40,000 character string limit causes a 4xx error","Passing non-IP data (e.g. domain names) results in those entries being listed as invalid","Payment failure via x402 returns 402 Payment Required and no result","Empty input array returns aggregated result with zero CIDRs"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, serverless, pay-per-call CIDR aggregation without account setup — ideal for occasional or automated network-tooling tasks where a full-featured networking library isn't available, or when operating inside an AI agent pipeline that uses x402 micropayments. Prefer this over manual scripting (e.g. Python netaddr) when a hosted, stateless API call is more convenient and cost at $0.003/call is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:48.047Z","isFirstParty":false,"canonicalSlug":"swift-bot-labs-toolbox-ip-cidr-aggregation-526a060a"}