An MCP server that lets an AI assistant answer Internet registry questions — who holds an IP address or AS number, where to report abuse, which nameservers serve a reverse-DNS zone, and how a registration changed over time — using RDAP data from all five Regional Internet Registries: APNIC, ARIN, RIPE NCC, LACNIC and AFRINIC.
Ask "Who holds 1.1.1.1?" and the assistant gets this, instead of the 4–370 KB of raw RDAP JSON the registries return:
network 1.1.1.0/24 APNIC-LABS (AU, ASSIGNED PORTABLE, active)
holder APNIC Research and Development [ORG-ARAD1-AP]
abuse helpdesk@apnic.net [IRT-APNICRANDNET-AU]
tech research@apnic.net [AIC3-AP]
dates registered 2011-08-10, changed 2023-04-26
source APNIC RDAP, fetched just now
- Authoritative. Each query goes to the RIR that manages the resource, found from IANA's bootstrap registry, and the answer names its source.
- Compact. A typical answer is about 300 bytes, so it costs few tokens and leaves room in the conversation.
- No personal data. Contact details of individual people are never returned, cached or logged: the answer says "personal contact, not disclosed" instead. Role and organisation contacts, such as abuse mailboxes, are shown.
- Polite to the registries. Per-RIR rate limits (as low as 10 requests a minute for LACNIC), caching, request de-duplication, and a User-Agent that names whoever runs the server.
- Safe with untrusted text. Registry free-text is cleaned of control and invisible characters before it reaches the model.
| Tool | Answers | Example question |
|---|---|---|
rdap_ip_lookup |
Holder, range, country, status, abuse contact and dates for an IPv4/IPv6 address or prefix | "Where do I report abuse from 8.8.8.8?" |
rdap_asn_lookup |
Holder, country, abuse contact and dates for an AS number | "Who is AS4608?" |
rdap_entity_lookup |
An organisation or role handle seen in another answer | "What is ORG-ARAD1-AP?" |
rdap_reverse_dns |
The registered reverse-DNS zone, its nameservers and DNSSEC status | "What are the reverse DNS servers for 1.1.1.1?" |
rdap_history |
How a registration changed, or who held a resource on a date (APNIC only) | "Who held 1.1.1.1 on 2012-01-01?" |
The server deliberately does not search, list or bulk-query the registries, show routing (BGP) data, or query live DNS. On the shared HTTP server, a client that walks address space is suspended for 24 hours.
Requires Node 22 or newer and git. pnpm comes through Corepack; no global install is needed.
git clone https://github.com/IEISI-ORG/rir-mcp && cd rir-mcp
corepack pnpm install
claude mcp add rir-mcp -s user -e RIR_MCP_OPERATOR='noc@your-domain.example' -- \
"$PWD/node_modules/.bin/tsx" "$PWD/packages/node/src/stdio.ts"RIR_MCP_OPERATOR is required. It is a contact email or URL for whoever runs the server, and it is sent to the registries so they can reach you. Use a role mailbox or an issue-tracker URL, not a personal address.
Claude Desktop setup is in docs/deployment.md.
The same tools are available over MCP Streamable HTTP for a team or for clients that cannot launch a local process. Every request needs an API key.
export RIR_MCP_OPERATOR='noc@example.net'
export RIR_MCP_API_KEY="$(node_modules/.bin/tsx scripts/keys.ts new --raw)"
node_modules/.bin/tsx packages/node/src/cli.ts --http
# rir-mcp: listening on http://127.0.0.1:4608/mcp (auth: single)
claude mcp add --transport http rir-mcp http://127.0.0.1:4608/mcp --header "Authorization: Bearer $RIR_MCP_API_KEY"Per-user keys with hourly quotas, revocation, Host/Origin allow-lists and serving beyond localhost are covered in docs/deployment.md.
Early development. Interfaces and output may still change.
| Mode | Status |
|---|---|
| Local stdio (Claude Code, Claude Desktop) | Available |
| Self-hosted HTTP with API keys | Available |
| Cloudflare Workers | Available; not yet run on a live account |
| Docker image, npm package | Planned |
corepack pnpm test # offline, against recorded RDAP fixtures
corepack pnpm test:worker # Cloudflare Worker package, in workerd
corepack pnpm typecheck
RIR_MCP_OPERATOR='https://your-tracker.example/issues' corepack pnpm test:live # one live query per RIR| Package | Contents |
|---|---|
packages/core |
Runtime-neutral server: RDAP client, reducers, rendering, rate limits, auth. No Node or Cloudflare imports. |
packages/node |
stdio and HTTP entry points for Node. |
packages/worker |
Cloudflare Worker and Durable Object. |
The design is in docs/superpowers/specs/ and the implementation plans are in docs/superpowers/plans/.
Report bugs and registry problems at https://github.com/IEISI-ORG/rir-mcp/issues. Please don't include personal data from RDAP records in reports.
A licence and Terms of Use are being prepared. Until a LICENSE file is published here, no licence is granted to use, copy or modify this code. The terms will prohibit using the service for marketing to, spamming or harassing RIR members.