# NameSilo MCP

> NameSilo (Domain Registrar Developer API) MCP Server manages your entire domain portfolio, DNS records, and accounts directly through developer tools. Use this server to check domain availability, register new sites, update complex DNS entries (A, CNAME, MX), manage contacts, or renew existing domains—all from your AI client without logging into a dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** domain-registrar, dns-management, namesilo, whois, devops

## Description

This server puts your NameSilo account straight into your AI client. You don't gotta log into a dashboard; you just tell your agent what you need done, and it handles all the domain, DNS, and billing stuff for you.

**Domain Control & Registration:**
Want to grab a new site name or check if one’s already taken? Start by running `check_register_availability`—it tells you right away if that specific domain is free. If it is, use `register_domain` to buy the damn thing immediately with custom settings. You can also pull up all your existing domains using `list_domains`, or get deep into one site's history and technical data with `get_domain_info`. Need to keep track of different groups of sites? Run `list_portfolios` to see what portfolios you got, then use `portfolio_add` to create a new grouping for your domains.

**DNS Management:**
You control every single record attached to any domain. If you're setting up web hosting or email, you need this. To start, run `dns_list_records` and it gives you the complete list of active records associated with that domain name. If you gotta make a new entry—like an A, CNAME, MX, or TXT record—you use `dns_add_record`. Did the value change? No sweat; just fire off `dns_update_record` to change what an existing record points to. And if you’re done with a record and it's cluttering things up, `dns_delete_record` wipes it out entirely.

**Domain Lifecycle & Maintenance:**
Managing your domains means more than just registering them. If you need to move a domain from some other registrar over to NameSilo, use `transfer_domain`. Don't let anything expire; run `renew_domain` to extend an existing registration for multiple years. You can also manage large groups of sites by listing all available portfolios with `list_portfolios`, and creating new groupings using `portfolio_add`.

**Account Billing & Contacts:**
Keep track of your money and who owns the accounts. Use `get_account_balance` to pull up exactly how much cash you've got left. If you’re running low, run `add_account_funds` to put more money in the account balance.

You don't wanna lose track of people or contacts associated with your domains either. You can see every contact profile saved using `contact_list`. Wanna add a new person? Use `contact_add` to create and save their details. If someone moves, use `contact_update` to modify existing info, or run `contact_delete` to wipe out an old profile.

## Tools

### add_account_funds
Adds money to your NameSilo account balance.

### check_register_availability
Checks if a specific domain name is available for registration.

### contact_add
Creates and saves a new contact profile for your account records.

### contact_delete
Deletes an existing contact profile from your system.

### contact_list
Retrieves a full list of all saved contact profiles.

### contact_update
Modifies details on an existing contact profile.

### dns_add_record
Adds a brand new DNS record (A, CNAME, MX, etc.) to your specified domain.

### dns_delete_record
Removes a specific DNS record from the target domain.

### dns_list_records
Lists all active DNS records associated with a given domain name.

### dns_update_record
Changes the value of an existing DNS record for the domain.

### get_account_balance
Pulls your current available funds and account balance from NameSilo.

### get_domain_info
Gets detailed WHOIS data and technical information about one specific domain.

### list_domains
Retrieves a complete list of all domains currently registered in your account.

### list_portfolios
Lists the names of all domain portfolios you have created.

### portfolio_add
Creates a new, distinct portfolio grouping for your domains.

### register_domain
Registers and purchases a brand new domain name from NameSilo.

### renew_domain
Renews an existing domain registration for an extended period.

### transfer_domain
Starts the process of moving a domain from another registrar to NameSilo.

## Prompt Examples

**Prompt:** 
```
Check if 'mcp-server-test.com' and 'mcp-server-test.net' are available.
```

**Response:** 
```
I've checked the availability: 'mcp-server-test.com' is available for $13.95/year, and 'mcp-server-test.net' is available for $12.17/year. Would you like to register either of them?
```

**Prompt:** 
```
List all DNS records for my domain 'example.com'.
```

**Response:** 
```
I found 3 DNS records for 'example.com': an A record pointing to 93.184.216.34, and two MX records for mail handling. Do you need to add or update any records?
```

**Prompt:** 
```
What is my current NameSilo account balance?
```

**Response:** 
```
Your current NameSilo account balance is $45.50. You have sufficient funds for upcoming renewals.
```

## Capabilities

### Register and Check Domains
Checks if a domain is available for registration or immediately registers it with custom settings.

### Manage DNS Records
Adds, updates, or deletes specific records (A, CNAME, MX, TXT) attached to any registered domain.

### Handle Domain Transfers and Renewals
Initiates the transfer of a domain from another registrar or renews an active registration for multiple years.

### Monitor Account Status
Checks your current account balance using `get_account_balance` and adds funds when needed via `add_account_funds`.

### Manage Contact Profiles
Creates, reads, updates, or deletes contact profiles associated with your domain assets.

## Use Cases

### Deployment Scripting
A DevOps engineer pushes a new microservice endpoint. Instead of manually logging in, they prompt their agent: 'Update the A record for example.com to point to 192.0.2.4.' The agent uses `dns_update_record` and confirms the change. Deployment is faster and less error-prone.

### Acquiring a New Brand Name
A web developer needs to secure three new domain names for a client's expansion. They use `check_register_availability` for all three, confirm they are free, and then run `register_domain` sequentially, logging the results.

### Auditing Portfolio Health
A portfolio manager needs to know which domains expire next year. They ask their agent to `list_domains`, then request that any domain approaching renewal date be flagged and passed to a script for action.

### Migrating Infrastructure
You are moving services from an old host. Instead of manually updating records, you tell your agent: 'Delete all existing MX records for example.com and add new ones pointing to the new mail server.' The agent executes `dns_delete_record` then `dns_add_record`.

## Benefits

- **Automate DNS Updates:** Don't manually log in to update records. Use `dns_add_record` or `dns_update_record` so your agent can deploy changes immediately upon a code push.
- **Full Domain Visibility:** Instead of clicking through multiple dashboards, use `list_domains` and `get_domain_info` to pull a manifest of every domain you own in one query. This saves time.
- **Zero-Friction Registration:** Need a staging environment? Check availability with `check_register_availability`, then register it instantly using `register_domain`. All from your terminal.
- **Complete Lifecycle Control:** Handle the entire process—from checking renewal status (`get_account_balance`) to initiating transfers (`transfer_domain`)—without leaving your code editor.
- **Structured Organization:** Use `list_portfolios` and `portfolio_add` to group domains logically. This helps large teams keep track of assets that belong together.

## How It Works

The bottom line is: your AI client handles the authentication and calls the tools; you just tell it what domain action you need taken.

1. 1. Subscribe to the server and provide your NameSilo API Key.
2. 2. Your AI client (Claude, Cursor, etc.) calls a tool function using specific parameters (e.g., `dns_add_record`).
3. 3. The server executes the command against NameSilo's API and returns the status or required data.

## Frequently Asked Questions

**How do I find out what domains I own using the NameSilo MCP Server?**
Run `list_domains`. This tool retrieves a complete, structured list of every domain currently registered under your account.

**Can I change an A record for my website's IP address with dns_update_record?**
Yes. The `dns_update_record` tool lets you modify existing DNS records, including changing the value of an A record to point to a new IP address.

**Do I need to use add_account_funds before renewing a domain?**
It's best practice. Always run `get_account_balance` first. If the funds shown are low, use `add_account_funds` and confirm the balance before attempting a renewal.

**What if I need to add multiple records for different domains?**
You'll run `dns_add_record` separately for each domain. The tool requires specific parameters (domain name, record type, value) per call.

**When I run `get_account_balance`, how does the MCP server handle my private API keys?**
The credentials are handled securely by Vinkius. You input your unique NameSilo key once during setup, and the connection maintains it via encrypted tokens for every subsequent call.

**What data points must I provide when initiating a transfer using `transfer_domain`?**
You must provide the target domain name, your account credentials, and the specific authorization code required by NameSilo. The tool validates these inputs before starting the transfer process.

**If my registered organization details change, how do I use `contact_update`?**
You run `contact_update` and pass the existing contact profile ID along with all new data fields. The tool will overwrite only the specified fields to prevent accidental loss of information.

**Can I check availability for multiple domains at once using `check_register_availability`?**
Yes, you can list several domain names in a single prompt request. The tool processes them sequentially and returns the status and pricing for every item checked.

**Can I check the availability of multiple domains at once?**
Yes! Use the `check_register_availability` tool with a comma-separated list of domains. The agent will return the status for each one.

**How do I update a specific DNS record?**
First, use `dns_list_records` to find the Record ID (`rrid`). Then, use the `dns_update_record` tool with that ID to modify the host or value.

**Can I see my current account balance?**
Yes, the `get_account_balance` tool retrieves your current available funds in NameSilo.