Labsco
namedotcom logo

Name.com

★ 2

from namedotcom

Manage domains using the Name.com API.

🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys
#email#automation#payments#documents#git#security

name.com MCP Server

npm downloads

A Model Context Protocol (MCP) server that provides access to the complete name.com API for domain management operations. This server automatically generates tools from the name.com OpenAPI specification, giving AI assistants access to all name.com API functions including domain registration, DNS management, transfers, email forwarding, URL forwarding, and more.

⚠️ Experimental Tool: This MCP server is currently experimental and defaults to name.com's test environment (mcp.dev.name.com) which requires test environment credentials. While you can configure it to use the production environment, we recommend using the test environment for initial experimentation.

This MCP server works with any AI tool that supports the Model Context Protocol (MCP). You can use it for domain management tasks through natural conversation with your preferred AI assistant. The server dynamically creates tools for every available name.com API endpoint, so you have access to the full range of domain management capabilities.

Features

  • 🔄 Complete API Access: Dynamically creates tools for every name.com API endpoint
  • 🛡️ Secure Authentication: Uses name.com API credentials with proper authentication
  • 🔧 Easy Integration: Simple configuration with popular AI tools
  • 🧪 Safe Testing: Defaults to test environment for experimentation
  • 🤖 AI-First Design: Built specifically for natural language interaction via MCP
  • 🆘 Built-in Help: Ask your AI assistant for help, troubleshooting, and documentation links

🚀 Quick Example

Now that you're set up, here's what you can do:

Ask your AI assistant:

"Can you search for available domains with 'myawesomeproject' in the name?"

Your AI assistant will:

  1. Ask permission to use the domain search tool
  2. Search name.com's test environment safely
  3. Show you available options with pricing
  4. Help you register if you want (in test mode)

Other things to try:

  • "List my current domains"
  • "Show me DNS records for my domain"
  • "Help me register a new domain"
  • "Check if example.com is available"

Environment Details

Understanding the different name.com environments and their credentials:

Test Environment (Default - Recommended)

  • URL: https://mcp.dev.name.com (default)
  • Credentials: Use your test username and token from name.com
  • Safety: Operations won't affect real domains or billing
  • Purpose: Safe experimentation and testing

Production Environment (Advanced)

  • URL: https://mcp.name.com (set NAME_API_URL=https://mcp.name.com)
  • Credentials: Use your production username and token from name.com
  • **⚠️ DANGER: All operations affect your real name.com account and domains
  • Billing: Domain registrations and services will incur real charges
  • Purpose: Live domain management

Credential Matching

Critical: Make sure your credentials match your environment:

  • Test environment (mcp.dev.name.com) → Test credentials
  • Production environment (mcp.name.com) → Production credentials

Using wrong credentials will result in authentication errors.

Getting name.com API Credentials

If you need to generate new API credentials or want to understand the different environments:

IMPORTANT: name.com provides different credentials for test vs production environments. Make sure you're using the correct credentials for your chosen environment.

  1. Log in to your name.com account
  2. Go to Account Settings > API Tokens
  3. Generate an API token
  4. Note: When you generate a token, name.com provides:
    • Test credentials (username/token) for mcp.dev.name.com
    • Production credentials (username/token) for mcp.name.com
  5. Copy the correct username and token for the environment you plan to use

Testing & Debugging (Optional)

The following section is for testing and troubleshooting your setup. If everything is working with your AI assistant, you can skip this section.

Basic Testing

Start your AI tool and try these questions:

  • "Can you list my domains?"
  • "Search for available domains with the name 'example'"
  • "Show me the DNS records for my domain"
  • "Help me register a new domain"

Your AI tool will request permission to use name.com tools, and the conversation should flow naturally.

Advanced Debugging: MCP Inspector

The MCP Inspector is excellent for testing and troubleshooting your MCP server setup if you're experiencing issues.

  1. Install the MCP Inspector (if not already installed):

    npm install -g @modelcontextprotocol/inspector

  2. Run the Inspector with your credentials:

    NAME_USERNAME=your-test-username NAME_TOKEN=your-test-token npx @modelcontextprotocol/inspector namecom-mcp

    For production environment (advanced):

    NAME_USERNAME=your-prod-username NAME_TOKEN=your-prod-token NAME_API_URL=https://mcp.name.com npx @modelcontextprotocol/inspector namecom-mcp

  3. Open the Inspector:

    • The command will output a local URL with an auth token (e.g., http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=...)
    • Open this URL in your browser

  4. Test the Connection:

    • Click "Connect" in the left sidebar
    • Once connected, click "List Tools" in the center to see all available name.com API tools
    • Select any tool to test that the endpoints are working through the MCP server
    • If you dont see any errors, but only a couple tools show up, there may have been an issue parsing the OpenAPI spec on startup. Please report this issue.

Security & Performance

  • API Token Security: Treat your name.com API token like a password
  • Safe Testing: Default test environment provides safe experimentation
  • Least Privilege: The server only accesses name.com APIs with the permissions of your API token
  • Input Validation: All inputs are validated using Zod schemas
  • Error Handling: Errors are handled gracefully without exposing sensitive information
  • API Rate Limits: Respects name.com's standard rate limits
  • Fast Startup: Tool generation takes ~2-3 seconds on first startup

MCP Ecosystem

This server is part of the growing Model Context Protocol ecosystem. The MCP is rapidly gaining adoption across AI tools, and this name.com server works with any MCP-compatible tool, giving you flexibility in choosing your preferred AI assistant for domain management tasks.

Related MCP Resources:

Support

Changelog

See the GitHub Releases page for version history and updates.