agentdomain-mcp 0.1.0__tar.gz

agentdomain_mcp-0.1.0/.gitignore

@@ -0,0 +1 @@
+__pycache__/

agentdomain_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: agentdomain-mcp
+Version: 0.1.0
+Summary: MCP server for AgentDomain — domain registration API for AI agents
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# AgentDomain MCP Server
+
+MCP server for [AgentDomain](https://agentdomain.cloud) — register and manage domain names for AI agents.
+
+## Install
+
+```bash
+# Via uvx (recommended)
+uvx agentdomain-mcp
+
+# Via pip
+pip install agentdomain-mcp
+```
+
+## Configure
+
+Set your API key as an environment variable:
+
+```bash
+export AGENTDOMAIN_API_KEY="da_your_api_key_here"
+```
+
+Get a free API key at [agentdomain.cloud/dashboard](https://agentdomain.cloud/dashboard/).
+
+## Use with Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "agentdomain": {
+      "command": "uvx",
+      "args": ["agentdomain-mcp"],
+      "env": {
+        "AGENTDOMAIN_API_KEY": "da_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Use with Hermes Agent
+
+Add to `~/.hermes/config.yaml`:
+
+```yaml
+mcp_servers:
+  agentdomain:
+    command: "uvx"
+    args: ["agentdomain-mcp"]
+    env:
+      AGENTDOMAIN_API_KEY: "da_your_api_key_here"
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `domain_search` | Search for available domains |
+| `domain_check` | Check availability + price |
+| `domain_buy` | Register a domain |
+| `domain_list` | List your domains |
+| `domain_dns_get` | Get DNS records |
+| `domain_dns_update` | Update DNS records |
+| `domain_transfer` | Get EPP auth code |
+| `wallet_balance` | Check balance |
+| `wallet_topup` | Create crypto top-up invoice |
+| `wallet_transactions` | List recent transactions |
+| `account_info` | Get account info |
+
+## License
+
+MIT

agentdomain_mcp-0.1.0/README.md

@@ -0,0 +1,74 @@
+# AgentDomain MCP Server
+
+MCP server for [AgentDomain](https://agentdomain.cloud) — register and manage domain names for AI agents.
+
+## Install
+
+```bash
+# Via uvx (recommended)
+uvx agentdomain-mcp
+
+# Via pip
+pip install agentdomain-mcp
+```
+
+## Configure
+
+Set your API key as an environment variable:
+
+```bash
+export AGENTDOMAIN_API_KEY="da_your_api_key_here"
+```
+
+Get a free API key at [agentdomain.cloud/dashboard](https://agentdomain.cloud/dashboard/).
+
+## Use with Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "agentdomain": {
+      "command": "uvx",
+      "args": ["agentdomain-mcp"],
+      "env": {
+        "AGENTDOMAIN_API_KEY": "da_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Use with Hermes Agent
+
+Add to `~/.hermes/config.yaml`:
+
+```yaml
+mcp_servers:
+  agentdomain:
+    command: "uvx"
+    args: ["agentdomain-mcp"]
+    env:
+      AGENTDOMAIN_API_KEY: "da_your_api_key_here"
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `domain_search` | Search for available domains |
+| `domain_check` | Check availability + price |
+| `domain_buy` | Register a domain |
+| `domain_list` | List your domains |
+| `domain_dns_get` | Get DNS records |
+| `domain_dns_update` | Update DNS records |
+| `domain_transfer` | Get EPP auth code |
+| `wallet_balance` | Check balance |
+| `wallet_topup` | Create crypto top-up invoice |
+| `wallet_transactions` | List recent transactions |
+| `account_info` | Get account info |
+
+## License
+
+MIT

agentdomain_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentdomain-mcp"
+version = "0.1.0"
+description = "MCP server for AgentDomain — domain registration API for AI agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+agentdomain-mcp = "server:mcp.run"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]

agentdomain_mcp-0.1.0/server.py

@@ -0,0 +1,292 @@
+"""AgentDomain MCP Server — Domain registration tools for AI agents."""
+
+import os
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API_BASE = os.environ.get("AGENTDOMAIN_API_URL", "https://api.agentdomain.cloud")
+API_KEY = os.environ.get("AGENTDOMAIN_API_KEY", "")
+
+mcp = FastMCP(
+    "AgentDomain",
+    instructions="Domain registration API for AI agents. Search, register, and manage domains autonomously.",
+)
+
+
+def _headers():
+    return {
+        "Authorization": f"Bearer {API_KEY}",
+        "Content-Type": "application/json",
+    }
+
+
+async def _get(path: str) -> dict:
+    async with httpx.AsyncClient(timeout=30) as c:
+        r = await c.get(f"{API_BASE}{path}", headers=_headers())
+        if r.status_code >= 400:
+            try:
+                detail = r.json().get("detail", r.text)
+            except Exception:
+                detail = r.text
+            return {"error": f"API error {r.status_code}: {detail}"}
+        return r.json()
+
+
+async def _post(path: str, data: dict = None) -> dict:
+    async with httpx.AsyncClient(timeout=30) as c:
+        r = await c.post(f"{API_BASE}{path}", headers=_headers(), json=data or {})
+        if r.status_code >= 400:
+            try:
+                detail = r.json().get("detail", r.text)
+            except Exception:
+                detail = r.text
+            return {"error": f"API error {r.status_code}: {detail}"}
+        return r.json()
+
+
+# ── Domains ──
+
+
+@mcp.tool()
+async def domain_search(query: str) -> str:
+    """Search for available domain names matching a query.
+
+    Args:
+        query: Search term (e.g. 'awesome', 'mybrand')
+
+    Returns:
+        List of domains with availability and pricing.
+    """
+    data = await _get(f"/v1/domains/search?q={query}")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    domains = data.get("domains", [])
+    if not domains:
+        return "No domains found."
+    lines = []
+    for d in domains:
+        status = "✅ available" if d.get("available") else "❌ taken"
+        price = f"${d['price']:.2f}" if d.get("price") else ""
+        lines.append(f"  {d['name']}  {status}  {price}")
+    return "Search results:\n" + "\n".join(lines)
+
+
+@mcp.tool()
+async def domain_check(domain: str) -> str:
+    """Check if a specific domain is available for registration and get its price.
+
+    Args:
+        domain: Full domain name (e.g. 'awesome.com')
+
+    Returns:
+        Availability status and price.
+    """
+    data = await _post("/v1/domains/check", {"domain": domain})
+    if "error" in data:
+        return f"Error: {data['error']}"
+    if data.get("registrable"):
+        price = data.get("price_cents", 0) / 100
+        return f"✅ {domain} is available — ${price:.2f}/yr"
+    else:
+        reason = data.get("reason", "already taken")
+        return f"❌ {domain} is not available ({reason})"
+
+
+@mcp.tool()
+async def domain_buy(domain: str, years: int = 1) -> str:
+    """Register/buy a domain name.
+
+    Args:
+        domain: Full domain name to register (e.g. 'awesome.com')
+        years: Registration period in years (default: 1)
+
+    Returns:
+        Registration result with status and next steps.
+    """
+    data = await _post("/v1/domains/buy", {"domain": domain, "years": years})
+    if "error" in data:
+        return f"Error: {data['error']}"
+    status = data.get("status", "unknown")
+
+    if status == "active":
+        cost = data.get("cost_cents", 0) / 100
+        return f"✅ {domain} registered successfully! Cost: ${cost:.2f}"
+    elif status == "payment_required":
+        url = data.get("payment_url", "")
+        cost = data.get("cost_cents", 0) / 100
+        return f"💳 Payment needed (${cost:.2f}): {url}"
+    elif status == "approval_needed":
+        url = data.get("approval_url", "")
+        cost = data.get("cost_cents", 0) / 100
+        return f"⏳ Approval needed (${cost:.2f}): {url}"
+    elif status == "email_not_verified":
+        return "⚠️ Email not verified. Please verify your email first."
+    else:
+        msg = data.get("message", str(data))
+        return f"Result: {msg}"
+
+
+@mcp.tool()
+async def domain_list() -> str:
+    """List all domains registered to your account.
+
+    Returns:
+        List of domains with status, expiry, and cost.
+    """
+    data = await _get("/v1/domains")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    domains = data.get("domains", [])
+    if not domains:
+        return "No domains registered yet."
+    lines = []
+    for d in domains:
+        expires = d.get("expires_at", "—")[:10] if d.get("expires_at") else "—"
+        cost = f"${d['cost_cents'] / 100:.2f}" if d.get("cost_cents") else "—"
+        lines.append(f"  {d['domain']}  [{d['status']}]  expires: {expires}  cost: {cost}")
+    return "Your domains:\n" + "\n".join(lines)
+
+
+@mcp.tool()
+async def domain_dns_get(domain: str) -> str:
+    """Get DNS records for a domain.
+
+    Args:
+        domain: The domain to query (e.g. 'awesome.com')
+
+    Returns:
+        List of DNS records.
+    """
+    data = await _get(f"/v1/domains/{domain}/dns")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    records = data.get("records", [])
+    if not records:
+        return f"No DNS records for {domain}."
+    lines = [f"DNS records for {domain}:"]
+    for r in records:
+        lines.append(f"  {r.get('type', '?')}  {r.get('name', '@')}  {r.get('content', '')}  TTL:{r.get('ttl', 300)}")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+async def domain_dns_update(domain: str, records_json: str) -> str:
+    """Update DNS records for a domain. Replaces ALL records with the provided set.
+
+    Args:
+        domain: The domain to update (e.g. 'awesome.com')
+        records_json: JSON array of DNS records. Each record has: type (A/CNAME/MX/TXT), name, content, ttl.
+                      Example: [{"type": "A", "name": "@", "content": "1.2.3.4", "ttl": 300}]
+
+    Returns:
+        Confirmation of the update.
+    """
+    import json
+    records = json.loads(records_json)
+    data = await _post(f"/v1/domains/{domain}/dns", {"records": records})
+    if "error" in data:
+        return f"Error: {data['error']}"
+    return f"✅ DNS records updated for {domain}. {len(records)} record(s) applied."
+
+
+@mcp.tool()
+async def domain_transfer(domain: str) -> str:
+    """Get the EPP auth code to transfer a domain out.
+
+    Args:
+        domain: The domain to transfer (e.g. 'awesome.com')
+
+    Returns:
+        EPP authorization code and transfer instructions.
+    """
+    data = await _post(f"/v1/domains/{domain}/transfer")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    code = data.get("epp_code", "")
+    msg = data.get("message", "")
+    return f"EPP auth code for {domain}: {code}\n\n{msg}"
+
+
+# ── Wallet ──
+
+
+@mcp.tool()
+async def wallet_balance() -> str:
+    """Check your wallet balance and total spending.
+
+    Returns:
+        Current balance and total spent.
+    """
+    data = await _get("/v1/wallet")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    balance = data.get("balance_cents", 0) / 100
+    spent = data.get("total_spent_cents", 0) / 100
+    return f"Balance: ${balance:.2f}\nTotal spent: ${spent:.2f}"
+
+
+@mcp.tool()
+async def wallet_topup(amount_usd: float, currency: str = "USDC") -> str:
+    """Create a crypto top-up invoice for your wallet.
+
+    Args:
+        amount_usd: Amount in USD to add
+        currency: Crypto currency (USDC, BTC, ETH). Default: USDC.
+
+    Returns:
+        Payment invoice URL.
+    """
+    amount_cents = int(amount_usd * 100)
+    data = await _post("/v1/wallet/topup/crypto", {
+        "amount_cents": amount_cents,
+        "crypto_currency": currency,
+    })
+    if "error" in data:
+        return f"Error: {data['error']}"
+    url = data.get("invoice_url", "")
+    return f"💳 Top-up invoice (${amount_usd:.2f} via {currency}): {url}"
+
+
+@mcp.tool()
+async def wallet_transactions(limit: int = 10) -> str:
+    """List recent wallet transactions.
+
+    Args:
+        limit: Max number of transactions to return (default: 10)
+
+    Returns:
+        Recent transactions with type, amount, and status.
+    """
+    data = await _get("/v1/wallet/transactions")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    txs = data.get("transactions", [])[:limit]
+    if not txs:
+        return "No transactions yet."
+    lines = ["Recent transactions:"]
+    for t in txs:
+        amount = f"${t['amount_cents'] / 100:.2f}" if t.get("amount_cents") is not None else "—"
+        domain = t.get("domain", "")
+        date = t.get("created_at", "")[:10]
+        lines.append(f"  {t.get('type', '?')}  {amount}  {domain}  [{t.get('status', '?')}]  {date}")
+    return "\n".join(lines)
+
+
+# ── Account ──
+
+
+@mcp.tool()
+async def account_info() -> str:
+    """Get your account information.
+
+    Returns:
+        Agent name, email, and account ID.
+    """
+    data = await _get("/v1/auth/me")
+    if "error" in data:
+        return f"Error: {data['error']}"
+    return f"Name: {data.get('name', '—')}\nEmail: {data.get('email', '—')}\nAgent ID: {data.get('id', '—')}"
+
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")