# Hudu MCP for AI Agents AI Agent Connect > Hudu MCP for AI Agents. Document IT infrastructure, manage asset tracking, and access password vaults through your AI client. Built specifically for MSPs who need to interact with their Hudu instance using natural language instead of clicking through a dashboard. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_vtIoOwVOo8AL6euDXB1yZEUcA9s8ztrXXITaeXcg/ai-agent-connect - **Tags:** it-documentation, asset-tracking, password-vault, msp-tools, operational-procedures, infrastructure-management ## Description This Connector connects your documentation platform to any AI agent and lets you manage your IT infrastructure through natural conversation. Imagine you're in the middle of a high-pressure support ticket and need to find a specific piece of hardware or a login credential. Instead of hunting through multiple browser tabs and digging through a vault, you can just ask your agent to find it for you. It turns your documentation into a searchable, actionable knowledge base that lives right inside your chat window. You can pull up full procedures for complex network setups, list every workstation in a specific client's office, and create new company records on the fly without ever leaving your current workspace. It's about moving from 'where did I put that?' to 'show me the steps' in seconds. By bringing your data into your workflow, you get a way to manage hundreds of clients without the overhead of manual navigation. It's one of the many high-quality integrations you'll find in the Vinkius catalog, making it easy to plug into your existing setup and start querying your infrastructure immediately. This means you can spend less time on data entry and more time solving actual problems for your clients, whether you're troubleshooting a connectivity issue or setting up a new office from scratch. It effectively bridges the gap between static documentation and active support. You can quickly verify asset tags, check the status of network devices, or read through full knowledge base articles to ensure you're following the latest protocols. Whether you're handling a routine request or a critical outage, having this information accessible via plain language changes how you work. It removes the friction of manual searching and replaces it with instant, accurate answers. ## Tools ### get_procedure Get the specific steps for a documented IT operation. This is useful for following standard operating procedures. ### list_articles See all knowledge base entries available in your instance. Use this to browse your full documentation library. ### list_companies View a complete list of all client companies you manage. This helps in identifying the correct client ID. ### list_passwords See all stored credentials, which you can filter by a specific company. This helps manage vault access. ### create_asset Add a new hardware record with a name and company ID. Use this to keep your inventory up to date. ### create_company Set up a new client company record by providing a name. This streamlines the initial onboarding process. ### get_article Read the full content and metadata of a specific knowledge base article. This provides deep context for a topic. ### get_asset Pull the specific details for a single piece of hardware or network device. This is great for quick specs. ### get_company View the full profile and details of a specific client company. Use this to see all client-specific data. ### get_password Retrieve a specific password entry including the secret value. This allows for immediate credential access. ### list_assets Browse all assets in your inventory, with the option to filter by company. This provides a full hardware overview. ### list_procedures View all operational procedures, filtered by company if needed. This helps find specific workflows quickly. ## Prompt Examples **Prompt:** ``` Find the admin password for the 'Main Office' at Acme Corp. ``` **Response:** ``` ### Acme Corp Credentials | Role | Username | Password | Last Rotated | | :--- | :--- | :--- | :--- | | **Domain Admin** | admin@acmecorp.local | ●●●●●●●●●●●● | Apr 1, 2025 | ⚠️ **Note:** This password is 25 days old. You might want to consider a rotation soon. ``` **Prompt:** ``` List all the machines we have for 'TechStart Inc'. ``` **Response:** ``` ### TechStart Inc Inventory I found **3** machines for TechStart Inc: * **TS-SRV-01** (Production Tag) * **TS-WRK-02** (Office Tag) * **TS-WRK-03** (Office Tag) Would you like to see the specific details for any of these? ``` **Prompt:** ``` What's the procedure for a monthly firewall audit? ``` **Response:** ``` ### Procedure: Monthly Firewall Rule Audit Follow these **8 steps** to complete the audit: 1. Export current ruleset 2. Review unused rules 3. Check expired policies 4. Validate NAT rules 5. Test connectivity 6. Document changes 7. Backup config 8. Sign off Would you like me to find the specific documentation for a client's firewall? ``` ## Capabilities ### Retrieve client passwords Get specific login credentials from the vault instantly. ### Browse asset inventories View every machine, switch, and network device in your fleet. ### Search knowledge base articles Pull up full documentation content for troubleshooting. ### View operational procedures Get step-by-step instructions for recurring IT tasks. ### Create new company records Add new client company records via chat. ### Track company assets Filter and view hardware tied to specific client IDs. ## Use Cases ### The 2 AM Outage An engineer needs a firewall password immediately. They ask the agent to find the 'Domain Admin' password for Acme Corp using get_password. ### Client Onboarding A new client signs a contract. The admin creates the company using create_company and adds the first machine using create_asset right in the chat. ### Audit Request A client asks for a list of all hardware. The tech uses list_assets filtered by the company ID to generate a list of every workstation and switch. ### Training a New Hire A junior tech is unsure how to set up a VPN. They ask the agent to show the steps for the Fortinet setup using get_procedure. ## Benefits - Faster incident response: Use get_password to grab credentials in seconds instead of hunting through a vault. - Better asset visibility: Use list_assets to see every device in a client's office without opening a new browser tab. - Faster onboarding: Use create_company and create_asset to set up new clients while you're still on the discovery call. - Easier training: Use get_procedure to show junior techs the exact steps for common tasks like router resets. - Instant knowledge retrieval: Use list_articles and get_article to find specific troubleshooting guides in your knowledge base. ## How It Works The bottom line is that your IT documentation becomes a conversational tool you can actually use during a live incident. 1. Subscribe to the Hudu MCP on Vinkius. 2. Provide your Hudu Instance URL and API Key. 3. Ask your agent to find passwords, list assets, or read procedures. ## Frequently Asked Questions **Can the Hudu MCP help me find passwords?** Yes, it lets your agent pull secrets directly from your vault. You can ask for specific credentials for any client company you manage. **Does the Hudu MCP work for MSPs?** Yes, it's built specifically for managed service providers who need to handle large amounts of client documentation and assets. **Can I use the Hudu MCP to see my assets?** Yes, it can list every machine, switch, and network device in your inventory, with the ability to filter by specific client. **Can I create new companies with the Hudu MCP?** Yes, you can add new client company records via chat, which helps speed up the onboarding process for new customers. **How does the Hudu MCP handle knowledge base articles?** It lets your agent search and read your articles. You can pull up full troubleshooting guides or procedures instantly during a call. **Does the Hudu MCP support filtering by company?** Yes, most of the tools allow you to filter results by a specific company ID, ensuring you only see the data relevant to that client. **Can I retrieve stored passwords for a specific client?** Yes. Use `list_passwords` with an optional `company_id` to filter passwords by client. Then use `get_password` with a specific password ID to retrieve the full entry including the secret. Use `list_companies` to find the company ID first. **Does Hudu require a custom instance URL?** Yes. Hudu is self-hosted or uses dedicated instances, so you need to provide your **Instance URL** (e.g., `https://your-company.huducloud.com`) along with the **API Key**. The API Key is sent via the `x-api-key` header (not Bearer), and all API calls are routed to `{instanceUrl}/api/v1`. **Can I track all assets for a specific company?** Yes. Use `list_assets` with the `company_id` parameter to retrieve all assets (servers, workstations, network devices) for a specific client. Use `get_asset` for detailed specifications and tags. Use `create_asset` to add new assets with a name, company ID, and optional asset tag.