Quickstart
This page takes you from nothing to a working call. You need a free account and a terminal.
Make an API key
Sign in, open API keys in the dashboard and choose Create key. Copy the key when it is shown: it appears once, and we only keep a hash of it. Then put it in an environment variable so it never ends up in your code:
export DNSSUPER_API_KEY="paste your key here"
Every account gets 500 credits each month on the free plan, which is enough to try every tool.
Make your first call
A DNS lookup of example.com, asking for its A and MX records, costs 1 credit:
curl
curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \
-H "Authorization: Bearer $DNSSUPER_API_KEY"Python
import os
import httpx
client = httpx.Client(
base_url="https://api.dnssuper.com",
headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
timeout=60,
)
response = client.get("/v1/dns", params={
"domain": "example.com",
"types": "A,MX",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])TypeScript
const response = await fetch(`https://api.dnssuper.com/v1/dns?${new URLSearchParams({"domain":"example.com","types":"A,MX"})}`, {
headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}` },
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);Read the result
Every tool answers with the same shape. The parts you'll use most:
summary: one plain sentence saying what was found.findings: problems and notes, each with a severity (fail,warn,infoorpass), a title, the detail and a fix.data: the tool's own result. For a DNS lookup that's the records by type, with their TTLs.credits_usedandcredits_remaining: what the call cost and what's left.
Responses explains every field. If something goes wrong you get an error with a stable
code and a plain message instead; errors lists them all.
Try it from your AI agent
The same check works over MCP. Add the server to your client's config with your key, then ask your agent to look up a domain, or call the tool directly:
{
"mcpServers": {
"dnssuper": {
"type": "http",
"url": "https://mcp.dnssuper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}{
"tool": "lookup_dns",
"arguments": {
"domain": "example.com",
"types": "A,MX"
}
}MCP server has the setup for Claude, Cursor, VS Code and other clients.
Next steps
- Browse the tool reference to see what else you can check.
- Learn what each call costs and how cached answers work.
- Run a check on hundreds of domains at once with bulk checks.