Bloomfilter

Permita que agentes de IA pesquisem, registrem e gerenciem domínios via API.

Documentação

@bloomfilter/mcp-server

Servidor MCP para Bloomfilter, pesquise e registre nomes de domínio e gerencie registros DNS a partir de agentes de IA.

Bloomfilter é uma API de registro e configuração de domínios que usa x402 para pagamentos. Aponte seu agente de IA para a API Bloomfilter, dê a ele uma carteira com algum USDC, e ele pode pesquisar, registrar e configurar domínios de forma autônoma.

Sem login, sem cartão de crédito, sem painel. Apenas requisições HTTP e uma carteira cripto.

Este servidor MCP encapsula a API Bloomfilter para que qualquer cliente compatível com MCP (Claude Desktop, Cursor, Windsurf, agentes personalizados, etc.) possa usá-lo como provedor de ferramentas.

Início Rápido

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

O servidor se comunica via stdio (JSON-RPC). Ele é destinado a ser iniciado por um cliente MCP, não executado de forma independente.

Configuração

Adicione este JSON ao arquivo de configuração do seu cliente MCP:

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

Localização do arquivo de configuração por cliente

Cliente	Arquivo de configuração
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 interface de configurações MCP do Cline
IDEs JetBrains	Configurações > Ferramentas > Assistente de IA > MCP

Qualquer cliente compatível com MCP que suporte servidores stdio funcionará.

Variáveis de ambiente

Variável	Obrigatório	Padrão	Descrição
`BLOOMFILTER_PRIVATE_KEY`	Para operações pagas	-	Chave privada EVM (hex). Usada para pagamentos x402 e autenticação baseada em carteira.
`BLOOMFILTER_API_URL`	Não	`https://api.bloomfilter.xyz`	URL base da API.

Sem uma chave privada, apenas search_domains e get_pricing funcionam. Todo o resto requer uma carteira.

Ferramentas

O servidor expõe 10 ferramentas:

Gratuitas (sem necessidade de carteira)

search_domains: Verifica se um domínio está disponível e obtém preços. Pesquisa em vários TLDs de uma vez.
get_pricing: Obtém preços de registro, renovação e transferência para um ou todos os TLDs suportados.

Autenticadas (carteira necessária)

get_domain_info: Obtém detalhes sobre um domínio registrado: status, expiração, servidores de nomes, estado de bloqueio.
register_domain: Registra um novo domínio. Paga com USDC via x402 automaticamente. Lida com provisionamento assíncrono.
renew_domain: Estende o registro de um domínio. Mesmo fluxo de pagamento x402.
get_account: Exibe endereço da carteira, contagem de domínios, total gasto.

Gerenciamento de DNS (carteira necessária, $0,10 USDC por mutação)

list_dns_records: Lista todos os registros DNS de um domínio.
add_dns_record: Adiciona um registro DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, FORWARD).
update_dns_record: Atualiza um registro DNS existente pelo ID.
delete_dns_record: Exclui um registro DNS pelo ID.

Como Funcionam os Pagamentos

Bloomfilter usa o protocolo x402, um padrão de pagamento nativo de HTTP. Quando uma ferramenta aciona uma chamada de API paga, o servidor lida com a negociação de pagamento automaticamente:

A API responde com HTTP 402 e um requisito de pagamento
O servidor MCP assina um pagamento USDC com sua carteira
A API verifica o pagamento e conclui a solicitação

Todos os pagamentos são em USDC na Base (uma L2 da Ethereum). Você precisa de USDC na carteira correspondente à sua chave privada.

Autenticação

O servidor autentica com a API Bloomfilter usando SIWE (Sign-In With Ethereum). Isso acontece automaticamente na primeira chamada de ferramenta autenticada. Nenhuma configuração necessária além de fornecer sua chave privada.

Documentação

Referência completa da API e guias em docs.bloomfilter.xyz.

Compilando a partir do Código-Fonte

git clone https://github.com/BloomFilter-Labs/mcp-server-bloomfilter.git
cd mcp-server-bloomfilter
npm install
npm run build

Requer Node.js 20+.

Licença

MIT