Skip to content
MCP server

Huntress MCP

Every Huntress endpoint, plus a local SQLite mirror that delivers fleet-wide incident…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.17
Listing updated
4 days ago

About Huntress MCP

Huntress MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Every Huntress endpoint, plus a local SQLite mirror that delivers fleet-wide incident, coverage

Install

Run in a terminal

claude mcp add huntress-mcp --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env HUNTRESS_API_KEY='<HUNTRESS_API_KEY>' --env HUNTRESS_API_SECRET='<HUNTRESS_API_SECRET>' --env HUNTRESS_MCP_HTTP_TOKEN='<HUNTRESS_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "huntress-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb"
      ],
      "env": {
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "HUNTRESS_API_KEY": "<HUNTRESS_API_KEY>",
        "HUNTRESS_API_SECRET": "<HUNTRESS_API_SECRET>",
        "HUNTRESS_MCP_HTTP_TOKEN": "<HUNTRESS_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "huntress-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb"
      ],
      "env": {
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "HUNTRESS_API_KEY": "<HUNTRESS_API_KEY>",
        "HUNTRESS_API_SECRET": "<HUNTRESS_API_SECRET>",
        "HUNTRESS_MCP_HTTP_TOKEN": "<HUNTRESS_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "huntress-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb"
      ],
      "env": {
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "HUNTRESS_API_KEY": "<HUNTRESS_API_KEY>",
        "HUNTRESS_API_SECRET": "<HUNTRESS_API_SECRET>",
        "HUNTRESS_MCP_HTTP_TOKEN": "<HUNTRESS_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "huntress-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb"
      ],
      "env": {
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "HUNTRESS_API_KEY": "<HUNTRESS_API_KEY>",
        "HUNTRESS_API_SECRET": "<HUNTRESS_API_SECRET>",
        "HUNTRESS_MCP_HTTP_TOKEN": "<HUNTRESS_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "huntress-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb"
      ],
      "env": {
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "HUNTRESS_API_KEY": "<HUNTRESS_API_KEY>",
        "HUNTRESS_API_SECRET": "<HUNTRESS_API_SECRET>",
        "HUNTRESS_MCP_HTTP_TOKEN": "<HUNTRESS_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • PRINTING_PRESS_CLIENT_PROFILEOptional: binds the MCP server to an existing tenant-gated Printing Press client profile. Leave unset for a single-tenant install.
  • HUNTRESS_API_KEYSet the HUNTRESS_API_KEY credential for the Huntress MCP server.Required
  • HUNTRESS_API_SECRETSet the HUNTRESS_API_SECRET credential for the Huntress MCP server.Required
  • HUNTRESS_BASE_URLBase URL for the Huntress API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • HUNTRESS_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any non-GET execute call. Preset to 1; clear it only when you want the agent to run the tools this switch hides.
  • HUNTRESS_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API, the response cache is off, and sync refuses to run. Leave blank to keep the local store.
  • HUNTRESS_USER_AGENTOverrides the User-Agent the CLI sends on Huntress requests.
  • HUNTRESS_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Not needed for the default local stdio transport.

Pricing

Open source

Huntress MCP FAQ

Is Huntress MCP free?

Yes. Huntress MCP is open source, so you can use and self-host it for free.

How do I add Huntress MCP to Claude Code?

Run this command in your terminal: claude mcp add huntress-mcp --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env HUNTRESS_API_KEY='<HUNTRESS_API_KEY>' --env HUNTRESS_API_SECRET='<HUNTRESS_API_SECRET>' --env HUNTRESS_MCP_HTTP_TOKEN='<HUNTRESS_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/huntress-v0.1.17/huntress-mcp.mcpb