MCP Server

The Bloomfilter MCP server lets AI agents register domains, manage DNS, and check account info — all through natural language.

Setup

Add the following to your MCP client’s config file:

{
  "mcpServers": {
    "bloomfilter": {
      "command": "npx",
      "args": ["-y", "@bloomfilter/mcp-server"],
      "env": {
        "BLOOMFILTER_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE",
        "BLOOMFILTER_NETWORK": "eip155:8453"
      }
    }
  }
}

Config file location

Client	Config file
Claude Desktop	`claude_desktop_config.json`
Claude Code	`~/.claude/settings.json`
Cursor	`.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code + Copilot	`.vscode/mcp.json`
Cline	Via Cline MCP settings UI
JetBrains IDEs	Settings > Tools > AI Assistant > MCP

Environment variables

Variable	Required	Default	Description
`BLOOMFILTER_PRIVATE_KEY`	For payments	—	Ethereum private key (0x-prefixed, 32 bytes hex). Required for domain registration, renewal, and DNS mutations.
`BLOOMFILTER_API_URL`	No	`https://api.bloomfilter.xyz`	API base URL. Override for testing or self-hosted instances.
`BLOOMFILTER_NETWORK`	No	`eip155:8453`	CAIP-2 network identifier. Use `eip155:84532` for Base Sepolia testnet.

Available tools

Free (no wallet needed)

Tool	Description
`search_domains`	Search for available domain names across multiple TLDs
`get_pricing`	Get registration, renewal, and transfer pricing for TLDs

Auth required (wallet needed)

Tool	Cost	Description
`get_domain_info`	Free	Get status, expiry, and nameserver info for a domain
`get_account`	Free	View your account summary and registered domains

Paid (wallet required)

Tool	Cost	Description
`register_domain`	Varies by TLD	Register a new domain name (1-10 years)
`renew_domain`	Varies by TLD	Renew an existing domain registration
`add_dns_record`	$0.10 USDC	Add a DNS record (A, AAAA, CNAME, MX, TXT, etc.)
`update_dns_record`	$0.10 USDC	Update an existing DNS record
`delete_dns_record`	$0.10 USDC	Delete a DNS record
`list_dns_records`	Free	List all DNS records for a domain you own

Usage examples

Once configured, just ask your AI agent in natural language:

“Search for available .io domains for ‘acmetools’”

“Register acmetools.io for 2 years”

“Add an A record pointing acmetools.io to 76.76.21.21”

“List all DNS records for acmetools.io”

“How much does a .ai domain cost?”

“Show me my account info and registered domains”

The agent handles the full flow automatically — searching, paying with USDC, polling async jobs, and reporting results.

Read-only mode

If you don’t set BLOOMFILTER_PRIVATE_KEY, the MCP server runs in read-only mode. Search and pricing tools work, but domain info, account, registration, renewal, and DNS mutations will return an error asking you to configure a wallet.