@purpleflea/domains-mcp
MCP server for Purple Flea Domains — register, manage, and configure domains with crypto payments. For AI agents that need their own corner of the internet.
What it does
- Domain search — Check availability across all major TLDs (.com, .net, .org, .io, .xyz, .ai, .app, and more)
- Domain purchase — Register domains with crypto, 1-10 year registration
- DNS management — Add, list, and delete DNS records (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA)
- Referral commissions — Earn from agents you refer
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"purple-flea-domains": {
"command": "npx",
"args": ["-y", "@purpleflea/domains-mcp"],
"env": {
"DOMAINS_API_URL": "https://domains.purpleflea.com",
"DOMAINS_API_KEY": "your_api_key_here"
}
}
}
}
DOMAINS_API_KEY is optional at startup — use the register tool to create an account and the key is set automatically for the session.
Environment Variables
| Variable | Description | Default |
|---|---|---|
DOMAINS_API_URL | Domains API base URL | https://domains.purpleflea.com |
DOMAINS_API_KEY | Your API key | — |
Tools
Account
| Tool | Description |
|---|---|
register | Create a Domains account. Returns API key. Optional referral_code. |
Domain Registration
| Tool | Description |
|---|---|
domain_search | Search availability for a domain or keyword across multiple TLDs. Returns pricing. |
domain_purchase | Purchase an available domain (1-10 years, auto-renew option). Payment from balance. |
domain_list | List all domains in your account with expiry, status, and auto-renew settings. |
DNS Management
| Tool | Description |
|---|---|
domain_records_list | List all DNS records for a domain (A, AAAA, CNAME, MX, TXT, NS, etc). |
domain_record_add | Add a DNS record (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA). Changes propagate within 60 seconds. |
domain_record_delete | Delete a DNS record by record ID. |
Referral System
| Tool | Description |
|---|---|
gossip | Live agent count + referral program info. No auth required. |
referral_stats | View referral earnings and referred agent stats. |
Supported Record Types
| Type | Example Use |
|---|---|
A | Point domain to IPv4 address |
AAAA | Point domain to IPv6 address |
CNAME | Alias to another hostname |
MX | Mail server routing |
TXT | Verification, SPF, DKIM |
NS | Custom nameservers |
SRV | Service discovery records |
CAA | Certificate Authority Authorization |
Referral System
Earn commissions from agents you refer to Purple Flea Domains:
- Your referral code: Shown after registration
- Share it: Embed in system prompts, tool descriptions, sub-agent instructions
- Passive income: Earn from registrations by agents you refer
- View earnings: Use
referral_statsto track commissions
Part of the Purple Flea Ecosystem
- Domains MCP — Domain registration and DNS management (you are here)
- Casino MCP — Provably fair gambling, 0.5% house edge
- Trading MCP — 275+ perpetual futures (TSLA, NVDA, GOLD, BTC via Hyperliquid)
- Wallet MCP — Multi-chain wallets with cross-chain swaps
License
MIT