Veridomo — DNS toolkit for AI agents

Zero-dependency npm package. One command to give your AI agents DNS superpowers.

npx veridomo signup          # get an API key in 30 seconds
npx veridomo                 # launch the MCP server

Quick start

1. Sign up (30 seconds)

npx veridomo signup

Opens veridomo.xyz in your browser. Plans from $5 for 50 verifications (no expiry). Subscriptions from $29/month.

2. Add to Claude Desktop / Cursor

{
  "mcpServers": {
    "veridomo": {
      "command": "npx",
      "args": ["-y", "veridomo"],
      "env": { "VERIDOMO_API_KEY": "vdo_xxx" }
    }
  }
}

3. Your agents now have 8 DNS tools

Ask Claude: "Check if myapp.com has valid SPF and SSL" — it just works.

Tools (what your agent gets)

| Tool | Runs where | Description | |---|---|---| | generate_challenge | Local | Generate a vdo-2 verification challenge + DNS instructions | | validate_token | Local | Validate a vdo-2 token is bound to a domain | | get_verification_instructions | Local | Get exact DNS records to create for verification | | verify_domain | Remote | Verify domain ownership (DNS TXT, CNAME, HTTP, meta tag) | | dns_lookup | Remote | Query A, AAAA, MX, TXT, NS, CNAME, PTR records | | ssl_check | Remote | SSL/TLS cert chain, expiry, SANs | | whois_lookup | Remote | Registrar, expiry, nameservers | | email_auth_audit | Remote | SPF, DKIM, DMARC pass/warn/fail |

3 tools run locally — no API key needed. Try challenge generation right now.

5 tools require an API key — sign up at veridomo.xyz.

JavaScript API

Import the client library:

import Veridomo from 'veridomo';

const v = new Veridomo('vdo_xxx');

// Local (no network)
const challenge = v.generateChallenge('myapp.com');
// → { token, instructions: { dns_txt, dns_cname, http_file, meta_tag } }

const valid = v.validateToken('vdo-2;myapp.com;abc;123', 'myapp.com');
// → { valid: true, domain: 'myapp.com' }

// Remote (needs API key + network)
await v.dnsLookup('example.com', 'A');
await v.sslCheck('veridomo.xyz');
await v.whoisLookup('github.com');
await v.emailAuthAudit('gmail.com');

Error breadcrumbs

Every error guides you to the next step:

| Response | Meaning | Do this | |---|---|---| | 401 | Invalid or expired key | Sign up at veridomo.xyz | | 402 | Payment required | Complete checkout at veridomo.xyz | | 429 | Monthly limit exceeded | Upgrade at veridomo.xyz/checkout | | Network error | API unreachable | Check veridomo.xyz/status |

Supported MCP hosts

• Claude Desktop — copy config from above
• Cursor — .cursor/mcp.json
• Goose — add to mcp_servers config
• Smithery.ai — search "veridomo" in the registry
• Any MCP-compatible host — JSON-RPC 2.0, stdio transport

Install

npm install veridomo

Zero dependencies. Works in Node.js 18+, Deno, Bun, browsers.

License

MIT — veridomo.xyz