MCP Maigret logo

MCP Maigret

by BurtTheCoder

Searches public sites for usernames and analyzes URLs through Maigret, with Docker-backed reports in several output formats.

Install MCP Maigret

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "burtthecoder-mcp-maigret": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-maigret"
      ],
      "env": {
        "MAIGRET_REPORTS_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

BurtTheCoder/mcp-maigret MCP server exposes Maigret for username searches across social networks and public websites, plus URL analysis. It runs Maigret through Docker and saves generated reports to a configured directory, with output options including PDF, HTML, JSON, CSV, TXT, and XMind. Reach for it when an MCP-compatible client needs public OSINT research with username filtering, site tags, or profile URL parsing.

Use cases

  • Search public sites for a username
  • Filter username searches by site tags
  • Analyze profile URLs for associated usernames
  • Generate OSINT reports in JSON or PDF
  • Investigate publicly available account information

Key features

  • Username searches across social networks and websites
  • URL parsing with associated username searches
  • Site filtering by tags
  • Multiple report formats
  • Docker-based Maigret execution
  • Input validation for usernames, URLs, and tags

Tools2

What MCP Maigret lets your agent do. Expand a tool for its parameters.

Self-reported~38 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

18/18 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 1Low 0

Scanned 9h ago via OSV.dev · mcp-maigret (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars268Stargazers on the source repository.
npm downloads230Package downloads in the last 30 days.
Last commit12d agoMost recent push to the default branch.
Tools exposed2Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Maigret works

What BurtTheCoder/mcp-maigret MCP server does

BurtTheCoder/mcp-maigret MCP server brings the Maigret OSINT tool into MCP-compatible applications. It searches public websites and social networks for a supplied username, then produces a report in a selected format. It can also inspect a URL, extract information from it, and search for associated usernames.

The server is intended for legitimate research using publicly available information. Searches should respect privacy requirements, applicable data protection laws, and the terms of the services being queried. Automated requests may also be rate-limited or blocked by some sites.

How it works

The MCP interface exposes two primary operations. search_username accepts a username and optional search controls. By default, it searches the top 500 sites, but use_all_sites can expand the search to all available sites. A tags array can narrow the sites searched, such as sites tagged for photography, dating, or a region. Usernames are limited to letters and numbers, underscores, hyphens, and periods, with a maximum length of 100 characters.

parse_url accepts an HTTP or HTTPS URL and can generate a report while looking for related usernames. Both operations default to PDF output, with TXT, HTML, JSON, CSV, and XMind also supported. The listed MCP fields include username, format, use_all_sites, tags, url, and the corresponding operation names such as username, format, use_all_sites, tags, parse_url, and url.

Setup and configuration

BurtTheCoder/mcp-maigret MCP server requires Node.js 18 or newer, Docker, and a writable reports directory. Docker Desktop is required on Windows and macOS; Linux users need a working Docker installation and permission to run Docker commands.

The documented npm setup installs the package globally with npm install -g mcp-maigret. Configure the MCP client to run the mcp-maigret command and set MAIGRET_REPORTS_DIR to an existing directory where reports can be written. The README specifically documents Claude Desktop configuration and requires restarting the client after configuration changes. A source-based option clones the repository, runs npm install, builds the project, and starts its generated build/index.js file with Node.js.

Tools and capabilities

  • Search usernames across hundreds of public sites.
  • Expand searches beyond the default top-500 site set.
  • Filter searched sites with validated tags.
  • Parse profile or other HTTP/HTTPS URLs for associated usernames.
  • Write reports as TXT, HTML, PDF, JSON, CSV, or XMind files.
  • Execute Maigret using Docker for the underlying search process.

Limitations and notes

The reports directory must already exist and be writable, and the MAIGRET_REPORTS_DIR setting must be present. Docker must be installed and running. Invalid usernames, URLs, or tags are rejected according to the server’s input rules, including checks against shell metacharacters in URLs.

The implementation uses argument arrays and execFile() rather than shell-interpolated command strings, and Docker commands are run without shell interpretation. These safeguards reduce command-injection risk but do not change the need to use the server only for authorized, lawful research. Site availability and results can vary because external services may restrict automated access.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Maigret

Install Node.js 18 or later, Docker, and the npm package with `npm install -g mcp-maigret`. Then configure the `mcp-maigret` command in an MCP client.

Yes.

It searches public social networks and websites for usernames and can analyze HTTP or HTTPS URLs for associated usernames.

It supports TXT, HTML, PDF, JSON, CSV, and XMind reports. PDF is the default format for the documented search operations.

The server executes Maigret through Docker, so Docker must be installed, running, and usable by the configured account.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Maigret AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/burtthecoder-mcp-maigret?style=directory)](https://allmcps.com/mcp/burtthecoder-mcp-maigret)
HTML Embed
<a href="https://allmcps.com/mcp/burtthecoder-mcp-maigret"><img src="https://allmcps.com/api/badge/burtthecoder-mcp-maigret?style=directory" alt="MCP Maigret on AllMCPs" /></a>