IR Toolshed MCP Server

What is IR Toolshed MCP Server?

IR Toolshed MCP Server is a comprehensive Model Context Protocol (MCP) server that provides incident response and network analysis tools for security professionals. It enables AI agents like Claude to perform network-related lookups and analyses to assist with security investigations.

How to use IR Toolshed MCP Server?

Clone the repository, create a virtual environment with uv venv, activate it, then install the package with uv pip install -e .. Start the server using uv run mcp dev src/mcp_server.py. For IP geolocation, set the MAXMIND_LICENSE_KEY environment variable or provide it as a parameter when using the tool.

Key features of IR Toolshed MCP Server

• ASN lookup for IP addresses
• DNS lookup (A, AAAA, MX, NS, TXT)
• WHOIS record retrieval for domains
• IP geolocation via MaxMind GeoLite2
• Consistent error handling across all tools
• Detailed documentation as resources for AI agents

Use cases of IR Toolshed MCP Server

• Investigating suspicious IP addresses during incident response
• Verifying domain ownership and registration details
• Enriching threat intelligence with geolocation data
• Automating DNS and WHOIS lookups in security workflows

FAQ from IR Toolshed MCP Server

What is IR Toolshed MCP Server?

It is an MCP server that exposes networking and security tools (ASN, DNS, WHOIS, geolocation) as callable resources for AI agents, designed for security professionals.

What are the prerequisites to run it?

Python 3.8 or newer (3.13+ recommended) and the uv package manager. The geolocation tool additionally requires a free MaxMind license key.

How do I obtain a MaxMind license key?

Visit https://dev.maxmind.com/geoip/geolite2-free-geolocation-data to get a free key. Set it as the MAXMIND_LICENSE_KEY environment variable or provide it each time you use the geolocation tool.

What happens when a lookup fails?

Each tool returns a structured error response with a status of "error", a detailed error message, and the original query value, enabling graceful handling by AI agents.

Does the server require an internet connection?

Yes, ASN, DNS, and WHOIS lookups require network access to external services. The geolocation tool uses a local MaxMind database but still needs an internet connection to download the database initially.