# bloomfilter

MCP server that lets autonomous agents search, buy domain names, and modify DNS entries via x402 micropayments.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: BloomFilter-Labs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BloomFilter-Labs/mcp-server-bloomfilter
- Updated: 2026-02-26
- HTML: https://affpapa.org/en/nevibecode/mcp/bloomfilter

## What it does

This server connects AI environments to Bloomfilter via stdio JSON-RPC. Traditional setups demand dashboards, email signups, and credit cards. Bloomfilter swaps those out for HTTP-level crypto transactions. When an agent requests a paid action, the server catches an HTTP 402 code and signs the payment transaction directly.

Out of ten available tools, two work without any credentials: `search_domains` and `get_pricing`. Registration, renewals, and account inspection need a configured EVM wallet. DNS record operations cover A, AAAA, CNAME, MX, TXT, and other common records, charging $0.10 USDC per mutation.

Without funded USDC on Base inside the target wallet, paid actions will fail. The server needs Node.js 20 or newer if built locally, along with an EVM private key provided in `BLOOMFILTER_PRIVATE_KEY`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BLOOMFILTER_PRIVATE_KEY`, `BLOOMFILTER_API_URL`, `BLOOMFILTER_NETWORK` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BLOOMFILTER_PRIVATE_KEY=<BLOOMFILTER_PRIVATE_KEY> --env BLOOMFILTER_API_URL=<BLOOMFILTER_API_URL> --env BLOOMFILTER_NETWORK=<BLOOMFILTER_NETWORK> --transport stdio bloomfilter -- npx -y @bloomfilter/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add bloomfilter --env BLOOMFILTER_PRIVATE_KEY=<BLOOMFILTER_PRIVATE_KEY> --env BLOOMFILTER_API_URL=<BLOOMFILTER_API_URL> --env BLOOMFILTER_NETWORK=<BLOOMFILTER_NETWORK> -- npx -y @bloomfilter/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bloomfilter": {
            "command": "npx",
            "args": [
                "-y",
                "@bloomfilter/mcp-server"
            ],
            "env": {
                "BLOOMFILTER_PRIVATE_KEY": "<BLOOMFILTER_PRIVATE_KEY>",
                "BLOOMFILTER_API_URL": "<BLOOMFILTER_API_URL>",
                "BLOOMFILTER_NETWORK": "<BLOOMFILTER_NETWORK>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bloomfilter": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bloomfilter/mcp-server"
            ],
            "env": {
                "BLOOMFILTER_PRIVATE_KEY": "<BLOOMFILTER_PRIVATE_KEY>",
                "BLOOMFILTER_API_URL": "<BLOOMFILTER_API_URL>",
                "BLOOMFILTER_NETWORK": "<BLOOMFILTER_NETWORK>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BLOOMFILTER_PRIVATE_KEY=<BLOOMFILTER_PRIVATE_KEY> -e BLOOMFILTER_API_URL=<BLOOMFILTER_API_URL> -e BLOOMFILTER_NETWORK=<BLOOMFILTER_NETWORK> bloomfilter npx -y @bloomfilter/mcp-server
```
Replace <…> with your own values

## When to use it
- search available domains and review pricing across extensions
- purchase a domain programmatically without manual checkout
- configure DNS records like A, MX, or TXT
- update or wipe obsolete DNS records by identifier

## Example prompts
- Check if my-new-app.xyz is available and show the registration cost
- Register domain name cool-agent.dev using the connected wallet
- Add a CNAME record pointing app.example.com to my-cluster.net

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md