# Hudu MCP MCP

> Hudu MCP connects your AI agent directly to structured IT documentation, allowing you to manage entire infrastructure records via natural conversation. List client companies, check asset inventories (servers, firewalls), securely retrieve passwords, and consult operational procedures without opening the Hudu portal. It's built for Managed Service Providers who need immediate access to sensitive client data.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** it-documentation, asset-tracking, password-vault, msp-tools, operational-procedures, infrastructure-management

## Description

Managing IT documentation usually means switching between five different dashboards: one for assets, one for clients, one for passwords, and three others for knowledge articles. This MCP changes that by giving your AI agent a single pane of glass view into all that data. You can ask things like, “What are the core routers at Acme Corp?” or “Show me the admin password for the main domain.” The system handles pulling information from the asset registry, checking company profiles, and accessing secure vault entries—all through one chat window. Vinkius makes connecting this specific service simple; you just subscribe to the MCP and start querying everything your team needs right out of Claude or Cursor. You don't need to learn a new platform; you just ask for the data.

## Tools

### get_article
Retrieves specific content and metadata for a single knowledge base article.

### get_asset
Pulls all detailed records for one particular asset, like a workstation or firewall.

### get_company
Gets the full profile and details for a specific client company record.

### get_password
Retrieves an individual password entry, including username and last rotation date.

### get_procedure
Gets the detailed steps for a single operational checklist or procedure.

### list_articles
Provides an index of all available knowledge base articles within Hudu.

### list_assets
Generates a list of assets, with the option to filter by company ID for scope control.

### list_companies
Lists all registered client companies in your Hudu instance.

### list_passwords
Shows a list of stored passwords, which can be filtered by company ID.

### list_procedures
Provides an index of all operational procedures and checklists, filterable by company.

### create_asset
Adds a new asset record to the system; requires naming and linking it to a company ID.

### create_company
Initializes a new client company profile into your database, requiring just a name.

## Prompt Examples

**Prompt:** 
```
Show all companies and the assets for 'Acme Corp', then retrieve the admin password.
```

**Response:** 
```
Companies: 18 clients managed. Acme Corp (company_12): 14 assets. Assets: 1) 'DC-SRV-01' (Server, Windows Server 2022, tag: DC). 2) 'DC-SRV-02' (Server, Ubuntu 22.04, tag: Backup). 3) 'FW-01' (Firewall, Fortinet, tag: Core). 4) 'SW-CORE-01' (Switch, Cisco 9300). 5-14) 10 workstations. Passwords for Acme Corp: 6 entries. 'Domain Admin' password (pwd_089): Username: admin@acmecorp.local, Password: ●●●●●●●●●●●●, Last rotated: Apr 1, 2025. ⚠️ Password is 25 days old — consider rotating. Would you like to see procedures or knowledge base articles for Acme?
```

**Prompt:** 
```
Search the knowledge base for articles about VPN setup and show the firewall procedures.
```

**Response:** 
```
Knowledge base articles: 34 total. VPN-related: 1) 'Site-to-Site VPN Configuration — Fortinet' (article_045, updated Mar 15). Content: Step-by-step guide for configuring IPsec VPN tunnels between Fortinet firewalls, including Phase 1/2 parameters, routing, and NAT traversal. 2) 'Remote Access VPN — FortiClient Setup' (article_046). 3) 'VPN Troubleshooting Guide' (article_052). Firewall procedures: 1) 'Monthly Firewall Rule Audit' (proc_012, 8 steps, company: All clients). Steps: 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 to read a full article or create a new asset?
```

**Prompt:** 
```
Create a new company 'TechStart Inc' and add a server asset to it.
```

**Response:** 
```
Company created! Name: TechStart Inc, ID: company_19. You now have 19 managed clients. Asset created! Name: 'TS-SRV-01', Company: TechStart Inc (company_19), Tag: 'Production', ID: asset_287. The asset is now linked to TechStart Inc. Next steps: you may want to add passwords for this client and create onboarding procedures. Would you like to add passwords or create more assets?
```

## Capabilities

### List Client Companies
Retrieves a full list of all managed company records.

### Create New Company Records
Adds new client companies to the system, requiring only a name.

### Browse and Retrieve Assets
Lists all physical or virtual assets (like servers or switches) and can filter them by specific company IDs.

### Get Specific Asset Details
Pulls detailed records for a single, identified asset.

### Manage Passwords
Lists stored passwords or securely retrieves an individual password entry by company and name.

### Consult Knowledge Articles
Searches and reads full content from the knowledge base, including article metadata.

### Check Operational Procedures
Lists and provides detailed steps for operational checklists filtered by company.

## Use Cases

### The Incident Response Audit
A support engineer receives a ticket about an old server. Instead of manually checking the asset list and then looking up the owner's credentials, they prompt their agent: 'Show me assets for client XYZ that are servers.' The agent executes `list_assets` (filtered by company ID), identifies the model, and immediately runs `get_password` to retrieve the necessary admin login details.

### New Client Onboarding
The MSP needs to document a new client. They prompt: 'Create Acme Corp.' The agent executes `create_company`, then they follow up with, 'Now add their core router asset.' This triggers `create_asset` and links the resource immediately.

### Policy Compliance Check
A senior engineer needs to know if all clients are following the current firewall best practices. They ask the agent to list procedures, triggering `list_procedures`. The system returns a checklist that they can then use to verify compliance across multiple accounts.

### Knowledge Gap Filling
An L1 tech needs troubleshooting steps for an obscure device. Instead of searching through PDFs, they ask the agent to search the knowledge base. The system uses `list_articles` and then retrieves the full content using `get_article`, providing step-by-step guidance instantly.

## Benefits

- Avoid manual context switching. Instead of opening five separate client tabs, you ask your agent to gather assets, company details, and passwords in one prompt. This dramatically cuts down on resolution time for support tickets.
- Audit readiness is instant. Need to prove compliance? You can run `list_procedures` across all companies or check article content via `get_article` to confirm the latest operational standard was followed.
- Secure credential access: Forget manual password lookups. Use `list_passwords` and `get_password` to retrieve specific entries, which includes vital metadata like when they were last rotated.
- Streamlined onboarding: When a new client signs up, you can use the MCP to perform multiple steps—calling `create_company`, followed by `create_asset`, all in rapid succession through your agent's workflow.
- Granular control: You don't just get data; you get filtered views. Listing assets via `list_assets` with a company ID ensures you only see what belongs to Acme Corp, eliminating noise.

## How It Works

The bottom line is that you treat complex database queries like simple questions asked in a chat window.

1. Subscribe to this MCP on Vinkius and provide your Hudu Instance URL and API Key.
2. Connect your AI client (like Cursor or Claude) to the newly enabled MCP.
3. Ask a natural language question, such as 'Show me all assets for Acme Corp.' The agent executes the necessary tools and returns structured data.

## Frequently Asked Questions

**How do I find all the assets for my client using list_assets?**
You use the company ID filter within `list_assets`. You should first run `list_companies` to get the correct ID, and then pass that specific ID into your request when calling `list_assets`.

**Can I list passwords without knowing the company name? Using list_passwords?**
No. The function requires a filter by company ID to ensure you only see relevant secrets. You must first use `get_company` or `list_companies` to confirm the correct client context.

**What is the difference between get_asset and list_assets?**
`list_assets` gives you a table of everything (a summary view). `get_asset` takes one specific asset ID and returns every single piece of detailed metadata for just that item.

**How do I document a new client company using create_company?**
To start, simply instruct your agent to 'Create a new company called [Name Here]'. This runs `create_company` and establishes the core record in Hudu.

**Do I need list_procedures before using get_procedure?**
Yes. You use `list_procedures` to browse all available operational checklists for a company, which gives you the specific procedure ID required when calling `get_procedure`.

**If I use list_passwords, how does the MCP handle data security for retrieving secrets?**
The connection layer enforces strict authorization checks before any password details are exposed. Your AI client's credentials must have explicit permissions to view sensitive entries; otherwise, the tool call fails safely.

**When I run list_assets, can the results be filtered by a specific tag or category?**
Yes. The asset listing capability allows you to filter results not only by company ID but also by any defined metadata tag (e.g., 'Core', 'Backup'), helping narrow down your inventory immediately.

**Does get_article require a company identifier to find client-specific knowledge base content?**
You can scope the search results by supplying a Company ID. This limits the article retrieval solely to documentation relevant to that specific client, improving accuracy.

**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.