Clearfront OSINT: free, open-source AI OSINT agent that maps your digital footprint across 3,400+ public data sources. REPL, CLI, web console, MCP server.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add clearfront --env HIBP_API_KEY='<HIBP_API_KEY>' --env IPINFO_TOKEN='<IPINFO_TOKEN>' --env SHODAN_API_KEY='<SHODAN_API_KEY>' --env VIRUSTOTAL_API_KEY='<VIRUSTOTAL_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx clearfront~/.codex/config.toml
[mcp_servers.clearfront]
command = "uvx"
args = ["clearfront"]
env = { HIBP_API_KEY = "<HIBP_API_KEY>", IPINFO_TOKEN = "<IPINFO_TOKEN>", SHODAN_API_KEY = "<SHODAN_API_KEY>", VIRUSTOTAL_API_KEY = "<VIRUSTOTAL_API_KEY>", ANTHROPIC_API_KEY = "<ANTHROPIC_API_KEY>" }
# codex mcp add clearfront --env HIBP_API_KEY='<HIBP_API_KEY>' --env IPINFO_TOKEN='<IPINFO_TOKEN>' --env SHODAN_API_KEY='<SHODAN_API_KEY>' --env VIRUSTOTAL_API_KEY='<VIRUSTOTAL_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx clearfront~/.cursor/mcp.json
{
"mcpServers": {
"clearfront": {
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"clearfront": {
"type": "stdio",
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"clearfront": {
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"clearfront": {
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"clearfront": {
"command": "uvx",
"args": [
"clearfront"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"IPINFO_TOKEN": "<IPINFO_TOKEN>",
"SHODAN_API_KEY": "<SHODAN_API_KEY>",
"VIRUSTOTAL_API_KEY": "<VIRUSTOTAL_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Environment variables
HIBP_API_KEYIPINFO_TOKENSHODAN_API_KEYVIRUSTOTAL_API_KEYANTHROPIC_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.