@bloomfilter/mcp-server

MCP server for Bloomfilter, search & register domain names and manage DNS records from AI agents.

Bloomfilter is a domain registration and configuration API that uses x402 for payments. Point your AI agent at the Bloomfilter API, give it a wallet with some USDC, and it can autonomously search, register, and configure domains.

No login, no credit card, no dashboard. Just HTTP requests and a crypto wallet.

This MCP server wraps the Bloomfilter API so that any MCP-compatible client (Claude Desktop, Cursor, Windsurf, custom agents, etc.) can use it as a tool provider.

Quick Start

BLOOMFILTER_PRIVATE_KEY=0x... npx @bloomfilter/mcp-server

The server communicates over stdio (JSON-RPC). It's meant to be launched by an MCP client, not run standalone.

Configuration

Add this JSON to your MCP client's config file:

{
	"mcpServers": {
		"bloomfilter": {
			"command": "npx",
			"args": ["-y", "@bloomfilter/mcp-server"],
			"env": {
				"BLOOMFILTER_PRIVATE_KEY": "0x..."
			}
		}
	}
}

Config file location by client

Any MCP-compatible client that supports stdio servers will work.

Environment variables

Without a private key, only search_domains and get_pricing work. Everything else requires a wallet.

Tools

The server exposes 10 tools:

Free (no wallet needed)

• search_domains: Check if a domain is available and get pricing. Searches across multiple TLDs at once.
• get_pricing: Get registration, renewal, and transfer pricing for one or all supported TLDs.

Authenticated (wallet required)

• get_domain_info: Get details about a registered domain: status, expiry, nameservers, lock state.
• register_domain: Register a new domain. Pays with USDC via x402 automatically. Handles async provisioning.
• renew_domain: Extend a domain registration. Same x402 payment flow.
• get_account: View wallet addres

... View full README on GitHub