Skip to content
MCP server

OpenOSINT

Passive-by-default OSINT lookups for AI agents: DNS, WHOIS, IP, breaches, Shodan and more

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Web, self-hosted
Runs
Locally
Version
2.38.2
Listing updated
3 days ago

About OpenOSINT

OpenOSINT is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

OpenOSINT bundles 21 public-source tools behind a natural-language interface, an Agent Skill, a CLI and this MCP server. Only passive tools are on by default, and every finding cites the tool call that produced it. Run through uvx --from openosint openosint-mcp, it needs uv and no API keys for the default flow.

Several tools need no key, such as DNS and SPF or DMARC records, RDAP, WHOIS, GDELT news mentions, paste-site mentions and search-dork generation. Others add a key for HaveIBeenPwned breaches, Shodan, Censys, VirusTotal, AbuseIPDB, and an IP2Location lookup that is a sponsored integration. The built-in agent REPL needs an Anthropic API key.

An exposure command grades a domain, for example flagging a missing HSTS header or a DMARC record without a reporting address, and some checks touch the target. The project is open source, with a local web app and a hosted OpenOSINT Cloud whose first check is free.

Install

Run in a terminal

claude mcp add openosint --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HIBP_API_KEY='<HIBP_API_KEY>' --env IPINFO_TOKEN='<IPINFO_TOKEN>' --env IP2LOCATION_API_KEY='<IP2LOCATION_API_KEY>' --env ABUSEIPDB_API_KEY='<ABUSEIPDB_API_KEY>' -- uvx openosint

Add to claude_desktop_config.json

{
  "mcpServers": {
    "openosint": {
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<HIBP_API_KEY>",
        "IPINFO_TOKEN": "<IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openosint": {
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<HIBP_API_KEY>",
        "IPINFO_TOKEN": "<IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "openosint": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<HIBP_API_KEY>",
        "IPINFO_TOKEN": "<IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openosint": {
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<HIBP_API_KEY>",
        "IPINFO_TOKEN": "<IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openosint": {
      "command": "uvx",
      "args": [
        "openosint"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "HIBP_API_KEY": "<HIBP_API_KEY>",
        "IPINFO_TOKEN": "<IPINFO_TOKEN>",
        "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>",
        "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>"
      }
    }
  }
}

Configuration

  • ANTHROPIC_API_KEYAnthropic API key — required for the AI agent REPLRequired
  • HIBP_API_KEYHaveIBeenPwned API key for breach detection (search_breach tool)
  • IPINFO_TOKENipinfo.io token for higher IP lookup rate limits (search_ip tool)
  • IP2LOCATION_API_KEYIP2Location API key for enhanced IP intelligence (search_ip2location tool)
  • ABUSEIPDB_API_KEYAbuseIPDB API key for IP abuse reputation checks (search_abuseipdb tool)

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

search_dns
DNS records, SPF and DMARC
search_rdap
Registrar, dates and name servers
search_whois
WHOIS registration data
search_ip
Hostname, ASN and city for an IP
search_ip2location
Geolocation, ISP and proxy, VPN or Tor flags
search_gdelt_geo
Geolocated news mentions
generate_dorks
Search-dork URLs for a target
search_paste
Paste-site mentions
search_github
Repos, code and users
search_breach
Breaches for an email
search_shodan
Open ports and banners
search_censys
Hosts and certificates
search_virustotal
URL, domain and IP reputation
search_abuseipdb
IP abuse reports
search_dorks_live
Live dork results
search_footprint
Web footprint

What it does

Keyless passive tools
Run DNS, RDAP, WHOIS, GDELT and paste-site lookups without keys.
Keyed intelligence sources
Add HaveIBeenPwned, Shodan, Censys, VirusTotal and AbuseIPDB with your own keys.
Cited findings
Each finding names the tool call that produced it.
Exposure grading
Score a domain and list issues such as missing HSTS.
Local web app
Run chat, graph and globe views locally with one command.
Hosted version
Use OpenOSINT Cloud with a free first check.

Good for

  • Check a domain's DNS, SPF and DMARC records
  • Look up registration data for a domain or IP
  • See whether an email appears in known breaches
  • Find open ports and banners for a host
  • Grade a domain's basic exposure

Pricing

Open source

Open source; some tools need third-party API keys; hosted Cloud has a free first check

Prices change. Check openosint.tech before you buy.

OpenOSINT FAQ

Do I need API keys?

Not for the default flow; some tools such as breach and Shodan lookups need keys.

Does it touch the target?

Only passive tools are on by default; the TLS and HTTP header checks touch the target.

How do I install the MCP server?

Run `claude mcp add openosint -- uvx --from openosint openosint-mcp`; uv is required.

Is there a hosted version?

Yes, OpenOSINT Cloud, with a free first check and no account.

Is OpenOSINT free?

Yes. OpenOSINT is open source, so you can use and self-host it for free.

How do I add OpenOSINT to Claude Code?

Run this command in your terminal: claude mcp add openosint --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env HIBP_API_KEY='<HIBP_API_KEY>' --env IPINFO_TOKEN='<IPINFO_TOKEN>' --env IP2LOCATION_API_KEY='<IP2LOCATION_API_KEY>' --env ABUSEIPDB_API_KEY='<ABUSEIPDB_API_KEY>' -- uvx openosint

What are the best alternatives to OpenOSINT?

The closest alternatives to OpenOSINT are REA, Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search and Agent Roast.

Alternatives to OpenOSINT

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  4. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  5. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  6. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases