io.github.venomseven/nslookup

Official11 tools

by NsLookup-io · TypeScript

DNS lookups, health reports, SSL certs, security scans, GEO scoring, uptime checks

Perform DNS lookups, SSL certificate checks, security scans, and uptime monitoring.

Captured live from the server via tools/list.

dns_lookup

Look up all common DNS records (A, AAAA, NS, MX, TXT, CNAME, SOA) for a domain. Returns results from a specified DNS server.

Parameters (2)

domainstringrequired
Domain name to look up (e.g. example.com)
serverstring
DNS server to query. Default: cloudflare. Use 'authoritative' for the domain's own nameservers.

dns_record

Look up a specific DNS record type for a domain. Supports 53 record types including A, AAAA, MX, TXT, CNAME, SOA, PTR, CAA, SRV, DNSKEY, DS, TLSA, HTTPS, SPF, and more.

Parameters (3)

domainstringrequired
Domain name (or IP address for PTR lookups) to query (e.g. example.com)
typestringrequired
DNS record type (e.g. A, MX, TXT, CNAME, SPF, HTTPS, DNSKEY)
serverstring
DNS server to query. Default: cloudflare. Use 'authoritative' for the domain's own nameservers.

dns_propagation

Check DNS propagation for a domain across 18+ global DNS servers (Cloudflare, Google, Quad9, OpenDNS, regional servers, and authoritative nameservers). Shows if DNS changes have propagated worldwide.

Parameters (2)

domainstringrequired
Domain name to check propagation for (e.g. example.com)
recordTypestringrequired
DNS record type to check (e.g. A, AAAA, MX, NS, TXT, CNAME)

webservers

Get the IP addresses (both IPv4 and IPv6) for a domain by looking up A and AAAA records. Also returns the punycode and unicode domain representations.

Parameters (1)

domainstringrequired
Domain name to look up IP addresses for (e.g. example.com)

ssl_certificate

Check the SSL/TLS certificate for a domain. Returns issuer, expiry date, days until expiry, certificate chain validity, cipher strength, SAN domains, fingerprint, and TLS protocol version.

Parameters (1)

domainstringrequired
Domain name to check SSL certificate for (e.g. github.com)

bimi_vmc

Check BIMI (Brand Indicators for Message Identification) and VMC (Verified Mark Certificate) for a domain. Returns BIMI DNS record status, VMC certificate details, logo URL, trademark info, and expiry.

Parameters (1)

domainstringrequired
Domain name to check BIMI/VMC for (e.g. google.com)

security_scan

Run a security scan on a domain to detect DNS misconfigurations, missing SPF/DKIM/DMARC records, cookie security issues, and other web security vulnerabilities. Returns findings with severity levels (critical, high, medium, low, info).

Parameters (1)

domainstringrequired
Domain name to security scan (e.g. example.com)

uptime_check

Perform a one-time HTTP uptime check on a URL from a single location. Returns whether the site is up or down, HTTP status code, and response time in milliseconds. For multi-location checks, use uptime_check_multi instead.

Parameters (2)

urlstringrequired
Full URL to check (e.g. https://github.com)
timeoutnumber
Timeout in milliseconds (default: 10000)

uptime_check_multi

Check if a website is up or down from 7 global locations simultaneously: Amsterdam, Sydney, London, Frankfurt, Delhi, Warsaw, and South Carolina. Returns status, response time, and HTTP status code for each location.

Parameters (2)

urlstringrequired
Full URL to check (e.g. https://github.com)
timeoutnumber
Timeout in milliseconds (default: 30000)

dns_health

Run a comprehensive DNS health audit on a domain — 39 checks across 7 categories: DNSSEC (chain of trust, algorithms, validation), MX & email (PTR, MTA-STS, redundancy), DNS hygiene (SPF conflicts, wildcards, apex CNAME), TTL & SOA configuration, nameserver setup (diversity, lame delegation, EDNS0), CAA certificates, and operational maturity (security.txt, abuse mailbox). Returns an overall severity-weighted score (0–100) plus per-category scores.

Parameters (1)

domainstringrequired
Domain name to check DNS health for (e.g. example.com)

geo_checker

Check a domain's GEO (Generative Engine Optimization) score — how well the site is optimized for AI search engines like ChatGPT, Gemini, Claude, and Perplexity. Returns three scores (Technical Readiness, Entity Readiness, Answer Readiness), AI crawler access status, structured data analysis, and prioritized recommendations.

Parameters (1)

domainstringrequired
Domain name to check GEO score for (e.g. github.com)

README.md6 KBView on GitHub

<a href="https://nslookup.io"> <img src="https://www.nslookup.io/img/logo.svg" alt="NSLookup.io" width="300" /> </a> MCP Server for nslookup.io DNS lookups, SSL certificate checks, security scanning, GEO (AI readiness) scoring, and domain intelligence — via the Model Context Protocol. <a href="https://nslookup.io">Website</a> · <a href="https://docs.nslookup.io">API Docs</a> · <a href="https://www.npmjs.com/package/@nslookup-io/mcp-server">npm</a> · <a href="https://nslookup.io/contact-us/">Contact</a>

Tools

DNS Tools

Tool	Description
`dns_lookup`	Look up all common DNS records (A, AAAA, NS, MX, TXT, CNAME, SOA) for a domain
`dns_record`	Look up a specific DNS record type — supports all 53 types (HTTPS, DNSKEY, TLSA, SPF, etc.)
`dns_propagation`	Check DNS propagation across 18+ global servers (Cloudflare, Google, Quad9, regional, authoritative)
`webservers`	Get IPv4 and IPv6 addresses for a domain

DNS Health & Security Tools

Tool	Description
`dns_health`	NEW — Run a DNS health audit (39 checks across DNSSEC, MX, hygiene, TTL, nameservers, CAA, operational maturity) with severity-weighted scoring
`ssl_certificate`	Check SSL/TLS certificate — issuer, expiry, chain validity, cipher strength, SAN domains, TLS version
`bimi_vmc`	Check BIMI record and VMC (Verified Mark Certificate) — logo URL, trademark info, certificate expiry
`security_scan`	Scan a domain for security issues — SPF/DKIM/DMARC, cookie security, DNS misconfigurations
`uptime_check`	One-time HTTP uptime check — status, response time, HTTP status code
`uptime_check_multi`	Check if a site is up from 7 global locations — Amsterdam, Sydney, London, Frankfurt, Delhi, Warsaw, South Carolina

GEO (AI Readiness) Tools

Tool	Description
`geo_checker`	Check a domain's GEO (Generative Engine Optimization) score — AI crawler access, structured data, entity signals, content extractability, and prioritized recommendations

Setup

Claude Desktop — Remote Connector (Recommended)

The easiest way to get started. No installation required.

Open Claude Desktop
Go to Settings (click your profile icon or use the menu)
In the left sidebar, click Connectors
Click "Add custom connector" at the bottom
Enter the following:
- Name: nslookup
- URL: https://mcp.nslookup.io/mcp
Click Add to confirm

Done — Claude can now use all 11 DNS, security, and health tools. Try asking "Run a DNS health check on github.com".

ChatGPT

Open ChatGPT (desktop app or web)
Go to Settings (click your profile icon)
Navigate to Connected apps (or Tools & integrations)
Click "Add custom integration" or "Add MCP server"
Enter the following:
- Name: nslookup
- URL: https://mcp.nslookup.io/mcp
Save the connection

Done — ChatGPT can now perform DNS lookups, certificate checks, and security scans.

Any MCP Client (Remote)

Any MCP-compatible client that supports Streamable HTTP transport can connect using:

code

https://mcp.nslookup.io/mcp

No API key or authentication required.

Claude Desktop — Local (via config JSON)

If you prefer running the server locally (requires Node.js 18+), add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": ["-y", "@nslookup-io/mcp-server"]
    }
  }
}

Claude Code

Available globally (all projects):

bash

claude mcp add nslookup --scope user -- npx -y @nslookup-io/mcp-server

Or for a specific project only:

bash

claude mcp add nslookup --scope project -- npx -y @nslookup-io/mcp-server

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

json

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": ["-y", "@nslookup-io/mcp-server"]
    }
  }
}

Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

json

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": ["-y", "@nslookup-io/mcp-server"]
    }
  }
}

Supported DNS Record Types

A, AAAA, AFSDB, APL, AXFR, CAA, CDNSKEY, CDS, CERT, CNAME, CSYNC, DHCID, DLV, DNAME, DNSKEY, DS, EUI48, EUI64, HINFO, HIP, HTTPS, IPSECKEY, IXFR, KEY, KX, LOC, MX, NAPTR, NS, NSEC, NSEC3, NSEC3PARAM, NXT, OPENPGPKEY, OPT, PTR, RP, RRSIG, SIG, SMIMEA, SOA, SPF, SRV, SSHFP, SVCB, TA, TKEY, TLSA, TSIG, TXT, URI, ZONEMD

DNS Servers

cloudflare, google, quad9, opendns, authoritative, and regional servers in South Africa, Australia, India, Netherlands, Canada, USA, Brazil, Ukraine, Russia.

Configuration

Environment Variable	Default	Description
`NSLOOKUP_API_URL`	`https://www.nslookup.io`	Base URL for the nslookup.io API

Example Prompts

Once connected, try asking your AI assistant:

"What are the DNS records for github.com?"
"Check the MX records for google.com"
"Has the DNS propagated for my-domain.com A record?"
"What IP addresses does cloudflare.com resolve to?"
"Show me the DNSKEY records for example.com"
"Check the SPF record for amazon.com"
"Run a DNS health check on example.com"
"What's the DNSSEC status of cloudflare.com?"
"Check the DNS health score for my-domain.com — are there any critical issues?"
"Check the SSL certificate for github.com"
"Does google.com have a BIMI record?"
"Run a security scan on example.com"
"Is https://cloudflare.com up right now?"
"Check if github.com is accessible from all global locations"
"Check DNS propagation for example.com NS records across all global servers"
"Check the GEO score for github.com"
"Is example.com optimized for AI search engines?"
"Which AI crawlers does cloudflare.com block?"

Feedback

We'd love to hear from you! At nslookup.io, we're building a fast, reliable, and free DNS lookup tool and monitoring platform for everyone — from developers and sysadmins to everyday internet users.

Your feedback is what helps us improve. Whether you've spotted a bug, have a feature idea, or just want to share your thoughts — we're listening. Contact us.

License

Apache 2.0

Install

claude_desktop_config.json

{
  "mcpServers": {
    "nslookup": {
      "command": "npx",
      "args": [
        "-y",
        "@nslookup-io/mcp-server@1.3.0"
      ]
    }
  }
}