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:

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:

export AGIETH_API_KEY="agieth_your_key_here"
export AGIETH_EMAIL="[email protected]"
# 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
[email protected]
# 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="[email protected]"
)

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

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: [email protected]