agentns_skill

Overview

This skill registers and manages ICANN domains for AI agents with integrated wallet authentication and USDC payments. It supports EVM (Base) and Solana wallets, handles full DNS and nameserver control, and provides registrant profile management required by ICANN. Designed for programmatic workflows, it automates payment, WHOIS privacy, and DNS operations so agents and projects can own and operate domains securely.

How this skill works

The client inspects domain availability and pricing (no auth required), then authenticates the user via signature-based wallet login (SIWE/SIWS). After creating or ensuring a registrant profile, the skill registers domains by charging USDC on Base or Solana and returns registration metadata. It also exposes DNS CRUD, nameserver configuration, and domain listing endpoints for ongoing management.

When to use it

• Register a new domain for an AI agent or project and pay in USDC on Base or Solana.
• Check availability and search for alternatives across 20 popular TLDs before buying.
• Programmatically add, update, or delete DNS records for service endpoints.
• Set custom nameservers (e.g., migrate to Cloudflare) or query current NS.
• Manage ICANN-required registrant contact info and WHOIS privacy centrally.

Best practices

• Create or ensure the registrant profile once before attempting registration to avoid failures.
• Fund your wallet with sufficient USDC on the chosen network (Base or Solana) before checkout.
• Use wallet re-authentication (client.login()) when receiving AuthenticationError to refresh JWTs.
• Enable WHOIS privacy (default) to protect contact details and reduce spam.
• Handle PaymentRequiredError by prompting for the required USDC amount and wallet address.

Example use cases

• Reserve a brand domain for a new agent, then add A and CNAME records to point to deployed services.
• Bulk-search a preferred name across common TLDs and programmatically purchase the cheapest available option.
• Automate DNS updates for agents that scale across environments by scripting record adds/updates.
• Transfer DNS control to a managed provider by setting custom nameservers via the client API.
• Maintain an agent fleet’s domain inventory with list_domains() and scheduled expiry checks.