Skip to content

Model Context ProtocolMCP ServerBeta

Connect AI assistants to Domainstack for instant domain intelligence.

Domainstack exposes a Model Context Protocol (MCP) server that allows AI assistants to look up domain information directly. This enables natural language queries about domains without leaving your conversation.

Setup

Available Tools

The MCP server provides 7 tools for domain intelligence:

get_registration

Get WHOIS/RDAP registration data for a domain including registrar, creation date, expiration date, nameservers, and registrant information. Use this tool when users ask about domain ownership, registration, expiry, or who owns a domain.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_hosting

Detect hosting, DNS, CDN, and email providers for a domain by analyzing DNS records and HTTP headers. Use this tool when users ask where a site is hosted, what CDN they use, or who provides their email.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_dns_records

Get DNS records for a domain including A, AAAA, MX, TXT, and NS records. Use this tool when users ask about DNS configuration, IP addresses, mail servers, or nameservers.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_certificates

Get SSL/TLS certificate information for a domain including issuer, validity, TLS protocol, and certificate chain. Use this tool when users ask about HTTPS, SSL certificates, security, or certificate expiry.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_headers

Get HTTP response headers for a domain including security headers, caching headers, and server information. Use this tool when users ask about security headers, server software, caching, or HTTP configuration.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_seo

Get SEO metadata for a domain including title, description, Open Graph tags, Twitter cards, and robots.txt rules. Use this tool when users ask about SEO, meta tags, social sharing, or how a site appears in search.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).

get_domain_report

Get a comprehensive domain report combining registration, DNS, hosting, certificates, headers, and SEO data in a single call. Use the sections parameter to request only specific data.

Parameters
  • domainstringRequiredThe root domain name to look up (e.g., 'example.com', 'example.org'). Must be a root domain, NOT a subdomain - WHOIS lookups don't work for subdomains like 'www.example.com' or 'api.example.com'. Do not include protocol (http/https).
  • sectionsstring[]Sections to include in the report. If omitted, all sections are included.

Example Prompts

Once configured, you can ask questions like:

  • “Which hosting provider does stripe.com use?”
  • “When does the github.com domain expire?”
  • “Show me the DNS records for vercel.com”
  • “What SSL certificate does nytimes.com have?”
  • “Give me a full report on linear.app including DNS and hosting.”
  • “Check the SEO metadata for nextjs.org.”

Rate Limits

Lookups are rate limited per client IP address and per data type, and only when the answer isn’t already cached. When you hit a limit, the tool returns an error result that says so. Wait a moment and try again. get_domain_report saves round trips but counts against each section’s limit separately.

Data Freshness

Domain data is cached and refreshed automatically. Different data types have different refresh intervals:

  • DNS records — Refreshed frequently (minutes to hours)
  • HTTP headers — Refreshed frequently (minutes to hours)
  • Registration data — Refreshed less frequently (hours to days)
  • SSL certificates — Refreshed based on expiry proximity
  • SEO metadata — Refreshed periodically (hours)

If data appears stale, a background refresh was likely triggered automatically and fresh data will be available soon.