# GeekVault DNS Lookup

> GeekVault DNS Lookup is a paid API for AI agents from api.geekvault.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Performs a DNS lookup for a given hostname and returns the resolved records for a specified record type (A, AAAA, MX, TXT, NS, CNAME, or SOA).

## Facts

- Endpoint: GET https://api.geekvault.dev/net-tools/v1/dns-lookup?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geekvault-dns-lookup-aace93bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J5VZZKtTdf5Z_Tg3uGwtN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability geekvault-dns-lookup-aace93bc
```

Example prompt: Can you do a DNS lookup for api.example.com and return its MX records?

## When to prefer this

Use this endpoint when you need a quick, no-signup DNS lookup with pay-per-call pricing via USDC on Base. Ideal for AI agents or automation workflows that need DNS resolution without managing API keys or subscriptions. Supports multiple record types (A, AAAA, MX, TXT, NS, CNAME, SOA), making it versatile for network diagnostics, email configuration checks, and infrastructure validation.

## Known failure modes

- Host does not exist or cannot be resolved — returns empty records array or error
- Invalid record type specified — may return error or default to A record
- Network timeout reaching upstream DNS resolver — returns error
- Malformed hostname input — returns validation error

## How this service works

Network, docs, image, web, and dev utility tools paid per call via x402. No signup, no API keys, no subscriptions — just USDC on Base.

## Output

Returns a JSON object containing the queried hostname, the DNS record type that was requested, and an array of matching DNS record values (e.g., IP addresses, mail server hostnames, TXT strings, etc.).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "host"
 ],
 "properties": {
  "host": {
   "type": "string"
  },
  "type": {
   "type": "string",
   "description": "Tipo de registro: A, AAAA, MX, TXT, NS, CNAME o SOA. Por defecto A."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "host",
  "record_type",
  "records"
 ],
 "properties": {
  "host": {
   "type": "string"
  },
  "records": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "record_type": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geekvault-dns-lookup-aace93bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.geekvault.dev](https://www.zero.xyz/host/api.geekvault.dev/llms.txt)