Source profileQuality 91/100

WYRE-AI/msp-claude-plugins/msp-claude-plugins/huntress/huntress/skills/api-patterns/SKILL.md

Huntress API Patterns

Huntress MCP fundamentals: HTTP Basic Auth via API key/secret headers, the full MCP tool catalog, token-based pagination, the 60 req/min rate limit, and the common HTTP error codes with their causes.

Source repository stars
42
Declared platforms
0
Static risk flags
0
Last source update
2026-08-28
Source checked
2026-08-28

Decision brief

What it does: where it fits

Huntress MCP fundamentals: HTTP Basic Auth via API key/secret headers, the full MCP tool catalog, token-based pagination, the 60 req/min rate limit, and the common HTTP error codes with their causes.

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/huntress/huntress/skills/api-patterns"
    Safe inspection promptEditorial

    Inspect the Agent Skill "Huntress API Patterns" from https://github.com/WYRE-AI/msp-claude-plugins/blob/5005f73ba2f52cd299f58aa6bb79f4e70ae87103/msp-claude-plugins/huntress/huntress/skills/api-patterns/SKILL.md at commit 5005f73ba2f52cd299f58aa6bb79f4e70ae87103. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      Connection & Authentication

      Huntress authenticates using an API key and secret passed as HTTP headers:

      Huntress authenticates using an API key and secret passed as HTTP headers:Generate credentials at: Huntress Dashboard Settings API Credentials
    2. 02

      HTTP Basic Auth

      Huntress authenticates using an API key and secret passed as HTTP headers:

      Huntress authenticates using an API key and secret passed as HTTP headers:Generate credentials at: Huntress Dashboard Settings API Credentials
    3. 03

      Available MCP Tools

      Navigation here is stateless discovery, not a cursor. There is no current resource and no history, so there is no "back" tool — every tool below is callable directly at any time, and huntressnavigate is never a prerequisite for calling one.

      Navigation here is stateless discovery, not a cursor. There is no current resource and no history, so there is no "back" tool — every tool below is callable directly at any time, and huntressnavigate is never a prerequi…Through Conduit, huntressnavigate is refused for every caller by the discovery-tool suppression gate, so a workflow that begins by calling it will fail at step one. Read the catalog below instead.
    4. 04

      Navigation

      Navigation here is stateless discovery, not a cursor. There is no current resource and no history, so there is no "back" tool — every tool below is callable directly at any time, and huntressnavigate is never a prerequisite for calling one.

      Navigation here is stateless discovery, not a cursor. There is no current resource and no history, so there is no "back" tool — every tool below is callable directly at any time, and huntressnavigate is never a prerequi…Through Conduit, huntressnavigate is refused for every caller by the discovery-tool suppression gate, so a workflow that begins by calling it will fail at step one. Read the catalog below instead.
    5. 05

      Account

      Review the “Account” section in the pinned source before continuing.

      Review and apply the “Account” source section.

    Permission review

    Static risk signals and limitations

    No configured static risk pattern was detected

    This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score91/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars42SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    WYRE-AI/msp-claude-plugins
    Skill path
    msp-claude-plugins/huntress/huntress/skills/api-patterns/SKILL.md
    Commit
    5005f73ba2f52cd299f58aa6bb79f4e70ae87103
    License
    Apache-2.0
    Collected
    2026-08-28
    Default branch
    main
    View the original SKILL.md

    Huntress MCP Tools & API Patterns

    Overview

    The Huntress MCP server provides AI tool integration with the Huntress managed threat detection and response platform. It exposes tools covering account management, endpoint agents, organizations, incidents, escalations, billing, signals, and user management. The API uses HTTP Basic Auth with an API key and secret.

    Connection & Authentication

    HTTP Basic Auth

    Huntress authenticates using an API key and secret passed as HTTP headers:

    HeaderDescription
    X-Huntress-API-KeyYour Huntress API key
    X-Huntress-API-SecretYour Huntress API secret

    Generate credentials at: Huntress Dashboard > Settings > API Credentials

    Environment Variables:

    export HUNTRESS_API_KEY="your-api-key"
    export HUNTRESS_API_SECRET="your-api-secret"
    

    Available MCP Tools

    Navigation

    ToolDescription
    huntress_navigateDiscovery aid — lists the tool names and descriptions in one domain (accounts, agents, organizations, incidents, billing, signals, users)
    huntress_statusCheck Huntress API connection status and which domains are available

    Navigation here is stateless discovery, not a cursor. There is no current resource and no history, so there is no "back" tool — every tool below is callable directly at any time, and huntress_navigate is never a prerequisite for calling one.

    Through Conduit, huntress_navigate is refused for every caller by the discovery-tool suppression gate, so a workflow that begins by calling it will fail at step one. Read the catalog below instead.

    Account

    ToolDescription
    huntress_accounts_getGet account details
    huntress_accounts_actorGet current authenticated actor info

    Agents

    ToolDescription
    huntress_agents_listList endpoint agents with filters
    huntress_agents_getGet details for a specific agent

    Organizations

    ToolDescription
    huntress_organizations_listList all organizations
    huntress_organizations_getGet organization details
    huntress_organizations_createCreate a new organization
    huntress_organizations_updateUpdate an organization
    huntress_organizations_deleteDelete an organization

    Incidents

    ToolDescription
    huntress_incidents_listList incidents with filters
    huntress_incidents_getGet incident details
    huntress_incidents_resolveResolve an incident
    huntress_incidents_remediationsList remediations for an incident
    huntress_incidents_remediation_getGet specific remediation details
    huntress_incidents_bulk_approveBulk approve remediations
    huntress_incidents_bulk_rejectBulk reject remediations

    Escalations

    ToolDescription
    huntress_escalations_listList escalations
    huntress_escalations_getGet escalation details
    huntress_escalations_resolveResolve an escalation

    Reports

    ToolDescription
    huntress_billing_reports_listList billing reports
    huntress_billing_reports_getGet a specific billing report
    huntress_summary_reports_listList summary reports
    huntress_summary_reports_getGet a specific summary report

    Signals

    ToolDescription
    huntress_signals_listList security signals
    huntress_signals_getGet signal details

    Users

    ToolDescription
    huntress_users_listList users
    huntress_users_getGet user details
    huntress_users_createCreate a user
    huntress_users_updateUpdate a user
    huntress_users_deleteDelete a user

    Pagination

    The Huntress API uses token-based pagination:

    • Pass page_token to retrieve the next page of results
    • The response includes next_page_token if more results are available
    • Continue fetching pages until next_page_token is absent or null

    Example workflow:

    1. Call huntress_agents_list with no page_token
    2. If response includes next_page_token, call again with that token
    3. Repeat until no next_page_token is returned

    Rate Limiting

    Huntress enforces 60 requests per minute.

    • HTTP 429 responses indicate rate limit exceeded
    • Wait before retrying — use exponential backoff
    • Batch operations where possible
    • Use filters to reduce result set sizes

    Error Handling

    Common Error Codes

    CodeMeaningResolution
    401UnauthorizedCheck API key and secret
    403ForbiddenInsufficient permissions
    404Not FoundResource doesn't exist or wrong ID
    429Rate LimitedWait and retry after delay
    500Server ErrorRetry; contact support if persistent

    Error Response Format

    {
      "error": {
        "code": 401,
        "message": "Invalid API credentials"
      }
    }
    

    Best Practices

    • Use organization filters to scope queries to specific clients
    • Cache account/org info to reduce API calls
    • Do not build workflows on navigation state — there is none. Call the tool you need directly; use huntress_status only to confirm credentials and reachability before a batch run

    Related Skills

    Frequently asked questions

    What to verify before installation and use

    What does the Huntress API Patterns source document cover?

    Huntress MCP fundamentals: HTTP Basic Auth via API key/secret headers, the full MCP tool catalog, token-based pagination, the 60 req/min rate limit, and the common HTTP error codes with their causes.

    How do I install Huntress API Patterns?

    The source record exposes this install command: npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/huntress/huntress/skills/api-patterns". Inspect the command and pinned source before running it.

    Alternatives

    Compare before choosing

    Computed 10045,960

    coreyhaines31/marketingskills

    ab-testing

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

    Computed 10029,236

    garrytan/gbrain

    bulk-ingestion

    End-to-end discipline for turning any large data source (audio libraries, email takeouts, document corpora, chat exports, API dumps) into brain pages at scale. The lifecycle spine: SCHEMA → ACCESS → TRIAL → EVALUATE → IMPROVE → CODIFY → TEST → SKILLIFY → BULK → MONITOR. State is tracked in a durable JSON manifest (see MANIFEST-PATTERN.md) so any crash, session boundary, or subagent fan-out resumes from ground truth instead of memory.

    Computed 10025,136

    alirezarezvani/claude-skills

    app-store-optimization

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist

    Computed 1005,277

    dotnet/skills

    migrate-vstest-to-mtp

    Migrates .NET test projects from VSTest to Microsoft.Testing.Platform (MTP). Use when user asks to "migrate to MTP", "switch from VSTest", "enable Microsoft.Testing.Platform", "use MTP runner", set OutputType=Exe only for test projects in Directory.Build.props, or mentions EnableMSTestRunner, EnableNUnitRunner, or UseMicrosoftTestingPlatformRunner. USE FOR: MTP behavioral differences vs VSTest (exit code 8, zero tests discovered, --ignore-exit-code, TESTINGPLATFORM_EXITCODE_IGNORE); centralizing