NetworksDB

NetworksDB-MCP exposes a natural language interface to NetworksDB data through the MCP server protocol. It translates user questions into NetworksDB API calls, enabling you to perform IP geolocation, ASN and organization lookups, DNS queries, and broad network intelligence using plain English. Core tools exposed by the server include: ip_info for detailed IP address data, ip_geo for geolocation, org_search and org_info for organization data, org_networks to list networks owned by an organization, asn_info and asn_networks for ASN data, dns to fetch DNS records, reverse_dns for reverse lookups, and mass_reverse_dns for bulk DNS lookups. You can ask questions like “Find all information about IP 8.8.8.8” or “Show me DNS records for example.com” and the MCP layer will route the request to NetworksDB and return structured results.

Prerequisites:

• NetworksDB API key
• Python 3.8 or higher
• MCP Client installed in your environment

Step 1: Clone the repository

git clone https://github.com/mordavid/NetworksDB-MCP.git
cd NetworksDB-MCP

Step 2: Install Python dependencies

pip install -r requirements.txt

Step 3: Configure the MCP Server in your MCP config file

"mcpServers": {
  "NetworksDB-MCP": {
    "command": "python",
    "args": [
      "<Your_Path>\\NetworksDB-MCP.py"
    ],
    "env": {
      "NETWORKSDB_API_KEY": "<Your_API_Key>"
    }
  }
}

Step 4: Run the MCP server using your MCP configuration loader or test harness. Ensure the API key provided has the required NetworksDB permissions.

Tips and common issues:

• Ensure the NETWORKSDB_API_KEY is kept secret and not checked into version control.
• If you encounter import errors, verify Python version and dependencies in requirements.txt.
• When querying large datasets (e.g., mass_reverse_dns), consider API rate limits and pagination in NetworksDB.
• The MCP interface will return structured results; you can adapt your UI to display IP info, geolocation, DNS records, and organization networks clearly.
• If you need to change the path to NetworksDB-MCP.py, update the "args" value in the mcpServers configuration accordingly.