get_domain_info
Retrieve comprehensive details for any registered domain including status, expiry date, and nameservers to assess domain health and ownership.
Instructions
Get detailed information about a registered domain (status, expiry, nameservers, etc.).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Fully qualified domain name (e.g., 'example.com') |
Implementation Reference
- src/tools/domain-info.ts:12-44 (handler)Handler function that calls GET /domains/:domain API and formats domain info (status, expiry, nameservers, owner) as text output.
export async function getDomainInfo( client: BloomfilterClient, params: { domain: string }, ): Promise<McpToolResult> { const keyError = client.requiresPrivateKey(); if (keyError) return keyError; try { await client.ensureAuth(); const { data } = await client.http.get<DomainInfoResponse>( `/domains/${encodeURIComponent(params.domain)}`, { headers: client.getAuthHeaders() }, ); const nameservers = data.nameservers?.length ? data.nameservers.join(", ") : "none"; const text = [ `Domain: ${data.domain}`, `Status: ${data.status}`, `Created: ${data.registeredAt}`, `Expires: ${data.expiresAt}`, `Auto-Renew: ${data.autoRenew ? "Yes" : "No"}`, `Locked: ${data.locked ? "Yes" : "No"}`, `Nameservers: ${nameservers}`, `Owner: ${data.walletAddress}`, ].join("\n"); return { content: [{ type: "text", text }] }; } catch (error) { return formatToolError(error); } } - src/tools/domain-info.ts:14-14 (schema)Input schema: requires a 'domain' string parameter (the fully qualified domain name).
params: { domain: string }, - src/index.ts:108-115 (registration)Tool registered with the MCP server under the name 'get_domain_info' with a Zod schema defining the 'domain' parameter.
server.tool( "get_domain_info", "Get detailed information about a registered domain (status, expiry, nameservers, etc.).", { domain: z.string().describe("Fully qualified domain name (e.g., 'example.com')"), }, async (params) => getDomainInfo(client, params), ); - src/tools/domain-info.ts:8-10 (helper)Imports BloomfilterClient, formatToolError, McpToolResult, and DomainInfoResponse types used by the handler.
import type { BloomfilterClient } from "../client.js"; import { formatToolError } from "../client.js"; import type { McpToolResult, DomainInfoResponse } from "../types.js";