BurtTheCoder/mcp-maigret

Tools ·
Formats ·
Security ·
Troubleshooting ·
Docs
**mcp-maigret** is an MCP server that lets AI agents run maigret, the OSINT tool that checks a username across thousands of sites. Ask your agent to find where a handle is registered, or to analyze a profile URL, and get a saved report back. Maigret runs in Docker, so there is nothing to install besides Docker and Node.
> [!WARNING]
> Use this for legitimate, authorized OSINT research on publicly available information. Follow the law and each site's terms of service, and respect people's privacy. Some sites rate-limit or block automated lookups.
Highlights
- **Username search** across hundreds to thousands of sites, filterable by tag (photo, dating, us, ...).
- **URL analysis.** Hand it a profile URL and maigret extracts what it can and looks for linked usernames.
- **Six report formats** (txt, html, csv, json, xmind, pdf), saved to a directory you choose. See which ones work today.
- **Hardened inputs.** Strict validation and execFile with argument arrays. No shell is ever involved. See Security.
- **Docker-based.** The maigret image is pulled on first use, so every machine runs the same maigret.
How it works
Quickstart
**Requirements:** Node.js 18 or newer, and Docker installed and running. Developed and tested on macOS. Linux and Windows (Docker Desktop) should work but are untested.
**1. Pick a reports directory.** The server saves reports here. It is created if missing. The variable is required.
**2. Add the server to your client.**
Claude Code
Claude Desktop
Edit the config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), then restart Claude Desktop:
Smithery
From source
Then point your client at node /absolute/path/to/mcp-maigret/build/index.js with the same MAIGRET_REPORTS_DIR variable.
**3. Try it.** Ask your agent: *"Use maigret to check where the username octocat is registered, filtered to the coding tag."*
The first search pulls the maigret image (about 800 MB), so it takes longer.
Tools
search_username
Search for a username across social networks and sites.
| Parameter | Type | Default | Description |
|---|---|---|---|
| username | string, required | | Letters, digits, _, - and . only, up to 100 characters |
| format | enum | txt | txt, html, csv, json, xmind or pdf (see formats) |
| use_all_sites | boolean | false | Check all sites in maigret's database instead of the top 500 |
| tags | string[] | none | Only check sites with these tags. Letters, digits, _ and - only |
The result contains the path of the saved report and maigret's console output. If the report file was not produced, the result says so instead of reporting success.
parse_url
Parse a URL to extract information and search for associated usernames.
| Parameter | Type | Default | Description |
|---|---|---|---|
| url | string, required | | An http or https URL without shell metacharacters |
| format | enum | txt | Same options as above |
Results come back as maigret's scan output text.
Output formats
Reports are written to MAIGRET_REPORTS_DIR. Maigret picks the file names, and for some formats it adds a suffix. When maigret finds related usernames it can write extra reports next to the main one (for example report_octocatsup.txt).