@bloomfilter/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BloomFilter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @bloomfilter/mcp-server
+
+MCP server for [Bloomfilter](https://bloomfilter.xyz), register ICANN domain names and manage DNS records from AI agents.
+
+Bloomfilter is a domain registration API that uses [x402](https://www.x402.org/) for payments. Point your AI agent at the Bloomfilter API, give it a wallet with some USDC, and it can autonomously search, register, and configure domains.
+
+No login, no credit card, no dashboard. Just HTTP requests and a crypto wallet.
+
+This MCP server wraps the Bloomfilter API so that any MCP-compatible client (Claude Desktop, Cursor, Windsurf, custom agents, etc.) can use it as a tool provider.
+
+## Quick Start
+
+```bash
+BLOOMFILTER_PRIVATE_KEY=0x... npx @bloomfilter/mcp-server
+```
+
+The server communicates over stdio (JSON-RPC). It's meant to be launched by an MCP client, not run standalone.
+
+## Configuration
+
+Add this JSON to your MCP client's config file:
+
+```json
+{
+  "mcpServers": {
+    "bloomfilter": {
+      "command": "npx",
+      "args": ["-y", "@bloomfilter/mcp-server"],
+      "env": {
+        "BLOOMFILTER_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
+
+### Config file location by client
+
+| Client                                                                                    | Config file                           |
+| ----------------------------------------------------------------------------------------- | ------------------------------------- |
+| [Claude Desktop](https://claude.ai/download)                                              | `claude_desktop_config.json`          |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview)                    | `~/.claude/settings.json`             |
+| [Cursor](https://cursor.com)                                                              | `.cursor/mcp.json`                    |
+| [Windsurf](https://windsurf.com)                                                          | `~/.codeium/windsurf/mcp_config.json` |
+| [VS Code + Copilot](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) | `.vscode/mcp.json`                    |
+| [Cline](https://docs.cline.bot/mcp/configuring-mcp-servers)                               | Via Cline MCP settings UI             |
+| [JetBrains IDEs](https://www.jetbrains.com/help/ai-assistant/mcp.html)                    | Settings > Tools > AI Assistant > MCP |
+
+Any MCP-compatible client that supports stdio servers will work.
+
+### Environment variables
+
+| Variable                  | Required            | Default                       | Description                                                          |
+| ------------------------- | ------------------- | ----------------------------- | -------------------------------------------------------------------- |
+| `BLOOMFILTER_PRIVATE_KEY` | For paid operations | -                             | EVM private key (hex). Used for x402 payments and wallet-based auth. |
+| `BLOOMFILTER_API_URL`     | No                  | `https://api.bloomfilter.xyz` | API base URL.                                                        |
+
+Without a private key, only `search_domains` and `get_pricing` work. Everything else requires a wallet.
+
+## Tools
+
+The server exposes 10 tools:
+
+### Free (no wallet needed)
+
+- **`search_domains`:** Check if a domain is available and get pricing. Searches across multiple TLDs at once.
+- **`get_pricing`:** Get registration, renewal, and transfer pricing for one or all supported TLDs.
+
+### Authenticated (wallet required)
+
+- **`get_domain_info`:** Get details about a registered domain: status, expiry, nameservers, lock state.
+- **`register_domain`:** Register a new domain. Pays with USDC via x402 automatically. Handles async provisioning.
+- **`renew_domain`:** Extend a domain registration. Same x402 payment flow.
+- **`get_account`:** View wallet address, domain count, total spent.
+
+### DNS Management (wallet required, $0.10 USDC per mutation)
+
+- **`list_dns_records`:** List all DNS records for a domain.
+- **`add_dns_record`:** Add a DNS record (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, FORWARD).
+- **`update_dns_record`:** Update an existing DNS record by ID.
+- **`delete_dns_record`:** Delete a DNS record by ID.
+
+## How Payments Work
+
+Bloomfilter uses the [x402 protocol](https://www.x402.org/), an HTTP-native payment standard. When a tool triggers a paid API call, the server handles payment negotiation automatically:
+
+1. The API responds with HTTP 402 and a payment requirement
+2. The MCP server signs a USDC payment with your wallet
+3. The API verifies the payment and completes the request
+
+All payments are in USDC on Base (an Ethereum L2). You need USDC in the wallet corresponding to your private key.
+
+## Authentication
+
+The server authenticates with the Bloomfilter API using SIWE (Sign-In With Ethereum). This happens automatically on the first authenticated tool call. No setup needed beyond providing your private key.
+
+## Documentation
+
+Full API reference and guides at [docs.bloomfilter.xyz](https://docs.bloomfilter.xyz).
+
+## Building from Source
+
+```bash
+git clone https://github.com/BloomFilter-Labs/mcp-server-bloomfilter.git
+cd mcp-server-bloomfilter
+npm install
+npm run build
+```
+
+Requires Node.js 20+.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Bloomfilter API client with x402 payment support and SIWE authentication.
+ *
+ * This module creates an axios instance optionally wrapped with @x402/axios
+ * for automatic 402 payment handling, plus lazy SIWE authentication with
+ * token caching and refresh.
+ */
+import type { AxiosInstance } from "axios";
+import type { BloomfilterConfig, McpToolResult, JobStatusResponse } from "./types.js";
+export interface BloomfilterClient {
+    /** The underlying axios instance (with x402 wrapping if private key provided) */
+    http: AxiosInstance;
+    /** Ensure the client is authenticated (lazy SIWE flow) */
+    ensureAuth(): Promise<void>;
+    /** Get auth headers for authenticated requests */
+    getAuthHeaders(): Record<string, string>;
+    /** Check if a private key is configured; returns error result if not, null if OK */
+    requiresPrivateKey(): McpToolResult | null;
+    /** Poll an async job until completion or failure */
+    pollJobStatus(jobId: string): Promise<JobStatusResponse>;
+}
+/**
+ * Create a Bloomfilter API client.
+ *
+ * If a private key is provided, the axios instance is wrapped with @x402/axios
+ * for automatic 402 payment handling. Authentication uses SIWE (Sign-In With
+ * Ethereum) — tokens are cached in memory and refreshed automatically.
+ */
+export declare function createBloomfilterClient(config: BloomfilterConfig): Promise<BloomfilterClient>;
+/**
+ * Format any error into a consistent MCP tool result.
+ *
+ * Handles:
+ * - Axios errors with Bloomfilter API error responses
+ * - Rate limiting (429)
+ * - Network/connection errors
+ * - Generic errors
+ */
+export declare function formatToolError(error: unknown, apiUrl?: string): McpToolResult;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM3C,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EAIb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,IAAI,EAAE,aAAa,CAAC;IACpB,0DAA0D;IAC1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,kDAAkD;IAClD,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,oFAAoF;IACpF,kBAAkB,IAAI,aAAa,GAAG,IAAI,CAAC;IAC3C,oDAAoD;IACpD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1D;AAaD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CA0L5B;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CA6G9E"}

package/dist/client.js

@@ -0,0 +1,297 @@
+/**
+ * Bloomfilter API client with x402 payment support and SIWE authentication.
+ *
+ * This module creates an axios instance optionally wrapped with @x402/axios
+ * for automatic 402 payment handling, plus lazy SIWE authentication with
+ * token caching and refresh.
+ */
+import axios from "axios";
+import { privateKeyToAccount } from "viem/accounts";
+import { createSiweMessage } from "viem/siwe";
+import { z } from "zod";
+import { HTTP_TIMEOUT_MS, JOB_POLL_INTERVAL_MS, JOB_TIMEOUT_MS } from "./types.js";
+// ── Config Validation ────────────────────────────────────────────────────────
+const configSchema = z.object({
+    apiUrl: z.string().url("apiUrl must be a valid URL"),
+    privateKey: z
+        .custom((val) => typeof val === "string" && /^0x[0-9a-fA-F]{64}$/.test(val), {
+        message: "privateKey must be a 0x-prefixed 32-byte hex string",
+    })
+        .optional(),
+    network: z
+        .string()
+        .regex(/^eip155:\d+$/, 'network must be in CAIP-2 format (e.g. "eip155:8453")'),
+});
+// ── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a Bloomfilter API client.
+ *
+ * If a private key is provided, the axios instance is wrapped with @x402/axios
+ * for automatic 402 payment handling. Authentication uses SIWE (Sign-In With
+ * Ethereum) — tokens are cached in memory and refreshed automatically.
+ */
+export async function createBloomfilterClient(config) {
+    // Validate config upfront — fail fast with clear messages
+    configSchema.parse(config);
+    let account;
+    let tokenCache;
+    // Create base axios instance
+    let httpClient = axios.create({
+        baseURL: config.apiUrl,
+        timeout: HTTP_TIMEOUT_MS,
+        headers: { "Content-Type": "application/json" },
+    });
+    // If private key is provided, set up wallet + x402 payment wrapping
+    if (config.privateKey) {
+        account = privateKeyToAccount(config.privateKey);
+        console.error(`[bloomfilter-mcp] Wallet: ${account.address}`);
+        try {
+            // Dynamic import to avoid issues when private key is not provided
+            const { wrapAxiosWithPayment, x402Client } = await import("@x402/axios");
+            const { ExactEvmScheme } = await import("@x402/evm");
+            const x402 = new x402Client().register("eip155:*", new ExactEvmScheme(account));
+            httpClient = wrapAxiosWithPayment(httpClient, x402);
+        }
+        catch (err) {
+            console.error("[bloomfilter-mcp] Warning: Failed to initialize x402 payment support.", err instanceof Error ? err.message : err);
+        }
+    }
+    // ── SIWE Auth ───────────────────────────────────────────────────────────
+    async function authenticate() {
+        if (!account) {
+            throw new Error("Cannot authenticate without a private key");
+        }
+        try {
+            // 1. Get nonce from API
+            const { data: nonceData } = await httpClient.get("/auth/nonce");
+            // 2. Construct SIWE message
+            const message = createSiweMessage({
+                address: account.address,
+                chainId: nonceData.chainId,
+                domain: nonceData.domain,
+                nonce: nonceData.nonce,
+                uri: nonceData.uri,
+                version: "1",
+                issuedAt: new Date(),
+            });
+            // 3. Sign the message
+            const signature = await account.signMessage({ message });
+            // 4. Verify with the API
+            const { data: authData } = await httpClient.post("/auth/verify", {
+                message,
+                signature,
+            });
+            // 5. Cache tokens
+            tokenCache = {
+                accessToken: authData.accessToken,
+                refreshToken: authData.refreshToken,
+                expiresAt: Date.now() + authData.expiresIn * 1000 - 60_000, // 1 min buffer
+            };
+            console.error(`[bloomfilter-mcp] Authenticated as ${account.address}`);
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new Error(`Authentication failed: ${detail}`);
+        }
+    }
+    async function refreshAuth() {
+        if (!tokenCache)
+            return false;
+        try {
+            const { data } = await httpClient.post("/auth/refresh", {
+                refreshToken: tokenCache.refreshToken,
+            });
+            tokenCache = {
+                accessToken: data.accessToken,
+                refreshToken: data.refreshToken,
+                expiresAt: Date.now() + data.expiresIn * 1000 - 60_000,
+            };
+            console.error("[bloomfilter-mcp] Token refreshed");
+            return true;
+        }
+        catch {
+            console.error("[bloomfilter-mcp] Token refresh failed, re-authenticating");
+            tokenCache = undefined;
+            return false;
+        }
+    }
+    async function ensureAuth() {
+        if (!account) {
+            throw new Error("BLOOMFILTER_PRIVATE_KEY is required for authenticated operations");
+        }
+        // No tokens yet — full auth
+        if (!tokenCache) {
+            await authenticate();
+            return;
+        }
+        // Token still valid
+        if (Date.now() < tokenCache.expiresAt) {
+            return;
+        }
+        // Token expired — try refresh, fall back to full auth
+        const refreshed = await refreshAuth();
+        if (!refreshed) {
+            await authenticate();
+        }
+    }
+    function getAuthHeaders() {
+        if (!tokenCache)
+            return {};
+        return { Authorization: `Bearer ${tokenCache.accessToken}` };
+    }
+    function requiresPrivateKey() {
+        if (config.privateKey)
+            return null;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: BLOOMFILTER_PRIVATE_KEY is required for this operation. " +
+                        "Set it as an environment variable to enable domain registration, " +
+                        "renewal, DNS management, and account access.\n\n" +
+                        "Example: BLOOMFILTER_PRIVATE_KEY=0x... bloomfilter-mcp",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // ── Job Polling ─────────────────────────────────────────────────────────
+    async function pollJobStatus(jobId) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < JOB_TIMEOUT_MS) {
+            // Re-check auth on each poll — long polling loops can outlast token expiry
+            await ensureAuth();
+            const { data } = await httpClient.get(`/domains/status/${jobId}`, {
+                headers: getAuthHeaders(),
+            });
+            if (data.status === "completed") {
+                return data;
+            }
+            if (data.status === "failed") {
+                throw new Error(data.error ?? `Job ${jobId} failed: domain provisioning was unsuccessful`);
+            }
+            // Wait before polling again
+            await new Promise((resolve) => setTimeout(resolve, JOB_POLL_INTERVAL_MS));
+        }
+        throw new Error(`Job ${jobId} timed out after ${JOB_TIMEOUT_MS / 1000}s. ` +
+            "The domain may still be provisioning — check status later with get_domain_info.");
+    }
+    return {
+        http: httpClient,
+        ensureAuth,
+        getAuthHeaders,
+        requiresPrivateKey,
+        pollJobStatus,
+    };
+}
+// ── Error Formatting ──────────────────────────────────────────────────────
+/**
+ * Format any error into a consistent MCP tool result.
+ *
+ * Handles:
+ * - Axios errors with Bloomfilter API error responses
+ * - Rate limiting (429)
+ * - Network/connection errors
+ * - Generic errors
+ */
+export function formatToolError(error, apiUrl) {
+    if (axios.isAxiosError(error)) {
+        // Rate limited
+        if (error.response?.status === 429) {
+            const data = error.response.data;
+            const message = data?.message ?? "Too many requests";
+            return {
+                content: [{ type: "text", text: `Rate limited: ${message}. Please wait before retrying.` }],
+                isError: true,
+            };
+        }
+        // API error response
+        if (error.response?.data) {
+            const data = error.response.data;
+            const status = error.response.status;
+            // x402 payment responses — two cases:
+            // 1. Initial 402 with accepts array (no x402 wrapper, or wrapper disabled)
+            // 2. Retry 402 after x402 wrapper tried to pay but settlement failed
+            if (status === 402) {
+                if (data.accepts) {
+                    // Case 1: Initial 402 with payment requirements
+                    const accepts = data.accepts;
+                    const amount = accepts[0]?.price ?? accepts[0]?.amount;
+                    const description = data.resource?.description;
+                    const detail = description
+                        ? `${description} requires payment of ${amount} USDC`
+                        : `Payment of ${amount} USDC required`;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Payment required: ${detail}. Ensure your wallet has sufficient USDC balance.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Case 2: Payment was attempted but failed (insufficient balance, settlement error, etc.)
+                const serverMsg = data.message ?? data.error ?? data.detail;
+                const detail = serverMsg ?? "payment was attempted but could not be settled on-chain";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Payment failed: ${detail}. Check that your wallet has sufficient USDC balance on Base.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const code = data.code ?? `HTTP ${status}`;
+            const message = data.message ??
+                data.error ??
+                data.detail ??
+                error.response.statusText ??
+                `Request failed with status ${status}`;
+            return {
+                content: [{ type: "text", text: `Error [${code}]: ${message}` }],
+                isError: true,
+            };
+        }
+        // Network/connection error
+        if (error.code === "ECONNREFUSED" || error.code === "ENOTFOUND") {
+            const url = apiUrl ?? error.config?.baseURL ?? "unknown";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to connect to Bloomfilter API at ${url}. ` +
+                            "Check that the API is running and BLOOMFILTER_API_URL is correct.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Timeout
+        if (error.code === "ECONNABORTED" || error.code === "ERR_CANCELED") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Request timed out. The Bloomfilter API may be slow or unreachable.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Generic axios error
+        return {
+            content: [{ type: "text", text: `Request failed: ${error.message}` }],
+            isError: true,
+        };
+    }
+    // Non-axios error
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * @bloomfilter/mcp-server
+ *
+ * MCP server for Bloomfilter — enables AI agents to register ICANN domain
+ * names, manage DNS records, and check pricing via the Model Context Protocol.
+ *
+ * Usage:
+ *   BLOOMFILTER_PRIVATE_KEY=0x... npx @bloomfilter/mcp-server
+ *
+ * Environment variables:
+ *   BLOOMFILTER_API_URL      — API base URL (default: https://api.bloomfilter.xyz)
+ *   BLOOMFILTER_PRIVATE_KEY  — EVM private key for payments + auth (optional for free tools)
+ *   BLOOMFILTER_NETWORK      — x402 network (default: eip155:8453)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}