OSINT MCP Server

Unified Open Source Intelligence MCP server for Claude. Combines multiple data sources into a single, powerful intelligence gathering toolkit.

Features

Infrastructure Intelligence

• Censys - Host data, certificates, services, ASN info
• Shodan - Ports, services, vulnerabilities, DNS
• DNS/WHOIS - Domain records and registration data

Email & Identity

• Hunter.io - Email finder, verification, company emails
• HIBP - Data breach checking
• Holehe - Email service detection
• Sherlock - Username enumeration across platforms

Person Intelligence

• Apollo.io - Person enrichment (email, title, social)
• LinkedIn - Profile data, experience, education
• Perplexity - AI-powered research synthesis

Company Intelligence

• Apollo.io - Company enrichment (size, tech stack, industry)
• LinkedIn - Company profiles
• Perplexity - AI-powered company research

Installation

pip install -e .

Configuration

Create a .env file with your API keys:

# Infrastructure
CENSYS_API_TOKEN=your_censys_token
SHODAN_API_KEY=your_shodan_key

# Email & Identity
HUNTER_API_KEY=your_hunter_key
HIBP_API_KEY=your_hibp_key

# Person/Company
APOLLO_API_KEY=your_apollo_key
RAPIDAPI_KEY=your_rapidapi_key  # For LinkedIn

# AI
PERPLEXITY_API_KEY=your_perplexity_key

Usage with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "osint": {
      "command": "osint-mcp",
      "env": {
        "CENSYS_API_TOKEN": "...",
        "SHODAN_API_KEY": "...",
        "HUNTER_API_KEY": "...",
        "APOLLO_API_KEY": "...",
        "RAPIDAPI_KEY": "...",
        "PERPLEXITY_API_KEY": "..."
      }
    }
  }
}

Available Tools

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run in dev mode
fastmcp dev src/osint_mcp/server.py

# Run tests
pytest

License

MIT