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:

VariableRequiredDescriptionAGIETH_API_KEYYesYour agieth.ai API keyAGIETH_EMAILYesEmail associated with your API keyETH_WALLET_PRIVATE_KEYOnly for paymentsEthereum private key — only needed for send_payment. You can also use any external wallet instead.ETH_RPC_PRIMARYNoEthereum RPC endpoint — defaults to https://ethereum.publicnode.com``ETH_RPC_FALLBACKNoFallback RPC — defaults to https://eth.drpc.org``cloudflaredNoOnly 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#

1. Get an API key from api.agieth.ai
2. Set environment variables:

bash

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:

text

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#

python

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#

python

# 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#

python

# 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)#

python

# 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)#

python

# 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#

python

# Check balance
balance = client.get_balance()

# Check credits
credits = client.get_credits()

Pricing#

ServiceCostDomain registrationRegistrar price + markupCloudflare DNSFREECloudflare TunnelFREESSL CertificatesFREE

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#

• API Docs: https://api.agieth.ai/api/v1/manifest
• Homepage: https://agieth.ai
• Skill Guide: https://github.com/larkins/one_shot_site
• Support: support@agieth.ai