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

Tool	Description
osint_censys_host	Censys host lookup
osint_censys_search	Censys query search
osint_shodan_host	Shodan host lookup
osint_shodan_domain	Shodan DNS/subdomains
osint_dns_lookup	DNS records
osint_whois	WHOIS registration
osint_email_search	Find company emails
osint_email_finder	Find person's email
osint_email_verify	Verify email validity
osint_breach_check	HIBP breach lookup
osint_email_services	Holehe service detection
osint_username_search	Sherlock username search
osint_person_enrich	Apollo person lookup
osint_linkedin_find	Find LinkedIn URL
osint_linkedin_profile	Get LinkedIn profile
osint_person_research	AI person research
osint_company_enrich	Apollo company lookup
osint_company_people	Find people at company
osint_linkedin_company	LinkedIn company data
osint_company_research	AI company research
osint_api_status	Check API availability
osint_query	General AI query

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