# Cin7 Core MCP for AI Agents MCP

> Cin7 Core gives your AI agent direct access to a comprehensive inventory management system for tracking product catalogs, sales orders, and purchase orders. It lets you query real-time stock levels across multiple warehouses, research customer history, or monitor the status of any order—all using natural conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** stock-control, order-management, purchase-orders, product-catalog, supply-chain, warehouse-management

## Description

Managing supply chain operations usually means jumping between five different tabs: one for inventory, one for customers, another for purchases, and several more for order statuses. Cin7 Core connects all that data into a single chat window. You can ask your agent things like, 'How much stock of SKU XYZ do we have in the main warehouse right now?' or 'What's the status of the purchase order from Acme Corp?'. It pulls together product details, current inventory levels, and full order fulfillment histories instantly.

This connector allows your AI client to manage complex business processes—from tracking a simple stock check to coordinating multi-warehouse movements. When you connect Cin7 Core through Vinkius, you're giving your agent the operational muscle needed for modern commerce. You stop generating reports and start getting answers.

## Tools

### get_product_details
Retrieves detailed product attributes, including dimensions, weight, and tax rules, using a specific product identifier.

### get_sale_order_details
Provides comprehensive information for an individual sales order, covering line items, shipping addresses, and current fulfillment progress.

### get_sku_stock_status
Generates a detailed stock breakdown showing quantities across all physical locations or virtual bins for one specific SKU.

### get_all_stock_availability
Returns real-time total availability data, including on-hand, allocated, and available-to-sell counts from every warehouse.

### list_crm_customers
Lists all registered customer records, providing metadata like contact names, company details, and credit limits.

### list_inventory_products
Returns a list of every product in the catalog with essential data points like SKU, name, category, and base price.

### list_purchase_orders
Lists all purchase orders, giving details on suppliers, order dates, and whether the goods have been received or are pending.

### list_sales_orders
Provides a list of sales orders with key metadata, including customer ID, total value, and current processing status.

### list_crm_suppliers
Retrieves vendor profiles containing primary contact information, default currency, and standard payment terms.

### search_products_by_sku
Looks up stock levels and identification data for any product that matches a given SKU identifier.

## Prompt Examples

**Prompt:** 
```
What's the total stock count for 'Premium Leather Chair' across all our warehouses?
```

**Response:** 
```
**Stock Report: Premium Leather Chair (SKU: CH-1001)**

*   **Total Units Available:** 45 units
*   **On Hand:** 30 units (Main Warehouse)
*   **Allocated to Orders:** 15 units (Distribution Center B)
*   **Available to Sell:** 30 units

We also see that Order #SO-209 for this SKU is currently packed and awaiting pickup.
```

**Prompt:** 
```
I need details on the last order we placed with 'Furniture Pros'.
```

**Response:** 
```
**Vendor Profile: Furniture Pros**
*   **Main Contact:** Jane Smith (jane.smith@furniturepros.com)
*   **Payment Terms:** Net 30 Days
*   **Recent Activity:** They currently have 2 active purchase orders with us.

We can also list their order history if you want to see the last five transactions.
```

**Prompt:** 
```
List all sales orders over $10,000 that are ready to ship.
```

**Response:** 
```
**High-Value Sales Orders Ready for Fulfillment**

Found 4 orders matching your criteria:

| Order ID | Customer Name | Total Value | Status |
| :--- | :--- | :--- | :--- |
| SO-135 | Alpha Corp | $12,500.00 | Packed |
| SO-142 | Beta Industries | $10,100.00 | Authorized/Packed |

Which order do you want the full details for?
```

## Capabilities

### Get detailed product specifications
Retrieve specific attributes like dimensions, weight, tax rules, or supplier information for any given product.

### Track full sales order progress
Pull complete details for a sales order, including line items, shipping addresses, and current fulfillment status.

### Monitor real-time stock levels by SKU
Get an immediate breakdown of quantities available across all physical locations and virtual bins for one product.

### Check total warehouse availability
Retrieve current stock status, detailing on-hand, allocated, and available-to-sell totals across every configured location.

### List all customer or vendor data
Access contact names, company details, and historical records for any registered client or supplier.

### View product catalog listings
Get a complete list of products, including SKUs, names, categories, and base pricing.

## Use Cases

### Answering the 'Can we ship this?' question
A warehouse manager needs to know if they can fulfill a large order. They ask their agent, and it checks total stock availability across all warehouses and verifies product details like weight and dimensions using both get_all_stock_availability and get_product_details.

### Handling an overdue shipment inquiry
A sales rep gets a call from a client asking about an order. The agent lists the sales orders, finds the specific one, checks its current status, and gives the customer accurate fulfillment details instantly.

### Preparing for a new vendor relationship
A purchasing agent needs to onboard a new supplier. They ask the agent to list all suppliers, find the company's contact info using list_crm_suppliers, and then check if there are any open purchase orders pending with them.

### Checking stock for multiple SKUs
A team lead needs a quick count on several items. They ask the agent to search for products by SKU and get an immediate, aggregated stock report across all locations without manually entering each item into a spreadsheet.

## Benefits

- Instant stock visibility: Instead of running multiple reports to check inventory levels or product locations, you can use the agent to query total availability across all warehouses in one go.
- Comprehensive order tracking: You don't need separate tabs for sales and purchases. The agent monitors both sides of your supply chain by listing sales orders and checking purchase order statuses.
- Faster research cycles: Researching vendor or customer history is instant. The agent pulls up full profiles, including contact details and credit limits, without you ever leaving the chat window.
- Detailed product data retrieval: Need to know if a specific item can ship? Use the tool for detailed attributes like weight, dimensions, and tax rules instead of guessing.
- Proactive inventory management: You can cross-reference stock levels with order statuses. For example, check current availability and then see which sales orders depend on it.

## How It Works

The bottom line is that your AI client runs complex inventory queries and reporting tasks inside Cin7 Core using simple chat commands.

1. Connect your AI client to Cin7 Core using your Account ID and Application Key.
2. Authorize access by giving the agent permission to read product, order, and customer data.
3. Ask a natural language question—for example, 'Show me all open purchase orders for Q3.'—and let the system execute the required checks.

## Frequently Asked Questions

**How does Cin7 Core help me check stock across multiple warehouses?**
It gives you a single, consolidated view of your inventory. Instead of logging into different systems or running separate reports for each location, the MCP pulls together on-hand, allocated, and available counts instantly.

**Can I use Cin7 Core to track both sales orders and purchase orders?**
Yes, absolutely. You can ask your AI agent for an end-to-end view of the supply chain. It tracks incoming supplies from vendors (purchase) and outgoing goods to customers (sales), helping you spot bottlenecks.

**Is Cin7 Core better than manually searching product details?**
It’s vastly superior. Instead of just reading a static description, the MCP allows you to ask questions that combine data—like 'What is the weight AND the tax class for this specific item?' and get an instant answer.

**Does Cin7 Core help with vendor research?**
It does. You can list all your vendors and pull up detailed profiles, including primary contacts, payment terms, and a list of any outstanding purchase orders you have open with them.

**What if I need to verify customer credit limits while placing an order?**
The MCP gives you access to the full customer metadata. You can list all customers and verify their current credit limit right alongside their contact information, preventing over-selling.