# MCP server

DNS Super runs a remote MCP server, so an AI agent can run every check itself and read a short summary it
can act on. The server speaks Streamable HTTP at:

`https://mcp.dnssuper.com/mcp`

It uses the same API keys, the same credits and the same prices as the REST API. There is nothing to
install.

## Connect your client

Make an API key under [API keys](/app/keys), then follow the page for your client:

- [Claude](/docs/mcp/claude): Claude Code and Claude Desktop.
- [Cursor](/docs/mcp/cursor)
- [VS Code](/docs/mcp/vs-code)
- [Other clients](/docs/mcp/other-clients): any client that speaks Streamable HTTP, and a bridge for
  clients that only start local servers.

Every client sends the key the same way, as an `Authorization: Bearer` header.

## What the agent gets back

Agents pay for every word they read, so each tool answers with a compact summary by default: the summary
line, the key facts, the findings by severity and the credits used, in a few lines. Pass `detail: "full"`
to get the whole result, the same JSON the REST API returns. Each tool's description says what it costs,
so an agent can pick the cheaper call.

## Tools

| MCP tool | Check | Price |
| --- | --- | --- |
| lookup_dns | DNS lookup | 1 credit |
| lookup_whois | WHOIS / RDAP | 2 credits |
| check_availability | Availability | 1 credit |
| check_dnssec | DNSSEC and nameservers | 2 credits |
| domain_report | Domain report | 10 credits |
| build_dns_record | SPF builder | Free |
| build_dns_record | DMARC builder | Free |
| build_dns_record | CAA builder | Free |
| validate_dkim_record | DKIM record validator | Free |
| convert_idn | IDN and punycode | Free |
| check_migration | Migration checker | 5 credits |
| check_dangling_records | Dangling record check | 1 credit per name |
| find_lookalikes | Lookalike detection | Free; 1 credit per 10 checked with check=true |
| export_expiry_calendar | Expiry calendar | 2 credits per name |
| audit_email | Email setup audit | 2 credits |
| check_mail_policies | MTA-STS, TLS-RPT, BIMI | 1 credit |
| analyze_email_headers | Email header analyzer | Free |
| verify_dkim_signature | DKIM signature verifier | Free |
| check_http | HTTP and security headers | 2 credits |
| audit_seo | Technical SEO audit | 3 credits; 8 credits with rendered=true |
| validate_structured_data | Structured data and hreflang | 2 credits |
| audit_accessibility | Basic accessibility | 2 credits; 5 credits with contrast=true |
| check_standard_files | Standard files | 1 credit |
| check_ai_crawlers | AI crawler access | 1 credit |
| check_social_preview | Social preview | 1 credit |
| get_site_metadata | Site metadata and logo | 1 credit |
| detect_tech_stack | Tech stack detection | 2 credits |
| trace_redirects | Redirect tracer | 1 credit |
| check_broken_links | Broken link checker | 5 credits per 50 pages |
| scan_cookies | Cookie and tracker scan | 5 credits |
| check_ssl | SSL check | 1 credit |
| decode_certificate | Certificate and CSR decoder | Free |
| lookup_ip | IP and network info | 1 credit |
| lookup_asn | ASN and IP ownership | 1 credit |
| check_ipv6 | IPv6 readiness | 1 credit |
| check_web_ports | Web port check | 1 credit |
| create_monitor | Monitors | See the tool page |
| list_monitors | Monitors | See the tool page |
| bulk_run | Bulk runs | See the tool page |
| get_job | Bulk runs | See the tool page |
| compare_domains | Compare view | See the tool page |

The parameters of each tool match its REST endpoint. The [tool reference](/docs/tools) shows every tool's
MCP call and a sample of its compact output.

## Good to know

- Errors come back as a plain message with the same `code` as the REST API. A failed call costs nothing.
- Long checks, such as bulk runs, start a job and return its ID; the agent can follow it with `get_job`.
- The same [rate limits](/docs/rate-limits) apply as for the REST API.
