InternetData MCP server
Commit Nov 14, 2026Allows an AI client to query IP and ASN databases for geolocation, anonymity, ownership, and network data metadata.
Also known as internetdata/openai-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- MIT
What is InternetData MCP?
InternetData allows an AI client to query IP and ASN databases for geolocation, anonymity, ownership, and network data metadata.
Summary generated from the project's README
About InternetData MCP server
Querying IP and ASN databases for geolocation, anonymity, and network metadata is what this server enables for developers using ChatGPT or Codex. It provides a way to interact with InternetData's collections of gzipped CSV and MMDB files through an AI client. Users can manage their organization's data assets by checking database sizes, build dates, and file integrity.
To use the server, you must sign in via the Codex CLI or the ChatGPT plugin directory. The setup requires an InternetData account and an API key with the db.download scope. The server operates remotely at a specific MCP endpoint, ensuring that no code runs on your local machine. While open databases like Tor IP and ASN are free under CC BY-SA 4.0, other datasets require a license.
The server provides four read-only tools: list_databases, database_metadata, database_checksum, and list_downloads. It also includes specialized skills like database-files for checking download status and analyze-database for inspecting columns and sample rows within a dataset.
What you can do with it
- 1Inspect database schemaRequest a description of the columns and some example data from a specific IP database.
- 2Audit licensed assetsIdentify which IP databases your organization currently holds and their most recent build dates.
- 3Troubleshoot failed downloadsInvestigate why a scheduled database download did not complete successfully.
Written from the project's README. Every use case is checked against a quote from it.
README
View on GitHubInternetData Plugin for ChatGPT and Codex
The official InternetData plugin for ChatGPT and Codex.
InternetData publishes IP and ASN databases: geolocation, anonymity, ownership and network data, as gzipped CSV and as MMDB. With this plugin you can ask about any of them: which ones your organization holds, what is inside each, sample rows, sizes and build dates, whether a copy you downloaded is intact, and what happened to a download that failed.
Getting Started
InternetData is in the plugin directory ChatGPT and Codex share: add it from its listing and sign in when it asks. Codex also installs it from the command line:
codex plugin marketplace add internetdata/openai-plugin
codex plugin add internetdata@internetdata
codex mcp login internetdata
The last line signs you in with your InternetData account, where you pick the API key Codex should use. Codex never sees the key: our MCP server uses it on your behalf. The key needs the db.download scope, which your organization's Default key has. The Codex CLI, its IDE extension and Codex in the ChatGPT desktop app read the same configuration, so one install covers all three. Any account can look into every database. The Open ones, such as Tor IP and ASN, are licensed to every organization from the start and are free under CC BY-SA 4.0. A checksum or a download of the rest needs a license, so request an evaluation if your organization doesn't have one yet.
To disconnect Codex, run codex mcp logout internetdata, or remove it under Connected applications at https://app.internetdata.io/settings/account/sessions. Access ends within about a minute.
What's in it
- The InternetData MCP server at
https://mcp.internetdata.io/mcp, with four read-only tools:list_databases,database_metadata,database_checksumandlist_downloads. - Two skills that say how to use them well:
database-filesanswers which databases you hold, how big they are, whether your copy is intact and why a download failed.analyze-databaseexplains a database's columns and sample rows, and in Codex analyzes a downloaded copy.
Try it
- "Which IP databases are we licensed for, and when were they last built?"
- "What columns does tor_ip_v1 have? Show me a few sample rows."
- "Does the checksum of my vpn_ip_v1.csv.gz match the published one?"
- "Our download failed last night. What happened?"
What it sends
The plugin runs nothing on your machine. ChatGPT or Codex sends the database IDs you ask about to https://mcp.internetdata.io/mcp, which calls the InternetData API with the key you picked and returns the answer. Each request is logged against that key as any API call is. Our privacy policy is at https://internetdata.io/privacy, and questions go to support@internetdata.io.
Other Libraries
There are official InternetData client libraries available for many languages including PHP, Python, Go, Java, and Ruby. See our GitHub at https://github.com/internetdata for more.
About InternetData
Geolocation, anonymity, ownership and network databases for IP addresses and AS numbers, licensed as files you download and query yourself.
License
This project is licensed under the MIT License.
InternetData MCP questions
What kind of data does InternetData provide?
InternetData publishes IP and ASN databases covering geolocation, anonymity, ownership, and network data.
How do I authenticate with the Codex MCP server?
You sign in using the command codex mcp login internetdata and select an API key from your InternetData account.
Are there any free databases available?
Yes, open databases like Tor IP and ASN are licensed to every organization and are free under CC BY-SA 4.0.
What tools are available through the MCP server?
The server provides four read-only tools: list_databases, database_metadata, database_checksum, and list_downloads.