IR Toolshed MCP Server

Name: IR Toolshed MCP Server
Author: rossja

@rossja

Repository

About IR Toolshed MCP Server

an MCP server providing tools for network incident response folks

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "irtoolshed-mcp-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.