# Order Time MCP

> Order Time MCP connects your AI agent directly to professional inventory, customer, and fulfillment data. You can list full product catalogs, check detailed item specs, find specific customers, and track both sales and purchase orders with natural language commands.

## Overview
- **Category:** inventory-management
- **Price:** Free
- **Tags:** inventory-tracking, order-fulfillment, purchase-orders, sales-tracking, warehouse-management

## Description

Managing physical goods means juggling three things: what you sell, who you sell it to, and where the inventory sits right now. This MCP gives your AI agent programmatic access to all of that data via Order Time's API. Instead of opening ten browser tabs—one for sales, one for customers, and a dozen for stock counts—you tell your client exactly what you need, and it retrieves it instantly.

Need to know if Customer X paid on time? Your agent pulls their profile using the `get_customer` tool. Need to verify that 50 units of Part Y are actually in the warehouse? Use `list_items`. Then, trace back whether those items were tied up in a recent sales order or waiting for a purchase delivery. This unified view means your AI client can do complex cross-checks—for instance, comparing current stock levels against pending orders—without you writing a single SQL query. By connecting this MCP through Vinkius, you give your agents the full operational picture of your business, letting them handle everything from simple inventory queries to complete fulfillment audits.

## Tools

### get_customer
Retrieves all detailed information about a specific customer by their ID or name.

### get_item
Fetches the full specifications, current stock count, and details for one item number.

### get_purchase_order
Gets all data associated with a specific purchase order ID, including line items and expected delivery dates.

### get_sales_order
Retrieves the complete details for one sales order, showing who it was billed to and what products were included.

### list_custom_fields
Shows a list of specialized data fields you can retrieve from your records, like custom tracking IDs.

### list_customers
Returns a browsable list of all customers in your system, perfect for finding contact info quickly.

### list_items
Provides a comprehensive catalog view, listing thousands of items and their current inventory counts.

### list_purchase_orders
Lists multiple purchase orders, allowing you to see which incoming deliveries are scheduled for the week.

### list_sales_orders
Returns a list of recent sales orders, giving an overview of all transactions that happened today or this month.

## Prompt Examples

**Prompt:** 
```
List my inventory items.
```

**Response:** 
```
Fetching items... I've found 150 items in your catalog. Here are the most recent ones...
```

## Capabilities

### View and audit product stock
You can list every item in your catalog or get detailed specs for a single part number.

### Track customer records
Retrieve comprehensive profiles, including historical details, for any known client.

### Monitor sales and purchase movements
Check the real-time status of both completed and pending sales orders, as well as incoming purchase deliveries.

### Pull specialized metadata
Access custom field definitions attached to items or customers for niche business data.

## Use Cases

### A sales rep needs to confirm product availability for a large quote.
The agent runs `get_item` on the specific SKUs listed. It confirms that 50 units are available and pulls up customer contact details using `get_customer`, allowing the rep to send an accurate, immediate quote.

### An operations team needs to audit a shipment delay.
The analyst uses `list_purchase_orders` to find the expected delivery date. Then they run `get_purchase_order` for that specific PO number, identifying which internal department was responsible for the final receiving check.

### A customer calls asking about a past order's status.
The agent takes the provided Order ID and runs `get_sales_order`. It returns all items purchased, the billing address, and the current fulfillment stage without needing human intervention.

### A store manager needs a complete inventory count for annual tax purposes.
The agent executes `list_items` to get every SKU name and its exact quantity on hand. It can then append this data with any custom field definitions using `list_custom_fields` for enhanced reporting.

## Benefits

- You immediately know if an item is stocked. Instead of calling the warehouse, asking your agent to run `get_item` gives you instant stock levels for any part number.
- Cross-reference sales against purchases easily. Your agent can take a list from `list_sales_orders` and check that same data point against pending incoming shipments using `list_purchase_orders`.
- Stop chasing records. Need to know everything about Customer Smith? Running `get_customer` pulls their full profile, replacing multiple database lookups into one simple prompt.
- Improve auditing speed by getting a complete item list in bulk. The `list_items` tool provides immediate visibility across your entire product catalog, helping you spot low stock before it's too late.
- Understand the history behind every transaction. By checking both `get_sales_order` and `get_purchase_order`, you build a clear paper trail showing why an item is in or out of stock.

## How It Works

The bottom line is, you hand off complex data lookup tasks to your AI client instead of manual dashboard navigation.

1. Subscribe to this MCP on Vinkius and enter your Order Time API Key, User Email, and Password.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the new connection endpoint.
3. Ask your agent a question like, 'What is the current stock level for part number 90210 and which customer was it meant for?' The MCP handles the data retrieval.

## Frequently Asked Questions

**How do I check the current stock levels using Order Time MCP?**
To see all products, use `list_items`. If you need details on one specific part number, run `get_item` and specify the item ID.

**Can I track both incoming and outgoing orders with Order Time MCP?**
Yes. Use `list_sales_orders` for items leaving your facility. Use `list_purchase_orders` to see everything scheduled to arrive at your warehouse.

**What if I need historical data on a customer? Does Order Time MCP support that?**
The agent pulls all relevant history using `get_customer`. This includes past order details and contact records, letting you understand their full relationship with your business.

**Does the Order Time MCP let me see custom product data?**
Yes. The `list_custom_fields` tool lets you retrieve specialized metadata that isn't in standard fields, perfect for compliance or tracking unique identifiers.