# AynOps

AynOps gives AI agents network reconnaissance tools for checking domains, IPs, and web services. Use it to examine an attack surface from an MCP client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: AynOps
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AynOps/AynOps
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/aynops

## What it does

The server can scan ports with Nmap, gather DNS and WHOIS data, inspect SSL/TLS certificates and HTTP headers, and follow redirect chains. It converts raw results into structured signals for an agent to analyze. The listed capabilities also include cloud storage checks and subdomain takeover detection.

AynOps runs locally and connects to its client over MCP using stdio. The Claude Code setup uses `ABUSEIPDB_API_KEY` and `IP_API_KEY`; both values must be supplied for that configuration. The project description specifies Python 3.12+ for running it with `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `ABUSEIPDB_API_KEY`, `IP_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aynops -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> -- uvx AynOps
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>

### Codex

**Platform CLI**
```bash
codex mcp add aynops --env ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> --env IP_API_KEY=<IP_API_KEY> -- uvx AynOps
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aynops": {
            "command": "uvx",
            "args": [
                "AynOps"
            ],
            "env": {
                "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>",
                "IP_API_KEY": "<IP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aynops": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "AynOps"
            ],
            "env": {
                "ABUSEIPDB_API_KEY": "<ABUSEIPDB_API_KEY>",
                "IP_API_KEY": "<IP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> aynops uvx AynOps
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>

## When to use it
- scan a host for open ports with Nmap
- collect DNS and WHOIS data for a domain
- inspect a service's SSL/TLS certificate and HTTP headers
- trace a website's redirect chain
- check cloud storage and possible subdomain takeover

## Example prompts
- Scan this domain's open ports and collect its DNS and WHOIS data.
- Inspect this service's SSL/TLS certificate and HTTP headers.
- Trace the site's redirects and examine its exposed attack surface.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/en/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP server · ★ 7658
- [jshookmcp](https://affpapa.org/en/nevibecode/mcp/jshookmcp.md) — MCP server · ★ 2061
- [OpenOSINT](https://affpapa.org/en/nevibecode/mcp/openosint.md) — MCP server · ★ 1802

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