26 free OSINT tools as MCP tools for AI agents. Auto-installs everything on first run.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add osint-rjn32s --env SHODAN_KEY='<SHODAN_KEY>' --env VIRUSTOTAL_KEY='<VIRUSTOTAL_KEY>' --env IPINFO_KEY='<IPINFO_KEY>' --env HIBP_KEY='<HIBP_KEY>' --env URLSCAN_KEY='<URLSCAN_KEY>' -- uvx osint-mcp~/.codex/config.toml
[mcp_servers.osint-rjn32s]
command = "uvx"
args = ["osint-mcp"]
env = { SHODAN_KEY = "<SHODAN_KEY>", VIRUSTOTAL_KEY = "<VIRUSTOTAL_KEY>", IPINFO_KEY = "<IPINFO_KEY>", HIBP_KEY = "<HIBP_KEY>", URLSCAN_KEY = "<URLSCAN_KEY>" }
# codex mcp add osint-rjn32s --env SHODAN_KEY='<SHODAN_KEY>' --env VIRUSTOTAL_KEY='<VIRUSTOTAL_KEY>' --env IPINFO_KEY='<IPINFO_KEY>' --env HIBP_KEY='<HIBP_KEY>' --env URLSCAN_KEY='<URLSCAN_KEY>' -- uvx osint-mcp~/.cursor/mcp.json
{
"mcpServers": {
"osint-rjn32s": {
"command": "uvx",
"args": [
"osint-mcp"
],
"env": {
"SHODAN_KEY": "<SHODAN_KEY>",
"VIRUSTOTAL_KEY": "<VIRUSTOTAL_KEY>",
"IPINFO_KEY": "<IPINFO_KEY>",
"HIBP_KEY": "<HIBP_KEY>",
"URLSCAN_KEY": "<URLSCAN_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"osint-rjn32s": {
"type": "stdio",
"command": "uvx",
"args": [
"osint-mcp"
],
"env": {
"SHODAN_KEY": "<SHODAN_KEY>",
"VIRUSTOTAL_KEY": "<VIRUSTOTAL_KEY>",
"IPINFO_KEY": "<IPINFO_KEY>",
"HIBP_KEY": "<HIBP_KEY>",
"URLSCAN_KEY": "<URLSCAN_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"osint-rjn32s": {
"command": "uvx",
"args": [
"osint-mcp"
],
"env": {
"SHODAN_KEY": "<SHODAN_KEY>",
"VIRUSTOTAL_KEY": "<VIRUSTOTAL_KEY>",
"IPINFO_KEY": "<IPINFO_KEY>",
"HIBP_KEY": "<HIBP_KEY>",
"URLSCAN_KEY": "<URLSCAN_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"osint-rjn32s": {
"command": "uvx",
"args": [
"osint-mcp"
],
"env": {
"SHODAN_KEY": "<SHODAN_KEY>",
"VIRUSTOTAL_KEY": "<VIRUSTOTAL_KEY>",
"IPINFO_KEY": "<IPINFO_KEY>",
"HIBP_KEY": "<HIBP_KEY>",
"URLSCAN_KEY": "<URLSCAN_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"osint-rjn32s": {
"command": "uvx",
"args": [
"osint-mcp"
],
"env": {
"SHODAN_KEY": "<SHODAN_KEY>",
"VIRUSTOTAL_KEY": "<VIRUSTOTAL_KEY>",
"IPINFO_KEY": "<IPINFO_KEY>",
"HIBP_KEY": "<HIBP_KEY>",
"URLSCAN_KEY": "<URLSCAN_KEY>"
}
}
}
}Environment variables
SHODAN_KEYVIRUSTOTAL_KEYIPINFO_KEYHIBP_KEYURLSCAN_KEY
Replace the placeholders with your own credentials and keep them out of version control.