Overview
Huntress API MCP Server is a Model Context Protocol (MCP) server designed for integrating and interacting with the Huntress API, offering programmatic access to features like account management, organization management, incident reports, and more.
To use the Huntress MCP Server, clone the repository, install the dependencies, configure your API keys in a .env file, and build the server. After setup, it can be integrated with your MCP settings for utilizing its various tools.
- Retrieve account information - Manage organizations and agents - Access incident and summary reports - Generate billing reports - Built-in rate limiting of 60 requests per minute - Comprehensive error handling and response formatting
- Automating account and organization management processes
- Accessing and analyzing incident reports for security assessment
- Generating customized billing and summary reports for clients or internal audits
Add to your AI client
Use these steps to connect Huntress API MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"huntress-mcp-server-dynamicendpoints": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"huntress-mcp-server-dynamicendpoints": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"huntress-mcp-server-dynamicendpoints": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"huntress-mcp-server-dynamicendpoints": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"huntress-mcp-server-dynamicendpoints": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"huntress-mcp-server-dynamicendpoints": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-huntress-mcp-server-dynamicendpoints"
]
}
}
}FAQ
How do I retrieve my API keys?
You can obtain your Huntress API keys from your Huntress account at `<your_account_subdomain>.huntress.io` under API Credentials.
What programming language is the server built on?
The server is built using Node.js.
How does rate limiting work?
The server adheres to Huntress's rate limiting of 60 requests per minute on a sliding window, meaning requests must be managed within this limit to prevent errors.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":449,"uuid":"91ec4217-6e0c-4a24-aed5-cbc726e3fd4e","name":"huntress-mcp-server","title":"Huntress API MCP Server","description":"MCP server for Huntress API integration","avatar_url":"https://avatars.githubusercontent.com/u/166449820?v=4","created_at":"$D2024-12-19T02:12:06.443Z","updated_at":"$D2024-12-19T12:39:21.382Z","status":"created","author_name":"DynamicEndpoints","author_avatar_url":"https://avatars.githubusercontent.com/u/166449820?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/DynamicEndpoints/huntress-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/031ac912b938943e86cddad47c09897e4d527eeb52517b486469a228c6220832/68747470733a2f2f736d6974686572792e61692f62616467652f68756e74726573732d6d63702d736572766572","type":null,"metadata":"{\"star\":\"1\",\"license\":\"MIT license\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-27 21:38:16\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]