# OSINT Person MCP -- Super Search Integration

**Created:** 2026-08-08
**Service:** OSINT Person MCP (Core, port 8902)
**Integration:** Super Search MCP (Core, port 8899)

---

## Overview

The OSINT Person MCP now integrates with Super Search via a dedicated client module. This mirrors the IntelSight pattern: an MCP server that calls Super Search tools through the local MCP endpoint at `http://127.0.0.1:8899/mcp`.

## Architecture

```
OSINT Person MCP (port 8902)
    -> super_search.py (MCP client module)
    -> http://127.0.0.1:8899/mcp (Super Search MCP endpoint)
    -> Super Search tools (web_search, web_extract, etc.)
```

## Files

| File | Purpose |
|------|---------|
| `/root/docker/osint-person-mcp/super_search.py` | MCP client module (5.6K) |
| `/root/docker/osint-person-mcp/server.py` | Main OSINT Person server |
| `/root/docker/super-search/server.py` | Super Search MCP (referenced as dependency) |

## Client Module (super_search.py)

The module provides MCP client wrappers for Super Search tools:
- Call Super Search via `http://127.0.0.1:8899/mcp`
- Tool passthrough: any Super Search tool is available to OSINT Person
- Pattern mirrors IntelSight's `intelsight_api.py`

## Clients

| Client | Role |
|--------|------|
| `hermes` | Hermes Agent skip tracing tasks |
| `dre-osint` | DRE background research |

## Service Status

```
systemctl is-active osint-person-mcp  -> active
ss -tlnp | grep 8902                  -> 127.0.0.1:8902
```

## Related

- Super Search v2.4.0: `/root/projects/itpp-infrastructure/docs/super-search-v2.4.0-client-tracking.md`
- IntelSight API: Core :8099
- DRE MCP: Core :8900