search_domainsLABSCO SUMMARY
A registrar an agent can finish a purchase at.
Domain registration normally stops at a login and a card form, which is where an autonomous run ends. Paying over x402 from a wallet key removes both, so finding a name and owning it is one conversation. The key in the config is a spending key: the wallet it controls is what pays.
What it is
A Node MCP server over the Bloomfilter domain API, which takes payment in USDC through x402 rather than a checkout. An agent with a funded wallet can search, price, register and renew domains on its own.
What you get
- Domain availability searched by name
- Pricing checked before anything is committed
- A domain registered and paid for from the wallet in the same call
- An existing domain renewed
- Registration and expiry detail for a domain you hold
- Account state read back
Requirements
BLOOMFILTER_PRIVATE_KEY in your client config — the wallet key the server signs and pays with — then npx -y @bloomfilter/mcp-server. The wallet needs USDC in it, because registration is billed per call over x402. The server speaks stdio and is meant to be launched by a client rather than run standalone.
Setup effort
One command plus credentials — BLOOMFILTER_PRIVATE_KEY=<YOUR_BLOOMFILTER_PRIVATE_KEY> npx @bloomfilter/mcp-server
USE CASES
01
Finding a name that is actually free
Check availability and the price side by side, rather than discovering the premium fee at checkout.
02
Registering it before someone else does
Buy the name in the same call that found it, paid from the wallet.
03
Keeping a name you already own
Read the domain's current state and renew it without opening a registrar account.
04
Checking what the wallet has been doing
Read account state to see what has been registered and what it cost.
10 tools
Listed in project docs. Your client may show a different list.
get_pricingget_domain_inforegister_domainrenew_domainget_accountlist_dns_recordsadd_dns_recordupdate_dns_recorddelete_dns_recordBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
- npx on PATH
- BLOOMFILTER_PRIVATE_KEY in your environment
Where it runs
All 7 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
BLOOMFILTER_PRIVATE_KEY=<YOUR_BLOOMFILTER_PRIVATE_KEY> npx @bloomfilter/mcp-serverMCP Clients
Claude Desktop, Claude Code, Cursor, Windsurf, Cline, JetBrains IDEs
JSON
{
"mcpServers": {
"bloomfilter": {
"command": "npx",
"args": [
"-y",
"@bloomfilter/mcp-server"
],
"env": {
"BLOOMFILTER_PRIVATE_KEY": "<YOUR_BLOOMFILTER_PRIVATE_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"bloomfilter": {
"command": "npx",
"args": [
"-y",
"@bloomfilter/mcp-server"
],
"env": {
"BLOOMFILTER_PRIVATE_KEY": "<YOUR_BLOOMFILTER_PRIVATE_KEY>"
}
}
}
}
