# osint-tools-mcp-server

Adds an MCP server with seven OSINT tools to your assistant, so it can trace a username, check email registrations and look into a domain.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 118 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/osint-tools-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/osint-tools-mcp-server

## What it does

The skill gives the assistant seven tools: `sherlock`, `holehe`, `spiderfoot`, `ghunt`, `maigret`, `theharvester`, `blackbird`. Each one runs as a subprocess with a timeout.

Core setup is a single install from `requirements.txt`, and it covers Sherlock, Holehe, Maigret and TheHarvester. SpiderFoot, GHunt and Blackbird are cloned and set up on their own, usually into `/opt/spiderfoot`, `/opt/ghunt` and `/opt/blackbird`. Skip that and three of the seven tools are missing from the list.

Then it comes down to the question you're asking. A username goes to Sherlock, which walks 399+ platforms. Holehe answers where an email is registered, across 120+ services. Maigret checks 3000+ sites and scores how confident each match is; Blackbird covers 581. TheHarvester pulls hosts and addresses for a domain. SpiderFoot is the heavy option: it picks the target type itself and runs 200+ modules, and a single scan takes 5 to 30 minutes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill osint-tools-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/osint-tools-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/osint-tools-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill osint-tools-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/osint-tools-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill osint-tools-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/osint-tools-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/osint-tools-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/osint-tools-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill osint-tools-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/osint-tools-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/osint-tools-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill osint-tools-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/osint-tools-mcp-server/SKILL.md

## When to use it
- trace a username across social networks and collect profile links
- find out which services an email address is registered with
- pull subdomains and addresses for a company domain
- see what a Google account shows publicly
- score username matches before trusting them

## Example prompts
- Run `anna_k` through Sherlock and list the profiles you find
- Use Holehe to check where `a.kuznetsova@example.com` is registered
- Gather subdomains and addresses for `example.com` with TheHarvester

## Similar
- [osint-recon](https://affpapa.org/en/nevibecode/skills/osint-recon.md) — skill · 486 installs
- [offensive-osint](https://affpapa.org/en/nevibecode/skills/offensive-osint.md) — skill · ★ 16193 repo stars
- [ctf-osint](https://affpapa.org/en/nevibecode/skills/ctf-osint.md) — skill · 10000 installs
- [osint](https://affpapa.org/en/nevibecode/skills/osint.md) — skill · 251 installs
- [osint-collector](https://affpapa.org/en/nevibecode/agents/osint-collector.md) — subagent · ★ 2482 repo stars
- [osint-agent-skills](https://affpapa.org/en/nevibecode/mcp/osint-agent-skills.md) — MCP server · ★ 54 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
