Query RIPE Stat for IP/ASN/BGP network data — 8 tools, credential-free public API

@pipeworx/mcp-ripe-stat v0.1.0 — 8 tools, RIPE NCC public Stat API

Architecture: Library-style MCP tool module (exports {tools, callTool} — NOT a stdio server). Uses RIPE Stat REST API at https://stat.ripe.net/data/<endpoint>/data.json. No auth needed (1000 req/10min/source IP).

Install & usage

npm install @pipeworx/mcp-ripe-stat
# Import as ES module — TypeScript source, needs --experimental-strip-types or tsx
# Copy src/index.ts outside node_modules first (Node blocks strip-types in node_modules)

8 tools

Key gotchas

• ⚠️ NOT a stdio MCP server — exports McpToolExport interface ({tools, callTool}), call as a library
• ⚠️ TypeScript source only (no compiled dist) — main: src/index.ts, needs tsx or --experimental-strip-types outside node_modules
• `as_overview` and `asn_neighbours` use `asn` param, all others use resource — the code handles both internally
• ASN accepts both formats: "AS15169" and "15169" work identically
• `whois` auto-converts single IPs to prefix: 8.8.8.8 → 8.8.8.0/24 (info message in response)
• `geoloc` gives COUNTRY-level only (no city) — it's RIR registration data, not MaxMind
• IPv6 works across all tools (tested 2001:4860:4860::8888)
• Invalid resources return empty data (records: []) with status: "ok" — no HTTP error
• Empty resource correctly rejected with client-side validation
• Response includes metadata: query_id, process_time, server_id, cached flag, build_version
• `asn_neighbours` returns large payloads: Google AS15169 has 333 unique neighbours (~46KB response)
• BGP state includes full AS paths and communities: each RIS collector's view of the prefix

Verified execution trace (16 calls, 14 OK + 2 correct rejections)