# Yonyou / 用友 MCP

> Yonyou / 用友 connects your AI agent directly into the core Chinese ERP system. Use it to get real-time data on purchases, sales, inventory levels, supplier lists, and financial vouchers. Stop clicking through massive dashboards; just ask your agent for operational reports or specific material details.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** inventory-management, purchase-orders, financial-auditing, cloud-business-services, enterprise-resource-planning, logistics-tracking

## Description

This MCP lets your AI client run complex enterprise operations without you ever seeing the YonBIP interface. Instead of manually navigating dozens of tabs to track a shipment or check an expense report, you simply talk to your agent. It handles retrieving detailed material metadata and checking current inventory levels across warehouses instantly. For instance, if you need to know both the original purchase order details and how much stock is left, your agent pulls everything together. This capability works because Vinkius lets you combine multiple MCPs; you can chain this Yonyou connection with a separate messaging tool to automatically alert a team lead once inventory drops below a certain threshold. Your AI client acts like a real-time operations assistant, giving you full visibility into financial vouchers and supply chain status without risking data integrity or manually running reports.

## Tools

### get_inventory
Queries the ERP for specific stock counts and locations of materials.

### get_org_info
Retrieves fundamental metadata about the company's organizational structure.

### get_purchase_order
Fetches detailed information for a specific purchase order number.

### get_sales_order
Retrieves full details about a single sales order transaction.

### list_customers
Generates a list of all customer records managed in the ERP.

### list_materials
Provides access to the master data catalog for materials and products.

### list_purchase_orders
Lists multiple purchase orders, allowing you to see a summary of recent transactions.

### list_sales_orders
Lists multiple sales orders for an overview of current and past revenue streams.

### list_suppliers
Provides a list of all approved vendors and suppliers in the system.

### list_vouchers
Lists financial vouchers to audit spending or record transactions.

## Prompt Examples

**Prompt:** 
```
List the last 5 purchase orders in Yonyou.
```

**Response:** 
```
I've retrieved your recent purchase orders. They include transactions for 'Steel Sheets' and 'Industrial Connectors'. Total value for these orders is ¥450,000. Would you like to check the fulfillment status?
```

**Prompt:** 
```
What is the current inventory for material ID 'MAT-8821'?
```

**Response:** 
```
The current inventory for MAT-8821 is 1,200 units. There are 800 units in the 'East Warehouse' and 400 in the 'West Logistics Center'. Would you like me to notify you if stock falls below 500 units?
```

**Prompt:** 
```
Show me the organization structure defined in our ERP.
```

**Response:** 
```
I've retrieved the organizational metadata. Your ERP environment is structured into 3 main branches: 'Headquarters', 'Manufacturing Division', and 'Global Sales'. Would you like a detailed breakdown of the legal entities under each branch?
```

## Capabilities

### Track Material Status
Get current stock counts for specific items across different warehouse locations.

### Review Transaction History
List recent purchases and sales orders, including associated values and dates.

### Audit Financial Records
Browse high-level accounting vouchers to check spending and organizational finances.

### Identify Business Partners
List all existing customers, suppliers, and materials in the system's master data.

### Determine Organizational Scope
Retrieve fundamental metadata about the company structure within the ERP.

## Use Cases

### Checking Fulfillment Status
A buyer needs to know if the materials ordered are ready. They ask their agent, and it checks `list_purchase_orders`, finds the correct PO number, then runs `get_inventory` to confirm stock availability.

### Quarterly Finance Review
The finance team needs a quick overview of Q2 spending. They ask their agent, which uses `list_vouchers` and cross-references the data with company metadata from `get_org_info`.

### Vendor Vetting
A procurement specialist needs to compare potential new vendors against current ones. They use `list_suppliers` first, then check specific material costs using `list_materials` to ensure compliance.

### Troubleshooting an Order
An operations team member knows a customer complaint relates to an old order. They ask the agent, which uses `get_sales_order` for details and then runs `list_customers` to verify contact information.

## Benefits

- Stop jumping between screens. Instead of running separate reports for purchase orders and sales orders, your agent checks both in one prompt using `list_purchase_orders` and `list_sales_orders` together.
- Cut out manual data gathering. You can instantly check the stock level by calling `get_inventory`, then immediately use that number to cross-reference with a supplier list from `list_suppliers`.
- Audit transactions in minutes. Instead of navigating complex financial menus, you just ask your agent to check vouchers using `list_vouchers`, and it pulls the data directly.
- Know where everything is. Get an immediate overview of organizational scope by calling `get_org_info`, which tells you how the company structure relates to material handling via `list_materials`.
- Simplify complex tasks. Need to see details on a single item? You can retrieve specific order data using `get_purchase_order` or `get_sales_order` without wading through hundreds of records.

## How It Works

The bottom line is: you talk to your AI client, and it translates that request into actionable data from Yonyou's backend.

1. First, subscribe to this MCP and provide your Yonyou App Key, Secret, and Tenant ID.
2. Next, use your AI agent in any compatible client (like Claude or Cursor) and ask it a specific question about inventory or orders.
3. Your agent runs the query through the system, retrieves structured data points, and presents them back to you as plain text.

## Frequently Asked Questions

**How does the Yonyou / 用友 MCP handle multiple order types?**
It manages both purchases and sales separately. You use `list_purchase_orders` for incoming goods and `list_sales_orders` for outgoing revenue, keeping your records clean.

**What data can I get about the company structure using Yonyou / 用友 MCP?**
The `get_org_info` tool lets you retrieve high-level organizational metadata. This tells you how different legal entities are structured within the ERP.

**Can I check financial records with Yonyou / 用友 MCP?**
Yes, use `list_vouchers`. It allows your agent to list and summarize accounting vouchers so you can audit spending without going into the complex finance module.

**Does Yonyou / 用友 MCP handle master data for vendors?**
You can manage vendor information by using `list_suppliers`. This provides a full list of approved partners within the system.

**How do I use the `list_materials` tool to check product details?**
The `list_materials` tool retrieves detailed master data for all defined materials. This includes IDs, descriptions, and classification codes necessary for inventory planning and audits.

**What credentials do I need when setting up the Yonyou / 用友 MCP?**
You must provide your specific Yonyou App Key, App Secret, and Tenant ID. These keys are handled by Vinkius through a zero-trust proxy; they're used in transit but never stored on disk.

**How can I get specific purchase order information using `get_purchase_order`?**
The `get_purchase_order` tool pulls all detailed data for a single, specified PO number. This includes line items, associated vendors, and the current fulfillment status.

**How secure is data when using the Yonyou / 用友 MCP?**
Data security relies on Vinkius's sandbox environment and zero-trust proxy system. Every tool call generates a cryptographically signed audit trail, ensuring every interaction remains tamper-proof.

**How do I find my Yonyou Tenant ID?**
Log in to your Yonyou YonBIP administration backend, go to [Digital Modeling] → [My Enterprise] → [Enterprise Information], and you will find your Tenant ID there.

**Can I query inventory levels through this server?**
Yes. Use the `get_inventory` tool to retrieve real-time stock information. You can filter by material ID or warehouse to get precise availability data.

**Is it possible to list financial vouchers?**
Yes! Use the `list_vouchers` tool to retrieve a history of accounting vouchers, allowing your agent to audit financial movements across the organization.