home / mcp / bloomfilter mcp server

Bloomfilter MCP Server

Exposes Bloomfilter domain registration, pricing, and DNS management as MCP tools with wallet-based payments.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can deploy a Bloomfilter MCP Server to expose Bloomfilter’s domain registration and DNS management capabilities to any MCP-compatible client. This server wraps the Bloomfilter API so tools and agents can autonomously search, register, configure, and manage domains using a crypto wallet for x402 payments—without a traditional login or dashboard.

How to use

You connect an MCP client (such as Claude Desktop, Cursor, Windsurf, or your own agent) to the Bloomfilter MCP Server. Start the server with your wallet ready, and your client can perform both free and paid operations. Free actions include domain search and pricing checks. Paid actions include registering, renewing, and managing DNS records, all billed in USDC via the x402 flow.

How to install

Prerequisites: ensure you have Node.js 20 or higher installed on your machine.

Install and run the MCP server using the following command. Replace 0x... with your actual wallet private key.

Install commands

BLOOMFILTER_PRIVATE_KEY=0x... npx @bloomfilter/mcp-server
```
```bash
BLOOMFILTER_PRIVATE_KEY=0x... BLOOMFILTER_API_URL=https://api.bloomfilter.xyz npx @bloomfilter/mcp-server

Configure your MCP client

Add the following MCP server configuration to your client’s config. This enables the client to communicate with the Bloomfilter MCP Server over stdio using the npx command.

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

Available tools

search_domains

Check domain availability across multiple TLDs and retrieve pricing information.

get_pricing

Retrieve registration, renewal, and transfer pricing for one or all supported TLDs.

get_domain_info

Fetch details about a registered domain, including status, expiry, nameservers, and lock state.

register_domain

renew_domain

Extend an existing domain registration, using the same x402 payment flow.

get_account

Display wallet address, number of domains owned, and total spent.

list_dns_records

List all DNS records for a specific domain.

add_dns_record

Add a DNS record of types such as A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, FORWARD.

update_dns_record

Update an existing DNS record by its ID.

delete_dns_record

Delete a DNS record by its ID.