Docs menu

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
curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"

Python

Python (httpx)
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

TypeScript (fetch)
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, info or pass), 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_used and credits_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:

MCP client config (JSON)
{
  "mcpServers": {
    "dnssuper": {
      "type": "http",
      "url": "https://mcp.dnssuper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Then call the tool
{
  "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