Bloomfilter

Permite que agentes de IA busquen, registren y administren dominios a través de una API.

Documentación

@bloomfilter/mcp-server

Servidor MCP para Bloomfilter, busca y registra nombres de dominio y gestiona registros DNS desde agentes de IA.

Bloomfilter es una API de registro y configuración de dominios que utiliza x402 para pagos. Apunta tu agente de IA a la API de Bloomfilter, dale una wallet con algo de USDC, y podrá buscar, registrar y configurar dominios de forma autónoma.

Sin inicio de sesión, sin tarjeta de crédito, sin panel de control. Solo solicitudes HTTP y una wallet de criptomonedas.

Este servidor MCP envuelve la API de Bloomfilter para que cualquier cliente compatible con MCP (Claude Desktop, Cursor, Windsurf, agentes personalizados, etc.) pueda usarlo como proveedor de herramientas.

Inicio Rápido

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

El servidor se comunica a través de stdio (JSON-RPC). Está diseñado para ser lanzado por un cliente MCP, no para ejecutarse de forma independiente.

Configuración

Añade este JSON al archivo de configuración de tu cliente MCP:

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

Ubicación del archivo de configuración según el cliente

Cliente	Archivo de configuración
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	A través de la interfaz de configuración MCP de Cline
IDEs JetBrains	Configuración > Herramientas > Asistente de IA > MCP

Cualquier cliente compatible con MCP que admita servidores stdio funcionará.

Variables de entorno

Variable	Requerida	Valor predeterminado	Descripción
`BLOOMFILTER_PRIVATE_KEY`	Para operaciones de pago	-	Clave privada EVM (hex). Se usa para pagos x402 y autenticación basada en wallet.
`BLOOMFILTER_API_URL`	No	`https://api.bloomfilter.xyz`	URL base de la API.

Sin una clave privada, solo funcionan search_domains y get_pricing. Todo lo demás requiere una wallet.

Herramientas

El servidor expone 10 herramientas:

Gratuitas (sin necesidad de wallet)

search_domains: Comprueba si un dominio está disponible y obtén precios. Busca en múltiples TLDs a la vez.
get_pricing: Obtén precios de registro, renovación y transferencia para uno o todos los TLDs admitidos.

Autenticadas (requieren wallet)

get_domain_info: Obtén detalles sobre un dominio registrado: estado, vencimiento, servidores de nombres, estado de bloqueo.
register_domain: Registra un nuevo dominio. Paga con USDC vía x402 automáticamente. Gestiona el aprovisionamiento asíncrono.
renew_domain: Extiende el registro de un dominio. Mismo flujo de pago x402.
get_account: Consulta la dirección de la wallet, el número de dominios y el gasto total.

Gestión de DNS (requiere wallet, $0.10 USDC por mutación)

list_dns_records: Lista todos los registros DNS de un dominio.
add_dns_record: Añade un registro DNS (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, FORWARD).
update_dns_record: Actualiza un registro DNS existente por ID.
delete_dns_record: Elimina un registro DNS por ID.

Cómo Funcionan los Pagos

Bloomfilter utiliza el protocolo x402, un estándar de pago nativo de HTTP. Cuando una herramienta activa una llamada de API de pago, el servidor gestiona la negociación del pago automáticamente:

La API responde con HTTP 402 y un requisito de pago
El servidor MCP firma un pago en USDC con tu wallet
La API verifica el pago y completa la solicitud

Todos los pagos son en USDC en Base (un L2 de Ethereum). Necesitas USDC en la wallet correspondiente a tu clave privada.

Autenticación

El servidor se autentica con la API de Bloomfilter usando SIWE (Sign-In With Ethereum). Esto ocurre automáticamente en la primera llamada de herramienta autenticada. No se necesita configuración adicional más allá de proporcionar tu clave privada.

Documentación

Referencia completa de la API y guías en docs.bloomfilter.xyz.

Compilación desde el Código Fuente

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

Requiere Node.js 20+.

Licencia

MIT