Skip to main content
Glama

NetAPI MCP server

An MCP server that gives AI assistants and agents (Claude, Cursor, ChatGPT, Windsurf, VS Code Copilot and any other MCP client) access to NetAPI domain intelligence: registered domains of 1,584 TLDs, newly registered and deleted domains, DNS-provider and registrar data, the free NetAPI Top 1M popularity ranking and the compromised domain / IP feed.

Endpoints (Streamable HTTP):

URL

Who

What

https://mcp.netapi.com/mcp

signed-in NetAPI account (OAuth, or Authorization: Bearer <api_token>)

all tools; a free account is enough for the free tools with higher limits, a plan unlocks the paid ones

https://mcp.netapi.com/mcp/public

no account

the free tools only (the account and plan tools are not listed there), anonymous limits

Tools

Free (no plan needed):

Tool

What it answers

check_compromised

Is this domain or IP in the compromised feed (malware, phishing, abuse)? Seen in the last 24 h (an IP: 48 h) or ever, block reason, registrar.

search_new_domains

Domains registered in the last 1-7 days that contain a string: brand monitoring, typosquatting, phishing, keyword trends.

tld_stats

Registry, active domains, new / deleted in 24 h, growth over 7-365 days, abuse rate, Top 1M presence, policies of a TLD.

domain_rank

Rank of a domain in the NetAPI Top 1M and inside its TLD.

top_websites

The most popular websites of a country or TLD (Germany = .de, .fr, .io ...).

top_1m

A slice of the Top 1M list.

registrar_info

Size, rank and abuse rate of a registrar.

dns_provider_info

Domains, market share and growth of a DNS provider.

list_zones

All 1,584 zones with their figures.

With a NetAPI plan:

Tool

What it answers

lookup_domain

Nameservers, IP, country, registration / expiration dates, registrar of a domain.

lookup_ip

Domains hosted on an IP (reverse IP).

get_download_url

A 24-hour link to a domain list or dataset file: the domains of a zone (active / new / deleted, one zone or all zones), of a DNS provider or of a registrar. Lists = domain names (any plan), datasets = one row per domain with nameservers, IP, country, emails, phones (Plus or Pro).

account_info

Plan and limits of the connected account.

Free data (Top 1M, compromised feeds) is published under CC BY 4.0: credit NetAPI and link to https://netapi.com/. Full description of the tools and the connection steps: netapi.com/help/mcp/.

Related MCP server: AgentDomain

Connect

The server speaks standard MCP OAuth (authorization server https://netapi.com, dynamic client registration, PKCE), so clients that support it show a NetAPI sign-in when you add https://mcp.netapi.com/mcp: sign in with your email code or Google, click Allow access, done. Connected apps are listed in your dashboard, where you can disconnect them.

claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → URL https://mcp.netapi.com/mcp → Connect.

ChatGPT: install NetAPI from the ChatGPT plugin directory and sign in when asked. Developer mode still works: Settings → Connectors → Add → MCP server URL https://mcp.netapi.com/mcp, authentication OAuth.

Claude Code

claude mcp add --transport http netapi https://mcp.netapi.com/mcp

then /mcp inside Claude Code to sign in. Without an account:

claude mcp add --transport http netapi https://mcp.netapi.com/mcp/public

Cursor (~/.cursor/mcp.json or the project's .cursor/mcp.json): Cursor signs in through OAuth when you add the URL; a NetAPI API token works as well:

{
  "mcpServers": {
    "netapi": {
      "url": "https://mcp.netapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

Other clients: add a remote MCP server of type "http" / "streamable-http" with one of the URLs above.

Rate limits

Without an account (/mcp/public): 30 requests per minute and 1,000 per day per IP for point lookups, 10 / 200 for list tools, 6 / 100 for search_new_domains (100 results per call). A free NetAPI account raises them to 60 / 5,000, 30 / 1,000 and 30 / 500 (500 results per call); paid plans raise them further, unlock lookup_domain, lookup_ip and get_download_url, and Pro has no daily caps. Limits and error messages come from the JSON API: see the request-limit table and the MCP server page.

How it works

The Worker is a thin layer: every tool call is one GET request to the NetAPI JSON API (https://netapi.com/api-json/), the answer is returned to the client as JSON text. Tokens are validated by the site and cached for a minute; nothing else is stored in the Worker. /.well-known/oauth-protected-resource points clients to the authorization server. Files are never streamed through it: get_download_url returns a temporary link instead.

Development

npm install
npm run typecheck
npm run dev        # http://localhost:8787/mcp (and /mcp/public)
npm run deploy     # wrangler deploy (or connect the repo in the Cloudflare dashboard)

Test with the MCP Inspector: npx @modelcontextprotocol/inspector, add a Streamable HTTP server with http://localhost:8787/mcp/public (or the production URL to test the sign-in).

Run locally over stdio

The same tools without the Worker, for MCP clients that start a local process (and for directories that build the server in a container):

npm install
npm run stdio      # tsx src/stdio.ts

Without a token it offers the free tools with anonymous limits, like /mcp/public. Set NETAPI_API_TOKEN to a NetAPI API token for the account tools and the limits of your plan. Every tool call is one GET to https://netapi.com/api-json/ (NETAPI_JSON_API overrides it).

MCP Registry

The server is listed in the MCP Registry as com.netapi/mcp (remote https://mcp.netapi.com/mcp); server.json is its manifest. A new version: bump version in server.json, mcp-publisher login http --domain netapi.com (domain proof via /.well-known/mcp-registry-auth; dns works too), then mcp-publisher publish from this directory.

License

MIT for the code in this repository. NetAPI data is subject to the Terms of Service; the free datasets are CC BY 4.0.

Available Tools

9 tools
check_compromisedCheck a domain or IP against the compromised feedA
Read-onlyIdempotent
Inspect

Is a domain name or IP address in the NetAPI compromised feed (malware, phishing, abuse)? Returns whether it was seen in the last 24 hours (listed_now), ever (listed_ever), first/last seen dates, the block reason and the registrar. Subdomains are matched against their parent domains too. Free, no account needed.

Inputs: value (required).

dns_provider_infoDNS provider profile and market shareA
Read-onlyIdempotent
Inspect

Number of domains using a DNS (nameserver) provider, its market share and rank, share change over 30 days and one year, one-year growth. Matches by alias ("cloudflare"), name or nameserver root ("awsdns"). The returned alias is what get_download_url takes as dns_alias for the list of all domains using the provider. Free.

Inputs: query (required).

domain_rankPopularity rank of a domain (NetAPI Top 1M)A
Read-onlyIdempotent
Inspect

Position of a domain in the NetAPI Top 1 Million most popular domains (1 = most popular) and its rank inside its own TLD. Rebuilt daily from SEO / link-graph and traffic signals. Free.

Inputs: domain (required).

list_zonesList all domain zones (TLDs)A
Read-onlyIdempotent
Inspect

Every TLD NetAPI tracks (1,584 zones) with active domains, new and deleted domains in the last 24 hours, whether it is a ccTLD and whether it is updated daily. Filter by minimum size or ccTLD / gTLD. Free.

Inputs: cctld, min_domains.

registrar_infoDomain registrar profileA
Read-onlyIdempotent
Inspect

Size, rank and abuse figures of a domain registrar: number of domains, rank by size, compromised domains and abuse rate versus the overall rate, link to the registrar page. Matches by brand ("GoDaddy"), legal name or numeric id. The returned id is what get_download_url takes as registrar_id for the list of all domains of the registrar. Free.

Inputs: query (required).

search_new_domainsSearch newly registered domainsA
Read-onlyIdempotent
Inspect

Find domain names registered in the last 1-7 days that contain (or start with) a string: brand monitoring, typosquatting, phishing campaigns, keyword trends. Covers every TLD NetAPI updates daily (.com, .net, .org, .ru, .fr, .ch and 1,100+ more). Free with limits: up to 100 results per call without an account, more with a NetAPI plan. The complete daily lists of new domains are available to subscribers via get_download_url.

Inputs: query (required), tld, days, limit, +1 more.

tld_statsStatistics of a domain zone (TLD)A
Read-onlyIdempotent
Inspect

Everything NetAPI knows about one TLD: registry, number of active domains, new and deleted domains in the last 24 hours, growth over 7/30/90/365 days, rank among all 1,584 zones, share of all domains, compromised domains and abuse rate, presence in the Top 1M, registry policies, RDAP server and a description. Free.

Inputs: tld (required).

top_1mNetAPI Top 1M most popular domains (slice)B
Read-onlyIdempotent
Inspect

A slice of the NetAPI Top 1 Million most popular domains, ordered by rank. The complete list is a free daily CSV (https://netapi.com/netapi_top1mln.csv, CC BY 4.0). Free.

Inputs: limit, offset.

top_websitesMost popular websites of a country or TLDA
Read-onlyIdempotent
Inspect

The most popular domains of one TLD or country (a slice of the NetAPI Top 1M), e.g. the top websites of Germany (.de) or of .io, with their global rank. A country means its ccTLD: sites of that country on .com are not included. Available for the ~80 TLDs with at least 1,000 domains in the Top 1M. Up to 1,000 rows via offset/limit; the full slice is a free CSV linked in the answer. Pass tld or country. Free.

Inputs: tld, limit, offset, country.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools target clearly different resources: reputation lookup (check_compromised), nameserver provider stats (dns_provider_info), new registrations (search_new_domains), registrar stats (registrar_info) and per-zone stats (tld_stats). The ranking cluster (domain_rank, top_websites, top_1m) and the TLD cluster (tld_stats vs list_zones) partially overlap, and an agent could plausibly pick top_1m where top_websites was intended if top_1m also accepts a TLD filter.

    Naming Consistency3/5

    The set mixes verb_noun names (check_compromised, search_new_domains, list_zones) with bare noun phrases (tld_stats, domain_rank, registrar_info, top_websites, top_1m). The noun-style names are internally consistent, but the two conventions coexist with no discernible rule for which is used.

    Tool Count5/5

    Nine tools is well within the sweet spot and each covers a distinct facet of domain/TLD intelligence (reputation, registration recency, ranking, registrar, DNS provider, zone inventory). No obvious padding or redundancy in the count.

    Completeness3/5

    Coverage of the domain-intelligence domain is broad, but three tool descriptions (dns_provider_info, search_new_domains, registrar_info) explicitly hand off to a get_download_url tool that does not exist in this surface, creating dead ends for bulk/listing workflows. There is also no bulk download or full-list retrieval operation exposed here, so agents hitting the free-result limits cannot escalate.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.
      4
      43 npm
      22
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      AgentDomain MCP allows AI agents to register, buy, and manage internet domains via the Model Context Protocol. Features include domain search, availability check, purchase, DNS record management, and wallet operations.
      13
      104 PyPI
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for domain intelligence — WHOIS, DNS records, SSL certificate inspection, SPF/DMARC validation, security-header audits, and blacklist/reputation checks, callable by AI agents. Powered by domainintel.app; runs server-side, no local setup.
      7
      71 npm
      MIT