# MRPeasy MCP

> MRPeasy connects your manufacturing ERP and inventory system directly to your AI agent. You can track customer orders, monitor real-time production progress (MOs), check stock levels for raw materials, and pull vendor lists—all through natural conversation. Stop switching tabs; get your factory data instantly from Claude, Cursor, or any MCP client.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** manufacturing-erp, production-tracking, inventory-control, sales-orders, shop-floor-management, supply-chain

## Description

You're giving your AI agent direct access to your whole manufacturing ERP system. You don't gotta log into seven different dashboards or run separate reports anymore. Just talk to your agent, and it runs the queries for you.

When you connect this server, you give your AI client tools that pull data across five core operational areas:

**Customer Orders & Sales Tracking:**
You can ask your agent to generate a full list of every customer sales order—both current ones and old records. If you need details on just one specific job, the agent uses your unique ID to grab all the info for that single customer order.

**Shop Floor & Production Monitoring:**
The system lets you keep tabs on what's happening right now in the factory. You can pull a list of every active or pending manufacturing order (MO). For deep dives, the agent pulls detailed information for any specific MO. It also lists all the defined work stations used throughout your production environment so you know exactly where things are supposed to be.

**Inventory Control:**
You'll never lose track of stock again. You can list every single inventory item in the system and check its general status. Need to know how much raw material you got, or what specific attributes it has? The agent pulls that exact count and details for any given item.

**Supply Chain Management:**
If you're managing materials coming in, you can get a list of all purchase orders (POs) sent out to your raw material vendors. You also have access to a directory listing every registered supplier and vendor contact you work with.

**Financial Records:**
The agent pulls lists of sales invoices that are directly tied back to the manufacturing activities done on the shop floor.

## Tools

### get_manufacturing_order
Retrieves detailed information for one specific manufacturing order (MO).

### get_stock_item
Gets specific stock item details, including its current count and attributes.

### list_customer_orders
Generates a list of all current and past customer sales orders in the system.

### list_invoices
Provides a list of sales invoices generated from manufacturing activities.

### list_manufacturing_orders
Provides a list of all active and pending manufacturing orders on the shop floor.

### list_purchase_orders
Lists purchase orders (POs) that have been sent to your raw material vendors.

### list_stock_items
Lists all inventory items in the system and their general status.

### list_vendors
Retrieves a comprehensive list of all registered suppliers and vendor contacts.

### list_work_stations
Lists every defined work station used in the production environment.

### get_customer_order
Retrieves specific details for a single customer order using its unique ID.

## Prompt Examples

**Prompt:** 
```
List all active manufacturing orders.
```

**Response:** 
```
I've fetched the active manufacturing orders. You have 8 MOs currently in progress, including 'MO-501' (Status: In Production) and 'MO-502' (Status: Scheduled). Shall I give you the item details for MO-501?
```

**Prompt:** 
```
Check current stock levels for raw materials.
```

**Response:** 
```
Retrieving inventory list... You have 45 items in stock. Notable materials include 'Aluminum Plate' (150 units), 'Steel Bolt' (2,000 units), and 'Plastic Housing' (15 units - Low Stock Alert). Would you like the vendor info for the plastic housing?
```

**Prompt:** 
```
List our registered vendors.
```

**Response:** 
```
I've retrieved your vendor list. You have 12 registered suppliers, including 'Global Metals Co.', 'Swift Fasteners', and 'Reliable Plastics'. Would you like the contact info for Swift Fasteners?
```

## Capabilities

### Check Order Statuses
List or retrieve detailed information on any customer sales order.

### Monitor Production Progress
Access manufacturing orders (MOs) and view defined work stations to track real-time shop floor status.

### Manage Stock Levels
View all inventory items, check current stock counts, and get detailed item history.

### Handle Supply Chain Data
List purchase orders (POs) sent to vendors or look up details for registered suppliers.

### Review Financials
Retrieve lists of sales invoices tied directly to manufacturing operations.

## Use Cases

### The Rush Order Check
A client calls needing 500 units by tomorrow. You ask your agent to run `list_customer_orders` first to verify the details, then use `get_stock_item` to see if you have enough raw materials on hand. If not, running `list_purchase_orders` tells you when the next shipment is due, giving you an immediate answer for the client.

### End-of-Day Reconciliation
It's time to close out production. You ask your agent to list all completed MOs (`list_manufacturing_orders`) and then run `list_invoices` to ensure every finished batch has a corresponding invoice record, preventing revenue gaps.

### Vendor Vetting
A new material is needed. You start by asking the agent to run `list_vendors` to see who supplies similar items, then use `get_stock_item` on your current stock to confirm what you need, and finally ask for purchase order guidance via `list_purchase_orders`.

### Understanding a Backlog
You suspect an order is stuck. You prompt the agent with the customer's name (calling `get_customer_order`). The agent then uses this info to check if there are any related MOs running (`list_manufacturing_orders`) and checks for material shortages via `list_stock_items`.

## Benefits

- See the full list of active manufacturing orders (using `list_manufacturing_orders`). You don't have to remember which dashboard holds that data; just ask your agent for it.
- Get immediate visibility into stock levels. Instead of checking a physical inventory sheet, running `get_stock_item` gives you the real-time count and history in seconds.
- Track cash flow by listing sales invoices (`list_invoices`). This tool connects manufacturing output directly to financial records without manual cross-referencing.
- Manage supplier relationships instantly. You can run `list_vendors` to see who's registered, then use `get_stock_item` to check if that vendor supplies the specific material you need.
- Consolidate order data: Use `list_customer_orders` and `list_manufacturing_orders` together in one prompt to understand the full lifecycle of a product, from sale to assembly.

## How It Works

The bottom line is: it turns complex ERP database lookups into simple chat commands.

1. First, subscribe to the MRPeasy server and input your API credentials (requires an Unlimited plan).
2. Next, you prompt your AI client with a request—for example, 'What's the current stock of steel bolts?'
3. The agent runs the appropriate tool, fetches the live data from MRPeasy, and presents the result to you in plain English.

## Frequently Asked Questions

**How do I check if a specific customer order is ready using list_customer_orders?**
You first use `list_customer_orders` to find the general order details. Then, for deeper status checks like production progress, you'll need to run `get_manufacturing_order` or ask your agent to cross-reference both tools.

**Can I check stock levels and vendors at the same time with get_stock_item?**
No. You use `list_vendors` to see who supplies materials, and you use `get_stock_item` to check current levels. The agent handles running both tools sequentially so you don't have to.

**What is the difference between list_manufacturing_orders and get_manufacturing_order?**
`list_manufacturing_orders` gives you a summary of all active MOs. You use `get_manufacturing_order` when you know the specific ID and need deep, detailed status information on just that one job.

**Does list_purchase_orders help with knowing if I have enough raw materials?**
It helps you plan for it. `list_purchase_orders` tells you what's coming next from a vendor, while `get_stock_item` tells you what you have right now. You cross-reference them to manage inventory gaps.

**If I run `list_vendors` and get an authentication error, what should I check?**
The primary fix is verifying your API keys. Double-check that both the API Key and the Secret you provided to your agent are correct and haven't expired. If they look right, confirm that your subscription plan supports external vendor lookups.

**Does `get_manufacturing_order` tell me which work stations are needed for production?**
It provides the status of the order itself. To see the required physical locations or specific workstations, you need to run a separate query using the `list_work_stations` tool first. Then, your agent can cross-reference that data.

**If I use `list_invoices`, can I retrieve financial records older than one year?**
Yes, provided those invoices are still active in the MRPeasy system and within the supported retention window. You may need to specify a date range when querying so your agent knows exactly what historical data it's looking for.

**How does `list_stock_items` handle very large inventory counts?**
The tool supports pagination, which means you don't get a massive list all at once. You tell your agent how many records to check per call, keeping the response manageable and fast for your AI client.

**Is API access available on all MRPeasy plans?**
No. According to MRPeasy documentation, the API is exclusively available to clients on the 'Unlimited' pricing plan.

**Can I see the Bill of Materials (BOM) for a production order?**
Yes! Use the `get_manufacturing_order` tool with a specific MO ID to see the detailed metadata including the bill of materials required for that order.

**How do I find a specific item's stock history?**
Use the `get_stock_item` tool with the item ID to retrieve its complete metadata and stock levels.