# recon

recon maps public technology and identity footprints for any domain using DNS records and Certificate Transparency logs without API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: blisspixel
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/blisspixel/recon
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away; a PowerShell command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/recon

## What it does

The tool extracts public infrastructure indicators, focusing on identity providers, cloud networks, and mail controls like SPF, DKIM, and DMARC. It relies on passive observation rather than port scans or web scraping. Out of the box, MTA-STS validation is the only HTTP request aimed at the target domain.

Output reflects observed evidence rather than an authoritative security verdict. Queries hit external DNS infrastructure, meaning authoritative resolvers see incoming lookups. Standard lookups use a 24-hour local cache unless bypassed.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add recon -- uvx recon-tool
```
uvx runs the command named after the package; if the README names another one, use uvx --from recon-tool <command>

### Codex

**Platform CLI**
```bash
codex mcp add recon -- uvx recon-tool
```
uvx runs the command named after the package; if the README names another one, use uvx --from recon-tool <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "recon": {
            "command": "uvx",
            "args": [
                "recon-tool"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from recon-tool <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "recon": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "recon-tool"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from recon-tool <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add recon uvx recon-tool
```
uvx runs the command named after the package; if the README names another one, use uvx --from recon-tool <command>

## When to use it
- inspect email controls including SPF, DKIM, and MTA-STS for a target domain
- identify public SaaS, cloud hosting, and identity vendors behind a domain
- map technological footprint without active port scanning or API tokens

## Example prompts
- Check identity providers and mail controls for domain `example.com`
- Compare public cloud and SaaS footprint for `example.com` and `test.com`

## Similar
- [attack-surface-recon](https://affpapa.org/en/nevibecode/skills/attack-surface-recon.md) — skill · 575 installs
- [api-recon-and-docs](https://affpapa.org/en/nevibecode/skills/api-recon-and-docs.md) — skill · 4200 installs
- [osint-recon](https://affpapa.org/en/nevibecode/skills/osint-recon.md) — skill · 486 installs
- [find-hidden-subdomains](https://affpapa.org/en/nevibecode/skills/find-hidden-subdomains.md) — skill · 1800 installs
- [techstack-identification](https://affpapa.org/en/nevibecode/skills/techstack-identification.md) — skill · 215 installs
- [ai-recon](https://affpapa.org/en/nevibecode/agents/ai-recon.md) — subagent · ★ 2482 repo stars

---
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
