Skip to main content

Connecting to the Huntress MCP Server

Michael Vincent
  • Updated

Overview

The Huntress MCP (Model Context Protocol) server connects AI assistants like Claude and OpenAI Codex directly to your Huntress account data. Once configured, you can query agents, organizations, incident reports, signals, escalations, remediations, and more using natural language without navigating the dashboard. All access is read-only.

Before You Begin

The MCP server supports two authentication methods. Choose whichever fits your MCP client:
  • OAuth: Your MCP client prompts you to sign in and you enter your credentials directly. Use your API Key in the username field and your API Secret Key in the password field. Do not use your Huntress portal login username and password.
  • Base64-encoded credentials: you pre-encode your credentials and pass them in an `Authorization: Basic` header. This is the same format used by the Huntress public API.
 
Note: Both methods use your API Key and API Secret Key they do not use your Huntress account login credentials.
  1. Generate API credentials following Generating API Keys and make note of your credentials. 

  2. (Optional) Encode your credentials if you did not save the base64 version.. Combine your API key and secret in the format YOUR_API_KEY:YOUR_API_SECRET and Base64-encode it:

    echo -n "YOUR_API_KEY:YOUR_API_SECRET" | base64
  3. Server URL: https://api.huntress.io/v1/mcp

OAuth (Recommended)

Follow the instructions for you client to add a new MCP server. The MCP Server URL is: https://api.huntress.io/v1/mcp 

When you instruct your client to connect your browser will open: https://api.huntress.io/v1/mcp/authorize and prompt you to login. You may see a warning if your MCP client is not known to Huntress. Ensure the address in the white box is that of your MCP client and that the Huntress API URL is in your browser's address bar. Enter your API Key as the user name and API Secret Key as the password. 

Claude Code using a Base64 Key

Run the following command, replacing <base64_credential> with your encoded value:

claude mcp add huntress https://api.huntress.io/v1/mcp -t http -s user -H "Authorization: Basic <base64_credential>"

Verify with “claude mcp list” that the MCP server is listed and shows as connected. 

Claude Desktop using a Base64 Key

In order to use the Huntress MCP server with Claude Desktop you will need to have Node.js installed and edit the configuration files as noted below. 

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following mcpServers entry (or add the huntress block to your existing mcpServers section):

{
  "mcpServers": {
    "huntress": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.huntress.io/v1/mcp",
        "--header",
        "Authorization: Basic <base64_credential>"
      ]
    }
  }
}

Fully exit and reopen Claude Desktop to apply the changes. 

Other Platforms

Refer to the documentation on how to add an MCP server that uses Basic Authentication or Oauth. 

 

Related articles