================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
mcp-maigret
by BurtTheCoder
MCP (Model Context Protocol) server that wraps the Maigret OSINT username-search/URL-analysis tool so it can be invoked from MCP-compatible clients such as Claude Desktop.
172
22
Specialized01
search_username
Search for a username across social networks and sites
02
parse_url
Parse a URL to extract information and search for associated usernames
Installation
1. Prerequisites
• Node.js ≥ 18
• Python 3.8+ with Maigret installed globally (pip install maigret)
2. Clone and install
git clone https://github.com/BurtTheCoder/mcp-maigret.git
cd mcp-maigret
npm install # installs JS dependencies
3. Configuration (environment variables)
• PORT – TCP port the MCP server should listen on (default 3000)
• MAIGRET_BIN – Full path to the Maigret executable if it is not in $PATH
• MCP_TOKEN – (optional) bearer token required by clients, if you enable auth in config.json
Example:
export PORT=8080
export MCP_TOKEN=super-secret
npm start
4. Run the server
npm start # starts the MCP HTTP server
5. Verify
curl -X POST http://localhost:8080/search -H "Authorization: Bearer super-secret" -d '{"username":"example"}'
The server should return a JSON array with sites where the username was found.
Documentation
License: MIT License
Updated 7/30/2025