# 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](/app/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:

```sh
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

```sh
curl "https://api.dnssuper.com/v1/dns?domain=example.com&types=A,MX" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"
```

Python (httpx)

```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 (fetch)

```ts
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](/docs/responses) explains every field. If something goes wrong you get an error with a stable
`code` and a plain message instead; [errors](/docs/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)

```json
{
  "mcpServers": {
    "dnssuper": {
      "type": "http",
      "url": "https://mcp.dnssuper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Then call the tool

```json
{
  "tool": "lookup_dns",
  "arguments": {
    "domain": "example.com",
    "types": "A,MX"
  }
}
```

[MCP server](/docs/mcp) has the setup for Claude, Cursor, VS Code and other clients.

## Next steps

- Browse the [tool reference](/docs/tools) to see what else you can check.
- Learn [what each call costs](/docs/credits) and how cached answers work.
- Run a check on hundreds of domains at once with [bulk checks](/docs/bulk-and-jobs).
