agieth.ai API Skill
Interact with agieth.ai domain registration and management API.
Requirements
This skill requires an agieth.ai API key and email address:
| Variable | Required | Description |
|---|
AGIETH_API_KEY | Yes | Your agieth.ai API key |
AGIETH_EMAIL | Yes | Email associated with your API key |
ETH_WALLET_PRIVATE_KEY | Only for payments | Ethereum private key — only needed for send_payment. You can also use any external wallet instead. |
ETH_RPC_PRIMARY | No | Ethereum RPC endpoint — defaults to https://ethereum.publicnode.com |
ETH_RPC_FALLBACK | No | Fallback RPC — defaults to https://eth.drpc.org |
cloudflared | No | Only needed for Cloudflare Tunnel hosting. If you have a static IP, you can point DNS A records at it instead — no tunnel needed. |
API base URL is hardcoded to https://api.agieth.ai — no configuration needed.
How Payments Work
Domain registration payments are made on the Ethereum blockchain — the agieth API generates a unique payment address and ETH amount for each quote. You can pay using any Ethereum wallet (MetaMask, Rabby, hardware wallet, etc.) by sending the exact ETH amount to the address returned by the API — no private key needs to be provided to this skill.
The send_payment method is included as a convenience for fully-automated workflows. If you prefer manual payment or a different wallet, simply use the payment_address and price_eth from the quote response in your own wallet.
Summary:
- Payments are ETH transfers on the Ethereum blockchain
- No tokens, no smart contracts, no third-party custody of funds
- Payment address and amount are unique per quote and expire with the quote
- External RPC endpoints used:
https://ethereum.publicnode.com and https://eth.drpc.org
Installation
- Get an API key from api.agieth.ai
- Set environment variables:
export AGIETH_API_KEY="agieth_your_key_here"
export AGIETH_EMAIL="your_email@example.com"
# Only needed for automated payments (optional — see How Payments Work above):
export ETH_WALLET_PRIVATE_KEY="0x..."
Or create a .env file in your workspace:
AGIETH_API_KEY=agieth_your_key_here
AGIETH_EMAIL=your_email@example.com
# Only needed for automated payments:
ETH_WALLET_PRIVATE_KEY=0x...
# Optional RPC overrides:
ETH_RPC_PRIMARY=https://your-preferred-rpc
ETH_RPC_FALLBACK=https://your-fallback-rpc
Quick Start
from skill import AgiethClient
# Initialize with environment variables
client = AgiethClient()
# Or pass credentials directly
client = AgiethClient(
api_key="agieth_your_key_here",
email="your_email@example.com"
)
# Check domain availability
result = client.check_availability("example.com")
# {"available": True, "price_usd": 12.99}
All Methods
Domain Operations
# Check availability
client.check_availability("example.com")
# Create quote (starts registration)
quote = client.create_quote(
domain="example.com",
years=1,
registrar="namecheap"
)
# Get quote status
client.get_quote(quote_id)
# Check payment status
client.check_payment(quote_id)
# Get domain info
client.get_domain_info("example.com")
DNS Management
# List DNS records
client.list_dns_records("example.com")
# Add DNS record
client.add_dns_record(
domain="example.com",
record_type="A",
name="www",
value="192.168.1.1"
)
# Delete DNS record
client.delete_dns_record("example.com", record_id)
Cloudflare Integration (FREE)
# Create Cloudflare zone
zone = client.create_cloudflare_zone("example.com")
# List zones
zones = client.list_cloudflare_zones()
# Create DNS records in Cloudflare
client.create_cloudflare_dns_record(
zone_id=zone["zone_id"],
record_type="A",
name="@",
content="192.168.1.1"
)
# Create page rule (www redirect)
client.create_page_rule(
zone_id=zone["zone_id"],
target_url="www.example.com/*",
forward_url="https://example.com/$1"
)
Cloudflare Tunnel Hosting (optional — cloudflared not required)
# Create tunnel (no public IP needed)
result = client.create_tunnel("example.com", local_port=3000)
# Returns tunnel_token
# Run: cloudflared tunnel run --token <tunnel_token>
Alternative: If you have a static IP, you can skip cloudflared entirely. Just add an A record pointing to your static IP instead.
Balance & Credits
# Check balance
balance = client.get_balance()
# Check credits
credits = client.get_credits()
Pricing
| Service | Cost |
|---|
| Domain registration | Registrar price + markup |
| Cloudflare DNS | FREE |
| Cloudflare Tunnel | FREE |
| SSL Certificates | FREE |
Cloudflare Authorization
The tunnel feature uses agieth.ai's Cloudflare account — not yours. Agieth creates the tunnel, gives you a token, and Cloudflare sees all traffic as agieth's. You do NOT need your own Cloudflare API token for this skill to work.
Security Notes
- API keys should be treated as secrets
- Only provide keys with minimum required permissions
- Always verify the
payment_address returned by the API before sending crypto — the skill surfaces the address from the server response
- The skill sends the API key via the
Authorization: Bearer HTTP header exclusively (no query parameters)
- This skill makes network requests to:
https://api.agieth.ai (main API)https://ethereum.publicnode.com and https://eth.drpc.org (Ethereum blockchain RPC — for ETH balance checks and transaction broadcasting)https://cloudflare.com (via cloudflared tunnel, when tunnel feature is used — optional)
API Documentation
Full API documentation: https://api.agieth.ai/api/v1/manifest
Links
