AynOps — Claude Code MCP server: features and setup
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.
claude mcp add aynops -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> -- uvx AynOpsWhat AynOps 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.
What it helps with
- 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 for the agent
- 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.
How to install AynOps
Platform CLI
claude mcp add aynops -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> -- uvx AynOpsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>
Platform CLI
codex mcp add aynops --env ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> --env IP_API_KEY=<IP_API_KEY> -- uvx AynOpsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> aynops uvx AynOpsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from AynOps <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AynOps
How do I install AynOps in Claude Code?
Run claude mcp add aynops -e ABUSEIPDB_API_KEY=<ABUSEIPDB_API_KEY> -e IP_API_KEY=<IP_API_KEY> -- uvx AynOps. Replace the placeholders with your API key values.
What does AynOps do?
AynOps is an MCP server that gives AI clients network reconnaissance tools, including port scans, DNS and WHOIS lookups, and web service checks.
Which API keys does AynOps use?
The Claude Code setup sets ABUSEIPDB_API_KEY and IP_API_KEY. The project description specifies Python 3.12+ when launching it with uvx.
