Agieth

Purchase domains, manage DNS and Cloudflare settings via agieth.ai Agent Bridge

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

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="[e-mail]"
# 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=[e-mail]
# 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="[e-mail]"
)

# 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

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

• API Docs: https://api.agieth.ai/api/v1/manifest
• Homepage: https://agieth.ai
• Skill Guide: https://github.com/larkins/one_shot_site
• Support: [e-mail]