Quick Start

There are two ways to use Bloomfilter: through the MCP server (recommended for AI agents) or the raw HTTP API.

MCP Server

The MCP server lets AI agents like Claude, Cursor, and Windsurf register domains autonomously.

1. Install the MCP server

   Add to your MCP client config (e.g. claude_desktop_config.json):

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

   See MCP Server setup for config paths for all supported clients.

2. Fund your wallet

   Send USDC to your wallet address on Base (chain ID 8453). You need at least enough to cover the domain price + DNS fees ($0.10 each).

3. Ask your AI agent to register a domain

   “Search for available .io domains for ‘myproject’ and register the best one.”

   The agent will search, show pricing, register the domain, and configure DNS — all autonomously.

HTTP API

Use the API directly with curl or any HTTP client.

1. Search for a domain

   curl "https://api.bloomfilter.xyz/domains/search?query=myproject&tlds=com,io,xyz"

   {
     "query": "myproject",
     "results": [
       { "domain": "myproject.com", "tld": "com", "available": true },
       { "domain": "myproject.io", "tld": "io", "available": true },
       { "domain": "myproject.xyz", "tld": "xyz", "available": true }
     ]
   }

2. Register it

   curl -X POST https://api.bloomfilter.xyz/domains/register \
     -H "Content-Type: application/json" \
     -d '{"domain": "myproject.xyz", "years": 1}'

   First request returns 402 Payment Required with an x402 payment challenge. If you’re using @x402/axios or the MCP server, payment is handled automatically. Otherwise, see the x402 Payment Flow guide.

3. Configure DNS

   First, authenticate with SIWE to get a JWT token. Then add records:

   curl -X POST https://api.bloomfilter.xyz/dns/myproject.xyz \
     -H "Authorization: Bearer YOUR_JWT_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"type": "A", "host": "@", "value": "76.76.21.21"}'

   Each DNS mutation costs $0.10 USDC, settled via x402.

What’s next?

• Concepts — Understand x402, SIWE, and async provisioning
• MCP Server setup — Full config for 7+ AI clients
• API Docs — All 20 endpoints documented