internetbs-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@internetbs-mcp check if example.com is available"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Internet.bs MCP Server
A complete Model Context Protocol server for the Internet.bs domain registrar API.
47 tools covering 100% of the Internet.bs API:
Category | Tools | What you can do |
Domains | 11 | Check availability, register, update, info, list, count, renew, restore, push, trade |
Transfers | 7 | Initiate, retry, cancel, resend auth, history, approve/reject outgoing |
DNS Records | 4 | Add, remove, update, list (A, AAAA, CNAME, MX, TXT, SRV, NS) |
Nameservers | 5 | Create, info, update, delete, list glue records |
URL Forwarding | 4 | Add, update, remove, list redirects |
Email Forwarding | 4 | Add, update, remove, list email routes |
Registrar Lock | 3 | Enable, disable, check status |
Private WHOIS | 3 | Enable, disable, check status |
Account | 4 | Balance, price list, configuration, total cost |
Verification | 2 | Registrant email verification info & resend |
Prerequisites
An Internet.bs account — Sign up at internet.bs
API credentials — Go to your account settings and request API access. You'll receive an API Key and a Password
An MCP-compatible client (see Compatibility)
No account yet? You can try everything with the free sandbox — see Test Mode below.
Related MCP server: spaceship-mcp
Important: IP Whitelisting
Internet.bs requires you to whitelist an IP address when creating an API key. Only requests coming from that IP will be accepted. This has important implications depending on how you run this MCP server:
How to find your IP address
Run one of these commands in your terminal:
curl -s ifconfig.me # Linux / Mac / WSL
curl -s api.ipify.org # Alternative (IPv4 only)Or visit whatismyip.com in your browser.
Important: Use your IPv4 address, not IPv6. If
ifconfig.mereturns an IPv6 (e.g.2a02:...), usecurl -s api.ipify.orginstead to get your IPv4.
Local mode (npx) — recommended
You run the server on your own machine. Whitelist your residential/office IP (the public IPv4 of the machine running Claude Code).
If your ISP changes your IP (common with residential connections), you'll need to update the whitelisted IP in your Internet.bs account, or create a new API key.
Self-hosted remote mode (your own server)
You run the server on a VPS/dedicated server. Whitelist the server's fixed IP.
To find the server's outbound IP:
curl -s api.ipify.org # Run this on the serverThis works well with servers that have a static IP (OVH, Hetzner, Contabo, etc.). It does NOT work with serverless platforms like Cloudflare Workers, Vercel, or AWS Lambda, because they use shared/rotating IPs that can't be whitelisted.
Multiple environments
If you need to use the API from multiple IPs (e.g., your PC + a server), you have two options:
Create multiple API keys — one per IP, each whitelisted for its own IP
Update the whitelisted IP — in your Internet.bs account when you switch environments
Option 1 — Local (via npx) — Recommended
Runs entirely on your machine. Nothing to install besides Node.js.
{
"mcpServers": {
"internetbs": {
"command": "npx",
"args": ["-y", "internetbs-mcp"],
"env": {
"INTERNETBS_API_KEY": "your-api-key",
"INTERNETBS_PASSWORD": "your-password",
"INTERNETBS_API_URL": "https://api.internet.bs"
}
}
}
}Replace your-api-key and your-password with your credentials. Requires Node.js >= 18.
Option 2 — Self-hosted remote (your own server)
Deploy on any server with a fixed IP address. Users connect via URL and pass their own credentials in headers. The server is a stateless proxy — it never stores credentials.
{
"mcpServers": {
"internetbs": {
"url": "https://your-server.com/mcp",
"headers": {
"X-InternetBS-Key": "your-api-key",
"X-InternetBS-Password": "your-password"
}
}
}
}See Self-Hosting for deployment instructions.
Warning: Serverless platforms (Cloudflare Workers free tier, Vercel, AWS Lambda) do NOT have fixed IPs. They are incompatible with Internet.bs IP whitelisting. Use a VPS with a static IP instead.
Option 3 — Docker
{
"mcpServers": {
"internetbs": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "INTERNETBS_API_KEY=your-api-key",
"-e", "INTERNETBS_PASSWORD=your-password",
"-e", "INTERNETBS_API_URL=https://api.internet.bs",
"internetbs-mcp"
]
}
}
}Build the image:
git clone https://github.com/uglyswap/internetbs-mcp.git
cd internetbs-mcp
docker build -t internetbs-mcp .Where to put the config
Client | Config file location |
Claude Code |
|
Claude Desktop |
|
Cursor | Settings > MCP Servers |
Windsurf |
|
Test Mode
Internet.bs provides a free sandbox — no account needed, no IP whitelisting:
{
"mcpServers": {
"internetbs": {
"command": "npx",
"args": ["-y", "internetbs-mcp"],
"env": {
"INTERNETBS_API_KEY": "testapi",
"INTERNETBS_PASSWORD": "testpass",
"INTERNETBS_API_URL": "https://testapi.internet.bs"
}
}
}
}The sandbox has limited data. Some operations will return test data only.
Usage Examples
Once configured, just ask in natural language:
What you want to do | Example prompt |
Check availability | "Is example.com available?" |
Register a domain | "Register mysite.com with my contact info" |
List domains | "List all my domains" |
Domain info | "Show me the details for mysite.com" |
DNS management | "Add an A record for www.mysite.com pointing to 93.184.216.34" |
Email forwarding | "Forward info@mysite.com to me@gmail.com" |
URL forwarding | "Redirect blog.mysite.com to mysite.com/blog" |
Renew | "Renew mysite.com for 2 years" |
Transfer | "Transfer example.org to my account, auth code is ABC123" |
Account | "What's my account balance?" |
Lock | "Enable registrar lock on mysite.com" |
WHOIS privacy | "Enable private WHOIS on all my domains" |
Configuration Reference
Local mode (environment variables)
Variable | Required | Description |
| Yes | Your Internet.bs API key |
| Yes | Your Internet.bs API password |
| No | API base URL. Default: |
Remote mode (headers)
Header | Required | Description |
| Yes | Your Internet.bs API key |
| Yes | Your Internet.bs API password |
| No | API base URL. Default: |
All 47 Tools
Domain Operations (11)
Tool | Description |
| Check if a domain is available for registration |
| Register a new domain name |
| Update domain contacts, nameservers, settings |
| Get detailed domain information |
| Get domain registry status |
| List all domains in the account |
| Count domains by extension |
| Renew a domain registration |
| Restore a deleted domain in redemption period |
| Push a domain to another Internet.bs account |
| Trade .eu/.fr domains (change registrant) |
Transfer Operations (7)
Tool | Description |
| Initiate a domain transfer to your account |
| Retry a failed domain transfer |
| Cancel a pending domain transfer |
| Resend transfer authorization email |
| Get transfer history for a domain |
| Approve an outgoing domain transfer |
| Reject an outgoing domain transfer |
DNS Records (4)
Tool | Description |
| Add a DNS record (A, AAAA, CNAME, MX, TXT, SRV, NS) |
| Remove a DNS record |
| Update an existing DNS record |
| List all DNS records for a domain |
Nameserver Hosts (5)
Tool | Description |
| Create a nameserver host (glue record) |
| Get host information and IPs |
| Update host IP addresses |
| Delete a nameserver host |
| List all hosts for a domain |
URL Forwarding (4)
Tool | Description |
| Add a URL forwarding rule |
| Update a URL forwarding rule |
| Remove a URL forwarding rule |
| List URL forwarding rules for a domain |
Email Forwarding (4)
Tool | Description |
| Add an email forwarding rule |
| Update an email forwarding rule |
| Remove an email forwarding rule |
| List email forwarding rules for a domain |
Registrar Lock (3)
Tool | Description |
| Enable registrar lock (prevent unauthorized transfers) |
| Disable registrar lock |
| Get current registrar lock status |
Private WHOIS (3)
Tool | Description |
| Enable private WHOIS protection (FULL or PARTIAL) |
| Disable private WHOIS protection |
| Get current private WHOIS status |
Account (4)
Tool | Description |
| Get account balance (supports multiple currencies) |
| Get pricing for all domain extensions |
| Get account configuration and settings |
| Get total annual cost of all domains |
Registrant Verification (2)
Tool | Description |
| Get registrant email verification status |
| Resend registrant verification email |
Security
Local mode — Credentials never leave your machine. API calls go directly from your computer to Internet.bs over HTTPS.
Remote mode — Credentials are passed via HTTPS headers on each request and forwarded to Internet.bs. The server does not log or persist them.
IP whitelisting — Internet.bs requires your IP to be whitelisted, adding an extra layer of security.
No database — The server is stateless. No user data, no sessions, no logs.
Open source — Full code in this repository. Audit it yourself.
Important: Your Internet.bs API credentials can register and manage domains, which involves real money. Keep your API key and password secure. Never share them publicly.
Compatibility
Client | Local (npx) | Remote (URL) | Docker |
Claude Code | Yes | Yes | Yes |
Claude Desktop | Yes | Yes | Yes |
Cursor | Yes | Yes | Yes |
Windsurf | Yes | Yes | Yes |
Zed | Yes | — | Yes |
Any MCP client | Yes | Yes | Yes |
Self-Hosting
Deploy on any server with a static IP (VPS, dedicated server, etc.).
With Docker
git clone https://github.com/uglyswap/internetbs-mcp.git
cd internetbs-mcp
docker build -t internetbs-mcp .
docker run -d --name internetbs-mcp -p 3000:3000 internetbs-mcpWith Node.js
git clone https://github.com/uglyswap/internetbs-mcp.git
cd internetbs-mcp
npm install
npm run build
npm startAs a Cloudflare Worker (advanced)
The repo includes a wrangler.toml and src/worker.ts for Cloudflare Workers deployment. However, Cloudflare Workers free tier uses shared/rotating IPs which are incompatible with Internet.bs IP whitelisting. This only works if:
You have Cloudflare Enterprise with dedicated egress IPs, or
You use the worker as a proxy behind a fixed-IP server
npx wrangler login
npm run deployWhitelisting your server's IP
Log into your Internet.bs account
Go to API settings
Create an API key whitelisted for your server's public IP
Use that API key in your deployment
If your server has multiple outbound IPs, whitelist the one used for HTTPS requests. Run
curl ifconfig.meon the server to check.
Troubleshooting
"Missing credentials" error
Make sure your headers (remote) or env vars (local) are set correctly. The API key and password are both required.
"FAILURE" status in API responses
Usually means invalid credentials, IP not whitelisted, or the operation isn't supported. Check your Internet.bs account.
IP not authorized
Internet.bs requires IP whitelisting. Go to your account settings and add your machine's public IP. Run curl ifconfig.me to check your IP.
npx is slow on first run
npx downloads the package on first use (~25KB). Subsequent runs use the cache.
Connection timeout
The Internet.bs API can occasionally be slow. The default timeout is 25 seconds. If you experience timeouts, try again.
"Unknown tool" error
Run npx internetbs-mcp@latest to force update to the latest version.
Development
git clone https://github.com/uglyswap/internetbs-mcp.git
cd internetbs-mcp
npm install
npm run dev # Local stdio server (hot reload)
npm run dev:worker # Local Cloudflare Worker (http://localhost:8787)
npm run build # Compile TypeScript
npm start # Run compiled stdio versionProject structure
src/
index.ts # stdio entry point (local mode)
worker.ts # HTTP entry point (remote/self-hosted mode)
client.ts # Internet.bs API HTTP client
types.ts # TypeScript type definitions
tools/
domain.ts # Domain management (11 tools)
transfer.ts # Domain transfers (7 tools)
dns.ts # DNS records (4 tools)
host.ts # Nameserver hosts (5 tools)
forwarding.ts # URL & email forwarding (8 tools)
lock.ts # Registrar lock (3 tools)
whois.ts # Private WHOIS (3 tools)
account.ts # Account operations (4 tools)
verification.ts # Registrant verification (2 tools)
index.ts # Aggregates all toolsContributing
Fork the repository
Create a feature branch (
git checkout -b feature/my-feature)Commit your changes
Push and open a Pull Request
For bugs, open an issue.
Links
Internet.bs — Domain registrar
Internet.bs API Documentation — Official API docs
Model Context Protocol — MCP specification
License
MIT — see LICENSE
Available Tools
47 toolsaccount_balanceB
Get the current account balance
Inputs: currency.
account_configurationB
Get the current account configuration
Inputs: no named parameters.
account_domains_total_costA
Get the total cost of all domains in the account
Inputs: no named parameters.
account_price_listB
Get the price list for domain operations
Inputs: version, currency, discountCode.
dns_record_addB
Add a DNS record to a domain
Inputs: type (required), value (required), fullRecordName (required), ttl, +1 more.
dns_record_listB
List all DNS records for a domain
Inputs: domain (required), filterType.
dns_record_removeA
Remove a DNS record from a domain
Inputs: type (required), value (required), fullRecordName (required).
dns_record_updateB
Update an existing DNS record
Inputs: type (required), newValue (required), currentValue (required), fullRecordName (required), +2 more.
domain_checkA
Check domain name availability. Returns whether the domain is available for registration.
Inputs: domain (required).
domain_countA
Count the total number of domains in your Internet.bs account.
Inputs: no named parameters.
domain_createA
Register a new domain name. Requires the domain name and optionally contact information, nameservers, and registration settings.
Inputs: domain (required), period, ns_list, autoRenew, +22 more.
domain_infoA
Get detailed information about a domain including registration dates, nameservers, contacts, status, and WHOIS settings.
Inputs: domain (required).
domain_listA
List all domains in your Internet.bs account. Supports filtering, pagination, and sorting.
Inputs: sortBy, rangeTo, rangeFrom, compactList, +4 more.
domain_pushB
Push (transfer) a domain to another Internet.bs account. The recipient must have an Internet.bs account.
Inputs: domain (required), destination (required).
domain_registry_statusA
Get the registry status (EPP status codes) of a domain. Shows statuses like clientTransferProhibited, serverHold, etc.
Inputs: domain (required).
domain_renewA
Renew an existing domain for an additional registration period.
Inputs: domain (required), period, discountCode.
domain_restoreA
Restore a deleted domain that is still within its redemption grace period. This typically incurs an additional fee.
Inputs: domain (required), discountCode.
domain_tradeA
Trade a .eu or .fr domain (change of registrant). This is required for certain TLDs when the registrant changes, as a simple update is not allowed.
Inputs: domain (required), ns_list, admin_email, billing_email, +16 more.
domain_updateC
Update an existing domain's settings including nameservers, contacts, lock status, WHOIS privacy, and auto-renewal.
Inputs: domain (required), ns_list, autoRenew, admin_email, +19 more.
email_forward_addA
Add an email forwarding rule. Emails sent to the source address will be forwarded to the destination address.
Inputs: source (required), destination (required).
email_forward_listA
List all email forwarding rules configured for a domain.
Inputs: domain (required).
email_forward_removeA
Remove an email forwarding rule for the given source email address.
Inputs: source (required).
email_forward_updateA
Update an existing email forwarding rule with a new destination address.
Inputs: source (required), destination (required).
host_createB
Create a nameserver host (glue record)
Inputs: host (required), ipList (required).
host_deleteB
Delete a nameserver host
Inputs: host (required).
host_infoB
Get information about a nameserver host
Inputs: host (required).
host_listA
List all nameserver hosts for a domain
Inputs: domain (required), compactList.
host_updateC
Update the IP addresses of a nameserver host
Inputs: host (required), ipList (required).
private_whois_disableA
Disable private WHOIS protection for a domain
Inputs: domain (required).
private_whois_enableB
Enable private WHOIS protection for a domain
Inputs: domain (required), type.
private_whois_statusA
Get the current private WHOIS protection status for a domain
Inputs: domain (required).
registrant_verification_infoB
Get registrant email verification info for a domain
Inputs: domain (required).
registrant_verification_resendB
Resend the registrant verification email for a domain
Inputs: domain (required).
registrar_lock_disableA
Disable registrar lock for a domain to allow transfers
Inputs: domain (required).
registrar_lock_enableA
Enable registrar lock for a domain to prevent unauthorized transfers
Inputs: domain (required).
registrar_lock_statusB
Get the current registrar lock status for a domain
Inputs: domain (required).
transfer_away_approveA
Approve an outgoing domain transfer (transfer away from your account to another registrar).
Inputs: domain (required).
transfer_away_rejectA
Reject an outgoing domain transfer (transfer away from your account to another registrar). A reason must be provided (10-512 characters).
Inputs: domain (required), reason (required).
transfer_cancelA
Cancel a pending domain transfer.
Inputs: domain (required).
transfer_historyB
Get the transfer history for a domain.
Inputs: domain (required).
transfer_initiateB
Initiate a domain transfer to your Internet.bs account. Requires the domain name and optionally the EPP auth code, registration period, registrant contact info, nameservers, and other transfer options.
Inputs: domain (required), period, ns_list, privateWhois, +12 more.
transfer_resend_auth_emailA
Resend the transfer authorization email for a pending domain transfer.
Inputs: domain (required).
transfer_retryA
Retry a previously failed domain transfer. Optionally provide an updated EPP auth code.
Inputs: domain (required), transferAuthInfo.
url_forward_addA
Add a URL forwarding rule for a domain. The source URL will redirect or frame to the destination URL.
Inputs: source (required), destination (required), isFramed, siteTitle, +3 more.
url_forward_listA
List all URL forwarding rules configured for a domain.
Inputs: domain (required).
url_forward_removeB
Remove a URL forwarding rule for the given source URL.
Inputs: source (required).
url_forward_updateA
Update an existing URL forwarding rule. Only the source is required; all other fields are optional and only provided values will be updated.
Inputs: source (required), isFramed, siteTitle, destination, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 47 tools
The tools are grouped by resource (domain, transfer, DNS, etc.), but there is overlap between domain_update and dedicated toggles like registrar_lock_enable and private_whois_enable. Also, several status-querying tools (domain_info, domain_registry_status, registrar_lock_status, private_whois_status) provide similar information, which could confuse an agent.
All tools follow a consistent resource_action or resource_query pattern (e.g., domain_create, dns_record_add, registrar_lock_enable, account_balance). Even with 47 tools, the naming convention is predictable and uniform across all categories.
47 tools is far above the 25+ threshold that typically makes a tool set unwieldy. While the domain is broad, the sheer number makes it difficult for an agent to efficiently navigate and select the right tool without significant overhead.
The tool set covers the full lifecycle of domain management: registration, renewal, restore, transfer (in/out), DNS, hosts, URL/email forwarding, registrar lock, WHOIS privacy, account management, and verification. There are no obvious dead ends or missing core operations for a domain registrar server.
Maintenance
Related MCP Connectors
MCP server for DNSimple — domains, DNS zone records, availability, pricing and contacts.
Official Porkbun MCP server: domains, DNS, SSL, hosting and Cloudflare via the Porkbun API.
380+ live data, validation and utility APIs in one MCP server: IP, DNS, email, FX, weather and more.
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server for Dynadot domain registrar API3 — manage domains, DNS, contacts, transfers & more6766 npm2MIT
- AlicenseBqualityBmaintenanceMCP server for managing domain registrations, DNS, WHOIS privacy, transfers, and marketplace listings via Spaceship API.36128 npm2MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for domain management, enabling domain availability checks, bulk domain checks, and API connectivity testing through the RealtimeRegister API.17 npm1MIT
- AlicenseAqualityDmaintenanceComprehensive MCP server for the Namecheap API, enabling domain management, DNS record control, nameserver settings, and domain registration from any MCP client.1032 npmMIT