# Hudu MCP for AI Agents AI Agent Connect > Hudu MCP. Manage IT documentation, assets, and passwords via the Hudu API. Connect your AI agent to your central knowledge base to automate MSP tasks, look up client details, and manage security credentials without manual switching. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_1rOcDaJlO4NJsafwL8Hdh8RMTDUxUbHfBtr0tJKe/ai-agent-connect - **Tags:** it-documentation, asset-tracking, password-vault, msp-tools, operational-procedures, infrastructure-management ## Description This Connector gives your AI agent a direct line into your Hudu IT documentation. If you're running an MSP, you know the pain of jumping between tabs to find a client's network map, their stored passwords, or the specific procedure for a server migration. This tool lets your agent do that digging for you. You can ask it to pull up asset lists, check website statuses, or find a knowledge base article while you're on a live support call. It takes the friction out of finding information, so you can stay focused on the task at hand. It's one of the ways Vinkius helps you put your internal data to work with your AI agent. Instead of manual searching, you get immediate answers about your companies, contacts, and procedures. You can use it to audit your current inventory, verify who has access to certain accounts, or quickly find the right documentation for a complex hardware setup. It turns your static documentation into an active resource that your agent can query on the fly. This means less time spent in browser tabs and more time spent actually solving problems for your clients. Whether you are checking the status of a client's website or looking for a specific contact's phone number, the agent handles the navigation. You get to keep your hands on the keyboard and your eyes on the problem, while the agent handles the tedious work of searching through your records. ## Tools ### create_company Requires a name. Create a new company ### create_asset Requires asset name and company ID. Create a new asset ### get_article Get details for a specific article ### get_asset Get details for a specific asset ### get_company Gets specific details for a company. Use this to pull account info quickly during a client onboarding call. ### get_password Get details for a specific password ### get_procedure Get details for a specific procedure ### list_articles Pulls a list of knowledge base articles. Use this to find training materials or internal guides for your team. ### list_assets Lists all documented hardware and software assets. This is perfect for getting a full inventory of a client's equipment. ### list_companies Shows all companies currently in your Hudu account. Use this to get a high-level view of your entire client base. ### list_passwords Lists the stored passwords in your Hudu vault. This lets your agent help you find the right credentials without manual searching. ### list_procedures Lists the documented procedures for your team. Use this to find the how-to for common IT tasks. ## Prompt Examples **Prompt:** ``` What are the backup procedures for the Smith account? ``` **Response:** ``` ### Backup Procedures for Smith Account Based on your Hudu documentation, here are the current procedures: * **Daily Backups:** Automated via Veeam at 02:00 * **Offsite Storage:** Synced to AWS S3 * **Manual Restore:** Follow the `manual_restore_guide` in the knowledge base. Would you like me to pull up the specific knowledge base article for the manual restore steps? ``` **Prompt:** ``` List all assets for company ID 505. ``` **Response:** ``` ### Assets for Company ID 505 I found the following documented assets for this client: | Asset Type | Description | Status | | :--- | :--- | :--- | | Server | Primary Web Server (SRV-01) | Online | | Storage | NAS-04 (100TB) | Online | | Workstations | 15x Dell Latitude Laptops | Active | Let me know if you need the specific network configuration for any of these. ``` **Prompt:** ``` Show me the passwords for the main office network. ``` **Response:** ``` ### Network Credentials I've retrieved the following credentials from your Hudu vault: * **Router Admin:** `Admin_Pass_99!` * **Switch Management:** `Switch_Secure_22` * **VPN Gateway:** `VPN_Gateway_Key` **Note:** These are stored in your secure Hudu vault. Let me know if you need the documentation for the VPN setup as well. ``` ## Capabilities ### Fetch company details Get specific account information for any client in your Hudu database. ### Pull knowledge base articles Retrieve internal guides and training materials on demand. ### List documented assets Get a complete inventory of hardware and software for a specific company. ### Retrieve stored passwords Access stored credentials for various services and systems. ### View activity logs See a history of changes and actions taken within your Hudu account. ### Search network documentation Pull up network configurations and maps for your managed clients. ### Access documented procedures Find the step-by-step instructions for common IT tasks and migrations. ### List monitored websites Check the status of all web properties you are currently monitoring. ## Use Cases ### Onboarding a new client An admin asks the agent to list all companies and then get details for a new one to prep the workspace and documentation. ### Emergency support A tech asks for the backup procedure and the network list for a client experiencing a total outage to start troubleshooting immediately. ### Security audit A manager asks the agent to list all passwords and activity logs to ensure everything is compliant and up to date. ### Inventory check A client asks what hardware they have, and the agent pulls the list of assets for their company ID to provide a clear summary. ## Benefits - Get client info faster. Use `list_assets` and `list_networks` to see a client's full infrastructure without leaving your chat window. - Follow the right steps. Your agent can grab `list_procedures` so your team always follows the approved internal workflow for common fixes. - Simplify password lookups. Use `list_passwords` to find the right credentials quickly while keeping your workflow moving. - Surface training content. Use `list_articles` to let your agent find the exact knowledge base pieces your team needs to see. - Audit your work easily. Check `list_activity_logs` to see what's been updated in your Hudu environment and by whom. ## How It Works The bottom line is your AI agent becomes an expert on your specific IT documentation. 1. Connect your Hudu API key to the Connector through Vinkius. 2. Grant your AI client permission to access your specific documentation categories. 3. Ask your agent to perform tasks like "Find the backup procedure for Client X." ## Frequently Asked Questions **Can the Hudu MCP see my client passwords?** Yes, it can retrieve stored passwords from your Hudu vault. This allows your AI agent to help you find the correct credentials for specific services without you having to search for them manually. **Does Hudu MCP work with Claude and Cursor?** Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You can connect it through Vinkius to give your agent access to your IT documentation. **Can I use Hudu MCP to find network details?** Yes, it can pull up documented network configurations for your managed clients. This is great for quickly identifying IP schemes or hardware layouts during a support call. **How does Hudu MCP help MSPs?** It automates the way your team accesses information. Instead of clicking through multiple tabs, your agents can pull up assets, procedures, and client info instantly, speeding up your response times. **Is my data safe with Hudu MCP?** The Connector uses your Hudu API key to interact with your data. This ensures that the connection remains secure and follows your existing permission settings within the Hudu platform. **Can Hudu MCP list all my clients?** Yes, it can list all companies currently documented in your Hudu account. This provides a high-level view of your entire client base through your AI agent. **How do I get Hudu API credentials?** You can generate an API key in your Hudu dashboard under Account Settings > API. You also need your Hudu instance domain. **Can I see passwords with this Connector?** Yes, the list_passwords tool provides access to documented passwords in your Hudu instance. **Does it support self-hosted Hudu?** Yes, as long as your Hudu instance is accessible via the internet and the domain provided is correct. **Can I see passwords with this MCP?** Yes, the list_passwords tool provides access to documented passwords in your Hudu instance. **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.