# Asset Panda MCP MCP > Asset Panda MCP lets your agent manage an entire inventory lifecycle. It handles everything from listing organizational groups and locations to retrieving specific asset details, creating new records, or updating status fields for individual objects. ## Overview - **Category:** inventory-management - **Price:** Free - **Tags:** fixed-asset-tracking, inventory-control, lifecycle-management, location-tracking, asset-auditing ## Description This MCP provides a natural language interface for managing fixed assets. You can tell your AI client exactly what you need done with your inventory data. Need to know how the system is structured? Use it to list all organizational entities (Groups). Want an accurate count of laptops? List and search for specific objects within designated groups. It handles the full asset lifecycle, letting you create new records or update existing ones directly from your chat. For instance, if a piece of equipment moves departments, you just tell your agent to adjust its status; it updates the record instantly. Since Vinkius hosts this MCP, your AI client connects once and gets access to all these critical inventory tools. ## Tools ### create_object Adds a new, trackable physical asset record into an existing organizational group. ### get_account_check Verifies the connection and authorization status for your Asset Panda account. ### get_group Retrieves metadata about a specific organizational group or entity within the system. ### get_object Gets all current details for one specified asset, including custom fields and location data. ### list_groups Returns a list of all organizational entities (Groups) defined in your account. ### list_locations Provides an alias for listing all geographical or departmental locations where assets are assigned. ### list_objects Lists every single object (asset) contained within a specific, defined asset group. ### update_object Changes the status or details of an existing asset record to reflect current reality. ## Prompt Examples **Prompt:** ``` List all asset groups in my account. ``` **Response:** ``` I've retrieved your groups. You have several entities defined, including 'Assets', 'Employees', 'Locations', and 'Software Licenses'. ``` **Prompt:** ``` Show me the assets in the 'Laptops' group (ID: 12345). ``` **Response:** ``` I've found 15 objects in the 'Laptops' group, including 'MacBook Pro #45' and 'Dell XPS #12'. ``` **Prompt:** ``` Update the status of asset 'obj_9988' in group '123' to 'In Repair'. ``` **Response:** ``` Asset 'obj_9988' has been successfully updated with the new status. The changes are now reflected in your Asset Panda account. ``` ## Capabilities ### Map asset structure List all major organizational groups or locations to map out how assets are categorized. ### Audit specific assets Retrieve detailed data for a single object, including custom fields and its current status. ### Manage inventory scope List all individual objects within a defined group to maintain an accurate count of existing hardware. ### Update asset records Modify the status or details of an object, reflecting real-world changes like repairs or reassignments. ### Add new assets to inventory Create a brand new asset record and assign it to the correct organizational group simultaneously. ## Use Cases ### A department needs a quick inventory count. The Facilities Manager asks: 'How many monitors are in the 3rd-floor group?' The agent executes `list_objects` for that specific group, returning an immediate count and list of serial numbers. ### A laptop was reported stolen or needs maintenance. The IT team member asks: 'Change the status of asset obj_456 to Missing.' The agent calls `update_object`, changing the record instantly and logging the change for compliance. ### A new department is established. An Operations Lead asks: 'Create a new group called 'R&D Lab' and add 10 initial assets.' The agent uses `list_groups` to confirm the structure, then calls `create_object` multiple times. ### Compliance audit requires checking asset details. The Auditor asks: 'What are the custom fields for all printers in the main office?' The agent uses `list_groups` to find the group ID, then runs targeted `get_object` calls. ## Benefits - Audit hardware inventory instantly. Instead of manually running reports, you tell the agent to list all objects in a group using `list_objects` and get an immediate count. - Track location changes without manual entry. When equipment moves, simply ask your agent to update its record using `update_object`, reflecting the new site or department immediately. - Build out inventory records easily. Need to log a new piece of gear? Use `create_object` to add it and assign it to the proper group in one conversational step. - Understand system architecture at a glance. You can list all organizational groups using `list_groups`, giving you an immediate map of your entire asset classification structure. - Drill down into details immediately. If you only have an object ID, you don't need to navigate menus; just ask the agent to run `get_object` for full specs. ## How It Works The bottom line is that you tell your agent the desired state change, and it executes the necessary sequence of calls to make it happen. 1. First, verify connectivity using `get_account_check` to ensure proper authorization. 2. Next, scope the request by calling `list_groups` or `list_locations` to identify the relevant asset container. 3. Finally, execute the action (e.g., retrieving details with `get_object`, adding a new record via `create_object`, or updating status with `update_object`). ## Frequently Asked Questions **How do I check if my account connection works with `get_account_check`?** Running `get_account_check` confirms your authorization credentials. The agent verifies connectivity and reports on the current access status, letting you know if further action is needed. **Can I list all assets in a group using `list_objects`?** Yes. You specify the target asset group ID or name, and the agent calls `list_objects`, returning every single object ID and basic status for that container. **What if I need to add a new asset? Do I use `create_object`?** That's right. Use `create_object`. You just tell the agent what the new object is and which group it belongs to, and the record gets written directly. **Is there a better way than using `list_locations`?** `list_locations` works because it's an alias for listing groups. However, if you need detailed metadata about that location itself, calling `get_group` is more precise. **When I use `get_object`, how do I retrieve all the custom field values and detailed metadata for a specific asset?** It returns every piece of data stored on that object. You'll get access to all custom fields, including historical notes and attached details, letting you audit everything about one asset in a single call. **What does calling `get_group` do if I need to know the structural metadata of an entire group?** This function fetches the full schema for an asset group. It lets your agent see how the container is structured and what properties it is designed to hold, which is useful before listing individual assets inside. **When I use `update_object`, how do I make sure I'm only modifying specific fields and not accidentally changing everything?** You must specify the exact data points you want to change and provide the new values. The system prevents accidental overhauls, so your agent controls precisely which updates are applied to the asset record. **If I run `list_groups` and don't see a group name I expected, what steps should I take?** First, check for variations in naming or required permissions. If the group still doesn't appear, it may be nested under a different entity type; you might need to adjust your prompt parameters. **How do I find my Asset Panda Client ID and Secret?** Log in to Asset Panda, go to **Settings (cog icon) > API Configuration**. Your Client ID and Client Secret will be displayed at the bottom of the page. **What is a 'Group ID' in Asset Panda?** Groups (or Entities) are the categories for your records (e.g., Assets, Employees). You can find a group's ID in its URL when editing it in **Settings > Group Settings**. **How do I provide data for creating or updating assets?** Use the `jsonData` parameter with a valid JSON string where keys are field IDs (e.g., `{"field_123": "New Value"}`). You can find field IDs by using the `get_group` tool.