{
  "markdown": "# IP2WHOIS MCP Server\n[![mcp-ip2whois MCP server](https://glama.ai/mcp/servers/ip2whois/mcp-ip2whois/badges/score.svg)](https://glama.ai/mcp/servers/ip2whois/mcp-ip2whois)\n\nA Model Context Protocol (MCP) server that provides comprehensive WHOIS lookup capabilities using the **IP2WHOIS API**. This server allows AI agents to query domain registration details, including expiry dates, registrar information, and registrant data. This server also supports query on hosted domains by IP address.\n\n## Features\n\n-   **Domain Lookup**: Retrieve detailed WHOIS data for any domain name.\n\n-   **Hosted Domains Lookup**: Retrieve hosted domains data for any IP address.\n    \n-   **Comprehensive Data**: Includes domain age, nameservers, registrar info, and administrative/billing contact details.\n    \n-   **FastMCP Framework**: Built using the high-performance FastMCP Python framework.\n\n## Requirement\n\nThis MCP server requires an API key to work. You can [sign up](https://www.ip2location.io/sign-up) for a free API key and enjoy up to 500 queries per month.\n\nThe setup also use `uv`, which can be install by following [the guide](https://modelcontextprotocol.io/quickstart/server#set-up-your-environment).\n\n## Setup\n\nFollow the steps to use this MCP server with Claude Desktop:\n 1. Setup the `uv` package manager, you can once again refer to [the guide](https://modelcontextprotocol.io/quickstart/server#set-up-your-environment) to do so.\n 2. Make sure you have installed the Claude Desktop, if you haven't, kindly download from [here](https://claude.ai/download) for Windows and MacOS users, or follow [this guide](https://modelcontextprotocol.io/quickstart/client) for Linux user.\n 3. Open the `claude_desktop_config.json` in your choice of editor, if you do not having one yet, follow [this guide](https://modelcontextprotocol.io/quickstart/server#testing-your-server-with-claude-for-desktop) to create one.\n 4. Add the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ip2whois\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-ip2whois\"],\n      \"env\": {\n        \"IP2WHOIS_API_KEY\": \"<YOUR API key HERE>\"\n      }\n    }\n  }\n}\n```\n 5. To get your API key, just [login](https://www.ip2location.io/log-in) to your dashboard and get it from there. Replaced the `<YOUR API key HERE>` in above with your actual API key.\n 6. Restart the Claude Desktop after save the changes, and you should see it appear in the `Search and tools` menu.\n\n## Usage\n\nTo query the WHOIS information, just enter your query about the domain in a chat in Claude Desktop. Some of the example query will be:\n\n- Who is the registrar of the (domain)?\n- Who is the owner of (domain)?\n- What is the WHOIS for (domain)?\n\nFor instance, below is the result of the domain google.com:\n\n![The output of the domain google.com](example.png \"The output of the domain google.com\")\n\nTo query for the hosted domains by IP address, just enter your query about the IP in a chat in Claude Desktop. Some of the example query will be:\n- What domains did (IP) have?\n- What are the domains in (IP)?\n- What's the domain owned by (IP)?\n\nIn Claude Desktop, the model will automatically generate the output based on the result returned by IP2WHOIS MCP server.\n\n## Environment Variable\n\n`IP2WHOIS_API_KEY`\n\nThe IP2WHOIS API key, which allows you to query up to 500 per month for free and more details of the IP address. You can [sign up](https://www.ip2location.io/sign-up) for a free API key, or [subscribe](https://www.ip2location.io/pricing) to a plan to enjoy more benefits.\n \n## Tools\n\n### `get_whois`\n\nLook up WHOIS data for a domain name.\n\n-   **Arguments**:\n    \n    -   `domain` (string): The domain name to look up (e.g., `google.com`).\n        \n-   **Output**: Returns a JSON object containing:\n    \n    -   `domain_id`, `status`, `domain_age`\n        \n    -   `create_date`, `update_date`, `expire_date`\n        \n    -   `registrar` (name, url, etc.)\n        \n    -   `registrant` (name, organization, country)\n        \n    -   `nameservers`\n\n### `get_hosted_domains`\n\nQuery for the list of hosted domain names by IP address.\n\n-   **Arguments**:\n    \n    -   `ip` (string): The IP address (IPv4 or IPv6) to look up.\n        \n-   **Output**: Returns a JSON object containing the domains hosted on the ip address, and the total number of hosted domains found\n\n## License\n\nSee the LICENSE file.\n\n<!-- mcp-name: io.github.ip2whois/mcp-ip2whois -->",
  "bytes": 4423,
  "sha": "7facc37742666fee31b47966ad7af0001525c775543ef0e0ca711bc1c0c718e9",
  "repo_slug": "ip2whois/mcp-ip2whois",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ip2whois_mcp_ip2whois_d908d552/readme"
}