# Holded MCP > Holded MCP connects your entire business management system to any AI agent. Use this connector to manage invoicing, track contacts, and oversee projects directly through natural conversation. You can list all invoices, check product stock levels, retrieve client profiles, and monitor tasks without leaving your chat window. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** business-management, invoicing, contact-management, crm, financial-operations ## Description Managing a modern business shouldn't require logging into five different portals just to answer one question. This MCP connects your Holded ERP platform straight to your agent, letting you handle everything—from billing records to inventory counts—using plain English. Need to know if Acme Corp paid their last bill? Ask. Want to update the stock count on a specific product line? Tell your agent. It performs those actions and gives you the data back. Because all this functionality is housed within one connector, it keeps your workflow focused. By connecting through Vinkius, your AI client gains instant access to a unified view of your entire operation, turning complex accounting modules into simple conversations. ## Tools ### get_contact_details Retrieves a complete profile with detailed information about one specific contact. ### get_invoice_details Pulls comprehensive details for a single, specified invoice. ### get_api_profile Retrieves basic information about the Holded account that is connected to your agent. ### get_product_details Gets detailed specifications and current status for a particular product. ### get_project_details Fetches the full setup and current operational status of an entire project. ### list_contacts Provides a master list of all contacts, including clients, suppliers, and leads in your system. ### list_invoices Generates a list of every invoice to help you track billing records and find necessary IDs. ### list_products Lists all products or services available in your inventory for review. ### list_projects Shows a summary of both active and past projects running through the business. ### list_all_tasks Gathers a comprehensive list of every task across all your operational projects. ### update_product_stock Adjusts and updates the current stock quantity for an item in the warehouse. ## Prompt Examples **Prompt:** ``` List all active projects and show the last task for each. ``` **Response:** ``` I've retrieved your projects. You have 3 active workflows: 'Website Launch' (ID: proj_102), 'Q2 Campaign', and 'Product Beta'. For the Website Launch, the latest task is 'Final QA Check' (ID: task_992). Would you like to see the details for any of these? ``` **Prompt:** ``` Find contact 'Acme Corp' and show their recent invoices. ``` **Response:** ``` I've found Acme Corp (ID: contact_552). They have 2 recent invoices: INV-2024-01 ($1,250.00 - Paid) and INV-2024-05 ($3,000.00 - Pending). Would you like to see the items included in the pending invoice? ``` **Prompt:** ``` Show me the details for product ID 'prod_992' and its stock level. ``` **Response:** ``` Accessing inventory... Product 'prod_992' (Wireless Mouse) currently has 45 units in stock across 2 warehouses. The main warehouse has 30 units and the secondary has 15. Should I update the stock level for any specific location? ``` ## Capabilities ### Get Contact Information Pull detailed profiles for any customer, supplier, or lead you need. ### View Invoice Data Retrieve full details on specific invoices and monitor their payment status. ### Track Projects and Tasks List active projects or check the current status of tasks across your company's portfolio. ### Manage Inventory Stock Access product catalog details and update stock levels for specific items. ### View Business Metadata Get high-level data about your account or organization to keep a clear overview of operations. ## Use Cases ### Checking on a Late Client Payment The finance team needs to know if 'Global Logistics' paid their last bill. They ask the agent, and it uses `list_contacts` first, then calls `get_invoice_details` for the specific contact ID, returning the payment status immediately. ### Coordinating a Product Launch A project manager needs to confirm product readiness. They ask the agent to list active projects (`list_projects`) and then check if the core products have enough stock using `get_product_details`. ### On-the-fly Inventory Correction The warehouse staff finds they miscounted a shipment. They ask their agent to update the stock for Product X, and the agent executes `update_product_stock`, confirming the change without needing manual access to the inventory system. ### Reviewing Team Workloads The team lead needs to know where everyone stands. They ask the agent to list all tasks (`list_all_tasks`), getting an instant overview of who owns what and when it's due across departments. ## Benefits - Stop manually navigating complex modules. You can list all invoices or get detailed invoice information simply by asking your agent a question. - Keep track of teams' progress instantly. Use the `list_all_tasks` tool to see every task across multiple projects without opening a single dashboard tab. - Manage inventory on the fly. When you need to update stock levels, just ask your agent instead of navigating through complex warehouse management screens; use `update_product_stock`. - Get full client context immediately. Instead of finding a contact ID first, ask the agent to list contacts and then get their details directly with `get_contact_details`. - Maintain business oversight effortlessly. You can pull account metadata using `get_api_profile` or check project status via `list_projects`, all from one chat interface. ## How It Works The bottom line is you stop clicking through menus and start asking questions. 1. Subscribe to this MCP and provide your Holded API key (found in Settings > Developers). 2. Your agent accesses the connected ERP data via Vinkius, mapping natural language requests to specific business tools. 3. You get a conversational response with real-time data—whether it's an invoice status or a list of active projects. ## Frequently Asked Questions **How do I find my Holded API Key?** Log in to your Holded account, click on the **Settings** icon (top right), go to **Developers**, and you will find your unique **API Key** listed there. You can create multiple keys for different integrations. **What document types are supported in the invoicing tools?** This integration currently focuses on the `invoice` document type. For other types like sales orders or purchase orders, you can use the generic `list_invoices` logic if they are mapped under the same module in your instance. **Can I update stock levels through this integration?** Yes! Use the `update_product_stock` tool. You must provide the product ID and a JSON string containing the warehouse ID and the new quantity to update your inventory. **Is the integration secure for ERP data?** Absolutely. The integration uses official Holded API keys in the request header over HTTPS. Your credentials and business data are encrypted and stored securely within the Vinkius Cloud infrastructure.