# Chuanyun MCP MCP > Chuanyun MCP provides a single connection point to manage complex, enterprise-level business operations and digital workflows. It lets your agent interact with the core logic of any custom ERP system—listing forms, managing records, auditing approvals, and checking data schemas—all without needing direct access to the source portal. If you deal with structured business objects or multi-step approval processes, this MCP turns that complexity into natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** low-code, workflow-automation, business-objects, digital-transformation, form-management, enterprise-software ## Description This connector lets your agent act as a digital layer over your company’s deepest operational logic. Think of it like giving your AI client read/write access to the entire guts of your custom enterprise system—the one with all the forms and complex approval chains nobody wants to touch directly. You can ask your agent to list every available form schema, then tell it to create a new business record using that form's structure. Need to know who signed off on an order three months ago? Your agent pulls the entire workflow history for you. It keeps your data accurate and your processes running by making complex object management feel like talking to a coworker. Because Vinkius hosts this MCP, you connect once from any compatible client and immediately get visibility into all these foundational business tools. ## Tools ### create_biz_object Generates a brand new business record within your system. ### delete_biz_object Permanently removes an existing business object from the system. ### get_biz_object_details Fetches all specific data details for a single, known business record. ### get_form_schema Retrieves the detailed structure and field definitions for any given application form. ### get_workflow_history Looks up and reports the full timeline of approvals or status changes on an object. ### list_biz_objects Lists multiple business objects (records) based on criteria you specify. ### list_forms Shows a list of all forms available across the entire application. ### list_users Retrieves the current roster of users defined in your organization's directory. ### list_workflows Lists all available automated workflows that run against forms. ### update_biz_object Modifies and saves changes to an existing business object record. ## Prompt Examples **Prompt:** ``` List all business object forms available in my Chuanyun app. ``` **Response:** ``` I've retrieved the available forms for your Chuanyun application. You have 6 schemas, including 'Sales Orders', 'Material Procurement', and 'Customer Assets'. Which one would you like to view records for? ``` **Prompt:** ``` Show me the last 3 records from the 'Material Procurement' form (Code: D00123). ``` **Response:** ``` I've listed the last 3 records from 'Material Procurement'. They include Procurement Order #P-8821, #P-8822, and #P-8823. Would you like to see the detailed field data for any of these orders? ``` **Prompt:** ``` Retrieve the approval history for sales order 'OBJ-9920'. ``` **Response:** ``` I've retrieved the approval history for 'OBJ-9920'. The order was approved by the Sales Manager at 9 AM and is currently pending with the Warehouse Director for final verification. Would you like a detailed step-by-step breakdown? ``` ## Capabilities ### Manage Business Records Create, read, update, or delete specific operational records (business objects) within your system. ### Audit Workflow History Retrieve a full timeline of approvals and status changes for any given business object instance. ### Inspect Form Structure List all available application forms and read their detailed field definitions (schemas). ### Identify Users Access a list of organization users to manage roles and assignments within the business logic. ### Track Process Flows List defined workflows and check which forms are tied into specific automated approval processes. ## Use Cases ### Auditing a Compliance Issue A compliance officer needs to know exactly who approved the 'Material Procurement' order #P-8821. They ask their agent, and it uses get_workflow_history to confirm that approval happened by the Director of Warehouse Assets at 9 AM. ### Onboarding a New Process A Business Analyst wants to know what data fields are available for a new 'Sales Order' form. They prompt the agent, and it uses get_form_schema to list all required fields so they can start building their process. ### Mass Data Cleanup An Operations Manager needs to find and remove old, unused records from a specific project. They prompt the agent, which first uses list_biz_objects to identify candidates, then executes delete_biz_object on confirmation. ### Generating Reports A team lead needs a roster of all active employees involved in procurement. The agent runs list_users and compiles the data into a clean format ready for reporting. ## Benefits - Stop wasting time navigating technical portals. Your agent lets you list available forms and retrieve schemas instantly, giving you visibility into the underlying data structure without logging in anywhere. - You don't have to manually track approvals anymore. Use get_workflow_history to check who signed off on an order and when, getting a clear audit trail immediately via conversation. - Need to change a record? Instead of going through multiple screens, your agent handles both the update_biz_object call and the required validation checks in one go. - The toolset lets you coordinate team efforts. You can list_users and then use that data when calling create_biz_object, ensuring the right people are assigned from day one. - It provides a central hub for object management. Whether you're creating new records with create_biz_object or deleting old ones with delete_biz_object, it all happens through your agent's natural language prompt. ## How It Works The bottom line is: you talk to your AI client, and it handles all the technical API calls needed to get the data from your internal systems. 1. First, subscribe to this MCP and provide your required Chuanyun Engine Code and Secret. 2. Second, connect the credentials to your agent via any compatible client (Claude, Cursor, etc.). 3. Third, prompt your agent with a natural language request—for example, 'Show me the approval history for sales order OBJ-9920.' — and it executes the necessary tools automatically. ## Frequently Asked Questions **How do I check if a business object exists using get_biz_object_details?** You provide the unique ID of the object. If the record is active and accessible, your agent returns all its current field data. If it doesn't exist or you lack permissions, the tool reports that failure. **Can list_forms help me find a specific type of document?** Yes. list_forms shows every accessible application schema name. You can then use get_form_schema on that name to see exactly what fields and data types are available for it. **Is update_biz_object safe if I don't know the current status?** It’s best practice not to assume. You should always call get_workflow_history first. This confirms the object is in a state that allows modification before you run update_biz_object. **Does list_users help me manage my team assignments?** list_users provides the full roster of user IDs and names. You use this data when calling create_biz_object to ensure the correct personnel are assigned ownership or approval rights. **How do I use get_form_schema to understand the data structure of a form?** It provides a detailed breakdown of every field available on that form. You'll see the required data type (string, date, number) for each field, letting you build reliable object creation or update calls. **If I use delete_biz_object, what should I do first to preserve audit information?** Deletion is irreversible. Before running delete_biz_object, always check the workflow history using get_workflow_history. This ensures you capture a complete record of the object's lifecycle before removing it. **What does list_workflows show me about my business processes?** It lists every defined workflow available for your application forms. You can use this to understand the mandatory steps and approval sequence that any new or updated record must follow. **How do I retrieve all records when using list_biz_objects, especially if there are thousands?** The tool supports paginated listing. You'll need to pass a cursor or offset parameter in subsequent calls to pull records beyond the initial batch size.