Internet Names Mcp

by drewster99

196 downloads

Not rated

GitHub

Description

# Internet Names MCP Server An MCP server for checking availability of domain names, social media handles, and subreddits. Returns clean JSON responses suitable for programmatic use. ## Features - **Domain names** - Check availability via RDAP (free) or NameSilo API (free, but…

About

Details

Author: drewster99
Downloads: 196
Categories: Other, Web Scraping

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Internet Names Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

From the repository

Add to Claude Code with claude mcp add --scope user internet-names-mcp uvx internet-names-mcp or configure manually in your MCP client. Optionally set up a free NameSilo API key using uvx internet-names-mcp --setup for domain pricing. Invoke tools like check_domains, check_handles, check_subreddits, or check_everything.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "internet names mcp": {
            "internet-names-mcp": {
                "command": "uvx",
                "args": [
                    "internet-names-mcp"
                ],
                "env": {
                    "NAMESILO_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "internet-names-mcp": {
        "command": "uvx",
        "args": [
            "internet-names-mcp"
        ],
        "env": {
            "NAMESILO_API_KEY": "your_api_key_here"
        }
    }
}

Internet Names MCP Server

An MCP server for checking availability of domain names, social media handles, and subreddits. Returns clean JSON responses suitable for programmatic use.

Features

- Domain names - Check availability via RDAP (free) or NameSilo API (free, but requires API key - responses include domain prices too) - Social media handles - Instagram, Twitter/X, Reddit, YouTube, TikTok, Twitch, Threads - Subreddits - Check if subreddit names are available on Reddit - Comprehensive search - Generate name combinations and check everything at once

Quick Start

1. Add to Claude Code (Recommended)

bash
claude mcp add --scope user internet-names-mcp uvx internet-names-mcp



That's it! The server works immediately using RDAP for domain lookups.

2. Optional: Configure NameSilo API (for domain pricing)


Checking domain name availability works best if you configure a NameSilo API key. It's free and requires just a basic registration. Otherwise we fall back to using RDAP, which has some significant limitations (see below).

Set up your NameSilo API key


1. Create an account at namesilo.com (or log in)
2. Go to API Manager
3. Click Generate New API Key
4. Copy the key and run:

bash
uvx internet-names-mcp --setup



You'll be prompted to paste your API key.
On macOS, your API key is stored safely in your iCloud or login keychain as

internet-names-mcp.namesilo. On other platforms, it's stored in ~/.config/internet-names-mcp/config.json

.

Using

--setup

 is the preferred method as it stores the key securely. Alternatively, you can set it via environment variable (see Manual Configuration below).

Manual Configuration


If you're not using Claude Code, or prefer to configure MCP servers manually, add this to your MCP client's configuration file (e.g.,

claude_desktop_config.json

 for Claude Desktop):

json
{
  "mcpServers": {
    "internet-names-mcp": {
      "command": "uvx",
      "args": ["internet-names-mcp"]
    }
  }
}



To include a NameSilo API key via environment variable (if you haven't used

--setup

):

json
{
  "mcpServers": {
    "internet-names-mcp": {
      "command": "uvx",
      "args": ["internet-names-mcp"],
      "env": {
        "NAMESILO_API_KEY": "your_api_key_here"
      }
    }
  }
}



Note: Using

uvx internet-names-mcp --setup

 to store the API key is preferred over environment variables, as it uses secure storage (macOS Keychain) when available.


CLI Commands

bash
uvx internet-names-mcp --setup         # Configure API keys interactively
uvx internet-names-mcp --show-config   # Show current configuration
uvx internet-names-mcp --version       # Show version
uvx internet-names-mcp --help          # Show help



Tools


get_supported_socials()


Returns list of supported social media platforms.

Response:

json
{
  "platforms": ["instagram", "twitter", "reddit", "youtube", "tiktok", "twitch", "threads", "subreddit"]
}



Note:

subreddit is checked via check_subreddits(), not check_handles()

.

---

check_domains(names, tlds?, method?, onlyReportAvailable?)


Check domain name availability and pricing.

Parameters:
| Name | Type | Default | Description |
|------|------|---------|-------------|
|

names

 | list[str] | required | Domain names or base names to check |
|

tlds | list[str] | ["com", "io", "ai", "co", "app", "dev", "net", "org"]

 | TLDs to check |
|

method | str | "auto" | "auto", "rdap", or "namesilo"

|
|

onlyReportAvailable | bool | false

 | If true, omit unavailable domains from response |

If a name contains a dot, it's treated as a full domain. Otherwise, it's combined with each TLD.

Response:

json
{
  "available": [
    {"domain": "myapp.com", "price": 17.29},
    {"domain": "myapp.io", "price": 34.99}
  ],
  "unavailable": ["myapp.ai"],
  "summary": {
    "cheapestAvailable": {"domain": "myapp.com", "price": 17.29},
    "shortestAvailable": {"domain": "myapp.io", "price": 34.99}
  }
}



---

check_handles(username, platforms?, onlyReportAvailable?)


Check social media handle availability across platforms.

Parameters:
| Name | Type | Default | Description |
|------|------|---------|-------------|
|

username

 | str | required | The username/handle to check |
|

platforms

 | list[str] | all platforms | Platforms to check |
|

onlyReportAvailable | bool | false

 | If true, omit unavailable handles from response |

Supported platforms:

instagram, twitter, reddit, youtube, tiktok, twitch, threads



Note: Twitter/X checking uses a headless browser and takes ~4 seconds.

Response:

json
{
  "available": ["instagram", "tiktok", "youtube"],
  "unavailable": [
    {"platform": "twitter", "url": "https://x.com/myapp"},
    {"platform": "reddit", "url": "https://reddit.com/user/myapp"}
  ]
}



---

check_subreddits(names, onlyReportAvailable?)


Check subreddit name availability on Reddit.

Parameters:
| Name | Type | Default | Description |
|------|------|---------|-------------|
|

names

 | list[str] | required | Subreddit names to check (with or without r/ prefix) |
|

onlyReportAvailable | bool | false

 | If true, omit unavailable subreddits from response |

Response:

json
{
  "available": ["mynewsubreddit"],
  "unavailable": [
    {"name": "programming", "subscribers": 6835000},
    {"name": "privatesubreddit", "note": "private"}
  ]
}



---

check_everything(components, tlds?, platforms?, method?, requireAllTLDsAvailable?, onlyReportAvailable?, alsoIncludeHyphens?)


Comprehensive check across domains and social media. Generates name combinations from components, checks domains first (fast), then checks social handles for names that pass the domain check.

Parameters:
| Name | Type | Default | Description |
|------|------|---------|-------------|
|

components | list[str] | required | Name components to combine (e.g., ["red", "sweater"]

) |
|

tlds | list[str] | ["com", "net", "org", "io", "ai"]

 | TLDs to check |
|

platforms

 | list[str] | all platforms | Social platforms to check |
|

method | str | "auto" | "auto", "rdap", or "namesilo"

|
|

requireAllTLDsAvailable | bool | false

 | If true, name must be available in ALL TLDs to pass |
|

onlyReportAvailable | bool | false

 | If true, omit unavailable items from response |
|

alsoIncludeHyphens | bool | false

 | If true, also check hyphenated versions |

Name Generation:
From components

["red", "sweater"]

, generates:
- Single components:

red, sweater


- Concatenations:

redsweater, sweaterred



Response:

json
{
  "availableDomains": [
    {"domain": "redsweater.com", "price": 17.29},
    {"domain": "redsweater.io", "price": 34.99}
  ],
  "domainSuccessfulBasenames": ["redsweater", "sweaterred"],
  "availableHandles": {
    "redsweater": ["instagram", "twitter", "youtube"],
    "sweaterred": ["instagram", "tiktok"]
  },
  "unavailableHandles": {
    "redsweater": [{"platform": "reddit", "url": "..."}]
  },
  "summary": {
    "fullyAvailable": ["sweaterred"],
    "cheapestDomain": {"domain": "redsweater.com", "price": 17.29}
  }
}

The

fullyAvailable

 list contains names that are available on ALL checked platforms.

Domain Lookup Methods


| Method | Description | Pricing | Speed |
|--------|-------------|---------|-------|
|

auto

 | Uses NameSilo if API key configured, otherwise RDAP | With NameSilo | Fast |
|

rdap

 | Direct registry queries via IANA bootstrap | No | Fast |
|

namesilo

 | NameSilo API (requires API key) | Yes | Fast |

RDAP Limitations


RDAP is free and requires no API key, but has some limitations:

- TLD coverage - Not all top level domains (TLDs) have RDAP servers. Queries for unsupported TLDs will fail. RDAP works for .com, .net, .org, .app, .ai and more. See deployment.rdap.org for an up-to-date list (look for 'Yes' in the 'RDAP' column).
- No pricing - RDAP only reports availability, not the cost to register the domain.
- False positives - A domain may appear available via RDAP but actually be reserved or considered "premium" by registrars, making it effectively unavailable or prohibitively expensive to purchase.

For reliable results with pricing, configure a NameSilo API key.

Configuration


API key storage:
- macOS: Keychain (as

internet-names-mcp.namesilo

)
- Linux:

~/.config/internet-names-mcp/config.json


- Windows:

%APPDATA%/internet-names-mcp/config.json



API key lookup order (first match wins):
1. macOS Keychain (on macOS only)
2. Environment variable (

NAMESILO_API_KEY

)
3. Config file (fallback)

Development


Local Setup


The

devsetup.sh

 script handles virtual environment creation and dependency installation:

bash
git clone <repo-url> InternetNamesMCP
cd InternetNamesMCP
source devsetup.sh          # Creates .venv, activates it, installs dependencies
playwright install chromium # Required for Twitter/X handle checking



Options:
-

source devsetup.sh

 - Set up environment (default)
-

source devsetup.sh --clean

 - Delete venv and caches
-

source devsetup.sh --clean --setup

 - Clean rebuild

API Key Configuration (Development)


When running from source, use the module directly instead of

uvx

bash
source devsetup.sh  # Activate environment first

python -m internet_names_mcp --setup       # Configure API keys interactively
python -m internet_names_mcp --show-config # Show current configuration and key source
python -m internet_names_mcp --version     # Show version



Running Tests

``bash source devsetup.sh # Activate environment first

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Internet Names MCP Server

Features

Quick Start

1. Add to Claude Code (Recommended)

2. Optional: Configure NameSilo API (for domain pricing)

Set up your NameSilo API key

Manual Configuration

CLI Commands

Tools

get_supported_socials()

check_domains(names, tlds?, method?, onlyReportAvailable?)

check_handles(username, platforms?, onlyReportAvailable?)

check_subreddits(names, onlyReportAvailable?)

check_everything(components, tlds?, platforms?, method?, requireAllTLDsAvailable?, onlyReportAvailable?, alsoIncludeHyphens?)

Domain Lookup Methods

RDAP Limitations

Configuration

Development

Local Setup

API Key Configuration (Development)

Running Tests

Install

More like this

@mendableai/firecrawl Mcp Server

Sequential Thinking

Filesystem

EverArt

Google Drive

Puppeteer