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

Tool	What it does	Cost
domain_check	Check availability + pricing	free
domain_info	Full details for a domain you own	free
domain_list	List domains in your account	free
account_balance	Prepaid balance (also verifies credentials)	free
dns_record_list	List DNS records	free
domain_set_nameservers	Set custom nameservers	free
dns_record_add / dns_record_remove	Manage DNS records	free
domain_register	Register a domain	spends money
domain_renew	Renew a domain	spends money

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.

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