Documentation MCP Server 🐳 Docker

Hudu MCP

MCP server for Hudu IT documentation platform — manage companies, assets, articles, passwords, websites, folders, procedures, and activity logs.

🔗 Companion Plugin

Pair this MCP server with the Hudu plugin for skills, commands, and API knowledge alongside direct API access.

Installation

Run the MCP server with npx:

npx @wyre-technology/hudu-mcp

Or install the package:

npm install @wyre-technology/hudu-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hudu": {
      "command": "npx",
      "args": [
        "@wyre-technology/hudu-mcp"
      ],
      "env": {
        "HUDU_BASE_URL": "your-hudu-base-url",
        "HUDU_API_KEY": "your-hudu-api-key"
      }
    }
  }
}

Authentication

Variable	Required	Description
`HUDU_BASE_URL`	Yes	Your Hudu instance URL (e.g., https://acme.huducloud.com)
`HUDU_API_KEY`	Yes	Hudu API key from Admin > API Keys

Getting Credentials

Vendor portal: https://www.hudu.com/

Prerequisites

Hudu account with Administrator role
Knowledge of your Hudu instance URL (e.g., https://acme.huducloud.com)

Steps

Sign in to your Hudu instance as an Administrator.
Navigate to Admin → API Keys.
Click "New API Key".
Set a descriptive name (e.g., "WYRE Gateway") and set permission scopes per least-privilege for the entities you need.
Save the key. Hudu shows it once — copy to HUDU_API_KEY immediately.
Set HUDU_BASE_URL to your Hudu instance URL including the protocol.

Credential Format

API key is a long random string. HUDU_BASE_URL must include https:// and the full hostname (e.g., https://acme.huducloud.com).

Rotation

Generate a new key via Admin → API Keys → New API Key. Revoke the old key once the new one is verified working.

Architecture

Flat tool exposure with lazy SDK initialization. All 39 tools available immediately.

Available Tools (39)

Tools are organized into 6 domains:

Companies

Manage client companies.

Tool	Description
`hudu_list_companies`	List companies with filters
`hudu_get_company`	Get company by ID
`hudu_create_company`	Create a company
`hudu_update_company`	Update a company
`hudu_delete_company`	Delete a company
`hudu_archive_company`	Archive a company
`hudu_unarchive_company`	Unarchive a company

Assets

Manage IT assets and asset layouts.

Tool	Description
`hudu_list_assets`	List assets with filters
`hudu_get_asset`	Get asset by ID
`hudu_create_asset`	Create an asset
`hudu_update_asset`	Update an asset
`hudu_delete_asset`	Delete an asset
`hudu_archive_asset`	Archive an asset
`hudu_list_asset_layouts`	List asset layouts
`hudu_get_asset_layout`	Get asset layout by ID
`hudu_create_asset_layout`	Create an asset layout
`hudu_update_asset_layout`	Update an asset layout

Passwords

Manage asset passwords (credentials).

Tool	Description
`hudu_list_asset_passwords`	List asset passwords
`hudu_get_asset_password`	Get asset password by ID
`hudu_create_asset_password`	Create an asset password
`hudu_update_asset_password`	Update an asset password
`hudu_delete_asset_password`	Delete an asset password

Articles

Manage knowledge base articles.

Tool	Description
`hudu_list_articles`	List knowledge base articles
`hudu_get_article`	Get article by ID
`hudu_create_article`	Create an article
`hudu_update_article`	Update an article
`hudu_delete_article`	Delete an article
`hudu_archive_article`	Archive an article

Websites

Manage monitored websites.

Tool	Description
`hudu_list_websites`	List monitored websites
`hudu_get_website`	Get website by ID
`hudu_create_website`	Create a website
`hudu_update_website`	Update a website
`hudu_delete_website`	Delete a website

Utilities

Folders, procedures, activity logs, relations, and Magic Dash.

Tool	Description
`hudu_list_folders`	List folders
`hudu_list_procedures`	List procedures
`hudu_list_activity_logs`	List activity logs
`hudu_list_relations`	List relations
`hudu_list_magic_dash`	List Magic Dash items
`hudu_test_connection`	Test API connectivity

Rate Limits

300 requests per minute. The underlying client library handles rate limiting automatically.