internet-bs-mcp

A Model Context Protocol server for the Internet.bs (InternetBS) domain registrar API. Check availability, register, renew, and manage domains and DNS from Claude or any MCP client.

No affiliation with Internet.bs. Community-built. Use at your own risk.

Features

Safety by design

• Credentials are sent in the request body, never in a URL (keeps them out of logs).

• Paid tools are gated. domain_register and domain_renew do nothing and spend nothing unless you pass confirm: true — otherwise they return a dry-run preview.

• Test mode. Point at the InternetBS sandbox to build and verify without spending money.

Related MCP server: Domain Availability Checker MCP

Install & configure

Requires Node.js 18+.

Set environment variables:

INTERNETBS_API_KEY=your_api_key
INTERNETBS_PASSWORD=your_api_password
# Optional: use the sandbox (https://testapi.internet.bs) instead of production
INTERNETBS_TEST_MODE=true

Enable API access and (recommended) IP allowlisting in your Internet.bs account first. For the public sandbox, use INTERNETBS_API_KEY=testapi and INTERNETBS_PASSWORD=testpass.

Add to Claude Code

claude mcp add internetbs \
  -e INTERNETBS_API_KEY=your_key \
  -e INTERNETBS_PASSWORD=your_password \
  -- npx -y internet-bs-mcp

Add to Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "internetbs": {
      "command": "npx",
      "args": ["-y", "internet-bs-mcp"],
      "env": {
        "INTERNETBS_API_KEY": "your_key",
        "INTERNETBS_PASSWORD": "your_password"
      }
    }
  }
}

Registering a domain

domain_register requires a full contact when confirm: true — it's applied to the registrant, admin, technical, and billing roles that InternetBS requires:

{
  "domain": "example.com",
  "period": "1Y",
  "confirm": true,
  "contact": {
    "firstName": "Jane", "lastName": "Doe",
    "email": "jane@example.com", "phoneNumber": "+1.7065550100",
    "street": "123 Main St", "city": "Augusta",
    "postalCode": "30901", "countryCode": "US"
  }
}

Develop

npm install
npm run build
node test/probe.mjs   # boots the server against the sandbox and exercises tools

License

MIT