# Hudu MCP > Hudu connects your AI client directly to your IT documentation, asset records, and company data. Your agent can list companies, retrieve specific asset details, find stored passwords, or pull knowledge base articles—all without you logging into Hudu manually. It gives your AI the immediate operational context it needs for MSP workflows and technical support. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** it-documentation, asset-management, password-management, msp-tools, knowledge-base, it-operations ## Description Your AI client now talks directly to Hudu, giving it visibility across all your IT operations data. Instead of needing a human to run reports or search multiple systems, your agent handles that work immediately. You can ask it to find the asset details for a specific device, list contacts associated with a company, or even pull out stored passwords if needed. This MCP exposes everything from general knowledge base articles and documented procedures to lists of network devices and websites you monitor. When you connect this through Vinkius, your agent gets access to all these operational tools in one place. It lets you automate complex IT management tasks—like gathering an initial report on a client's assets or listing all associated contacts—all via natural conversation. No more switching between tabs or copying data from different dashboards. You just ask for the information, and your AI agent gets it directly from Hudu. ## Tools ### get_company Pulls detailed information for one specific company by ID. ### list_activity_logs Generates a list of all recent actions taken within Hudu. ### list_articles Retrieves a list of available knowledge base articles. ### list_assets Lists every documented piece of IT hardware or software asset. ### list_companies Returns a comprehensive list of all companies managed in Hudu. ### list_contacts Gets a list of every contact associated with any company. ### list_networks Retrieves details about all documented network structures. ### list_passwords Provides a list of stored passwords for secured access. ### list_procedures Lists the documented operational procedures used by staff. ### list_websites Retrieves a list of monitored websites associated with companies. ## Prompt Examples **Prompt:** ``` List all companies documented in Hudu. ``` **Response:** ``` I'll fetch the list of companies for you. ``` **Prompt:** ``` Show me assets for company ID 123. ``` **Response:** ``` I'll retrieve the assets documented for that company. ``` **Prompt:** ``` Find knowledge base articles related to backup procedures. ``` **Response:** ``` I'll search your knowledge base for backup procedures. ``` ## Capabilities ### Find Company Information Retrieves specific details about a company using its identifier. ### Review Operational Logs Lists historical activity logs to see who did what and when within the system. ### Search Documentation Finds knowledge base articles, documented procedures, or specific assets based on keywords or scope. ### Manage Contacts and Networks Lists contacts across all companies or retrieves details about documented network structures. ### Handle Credentials Retrieves lists of stored passwords for quick access by the agent. ## Use Cases ### Auditing Client Security Protocols A compliance officer needs to prove that all critical assets are tracked. Instead of pulling reports from the asset management system, they ask their agent to use `list_assets` and then cross-reference those results with `list_procedures` to ensure every device has an up-to-date handling protocol. ### Onboarding a New Client A technician starts onboarding. They ask the agent for all initial data: 'List companies, and get me contacts.' The agent uses `list_companies` and `list_contacts` to pull the core organizational structure immediately. ### Investigating a Breach A security team needs to know what happened yesterday. They ask their AI client to run `list_activity_logs` for the last 24 hours, instantly generating an audit trail instead of manually reviewing log files. ### Scope Creep Prevention A project manager is scoping a network upgrade. They ask the agent to use `list_networks`, which gives them all documented connections and endpoints right away, preventing scope creep later in the month. ## Benefits - Stop manual data gathering. With the `list_companies` tool, you instantly get a full list of every client managed in Hudu, giving you an immediate scope overview for any project. - Instant compliance checks. By running the `list_activity_logs`, your agent can pull records of who changed what and when, saving hours of manual auditing. - Centralized credential access. You don't need to memorize logins; simply ask to use `list_passwords` and have your AI client retrieve the necessary credentials securely. - Better documentation recall. Instead of digging through shared drives, you can request a search of knowledge base articles using `list_articles`, getting direct answers from Hudu’s content library. - Full IT Picture. Combining calls like `list_assets` and `list_networks` lets your agent build a complete infrastructure picture for a client in one go. ## How It Works The bottom line is you tell your AI what information you need, and it executes the necessary database queries against Hudu for you. 1. Connect your AI client to Vinkius and enable the Hudu MCP. This gives your agent secure, read-only access credentials. 2. Instruct your agent using natural language (e.g., 'List all contacts for Company X'). 3. The MCP translates that request into a specific API call, fetches the data from Hudu, and returns it to your agent as clean context. ## Frequently Asked Questions **Can the Hudu MCP list all my companies?** Yes. Using the `list_companies` tool, your AI agent can retrieve a comprehensive roster of every company documented in Hudu immediately. **How do I find stored passwords using the Hudu MCP?** You instruct your agent to use the `list_passwords` tool. The agent will then securely pull and present a list of all stored credentials for you to review. **What if I only need details on one company, not all of them?** Use the `get_company` tool; it allows your AI client to retrieve specific, detailed information using a known company ID, narrowing down the scope effectively. **Does Hudu MCP help with compliance and auditing?** Absolutely. The agent can use the `list_activity_logs` tool to pull recent system activity, giving you an immediate audit trail for compliance purposes.