# Veeqo MCP MCP

> Veeqo MCP manages everything from order intake to shelf stock. It lets you query inventory levels, track shipments across multiple carriers, and build new orders directly inside your AI agent. Use it to manage multi-channel fulfillment for Amazon, Shopify, and beyond.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** order-fulfillment, multi-channel-retail, stock-tracking, warehouse-management, shipping-automation, inventory-control

## Description

Managing retail operations usually means jumping between five different dashboards: one for sales, one for warehouse stock, one for carrier tracking, and another for customer records. This MCP lets you handle that mess through natural conversation. You can ask your agent to list all active orders or check the real-time count of a specific product SKU across every location. It handles complex logistics tasks—from retrieving detailed line items on an order to fetching full fulfillment histories for shipments. If your workflow requires combining this with, say, a messaging MCP to alert staff when stock drops, you can chain those operations together through Vinkius. This means building automations that span multiple platforms using one AI agent, keeping your entire supply chain view accessible in the chat window.

## Tools

### create_manual_order
Manually builds a new sales order record in Veeqo.

### get_order_details
Retrieves all specific information for one given sales order.

### get_product_details
Fetches detailed metadata and variant status for a single product SKU.

### list_customers
Lists all customer records currently in the Veeqo system.

### list_inventory_products
Retrieves a list of every available product SKU in your catalog.

### list_orders
Generates a summary list of sales orders within the platform.

### list_shipments
Lists all past and pending shipments with their tracking numbers.

## Prompt Examples

**Prompt:** 
```
List all active orders in my Veeqo account.
```

**Response:** 
```
I've retrieved your orders. You have 5 active sales orders including #10293, #10294, and #10295. Their statuses range from 'Awaiting Shipment' to 'Picking'. Which one should we inspect?
```

**Prompt:** 
```
Check the current stock for 'Blue T-Shirt' in the inventory.
```

**Response:** 
```
Fetching product details... The 'Blue T-Shirt' (SKU: TS-BLUE-01) has 42 units remaining in your main warehouse and 15 units in the secondary location. Shall I set a low-stock alert?
```

**Prompt:** 
```
Show me the last 3 shipments and their tracking numbers.
```

**Response:** 
```
I've retrieved the latest shipments: #SH-8823 (Track: 1Z99...), #SH-8824 (Track: 1Z88...), and #SH-8825 (Track: 1Z77...). All have been dispatched successfully via UPS.
```

## Capabilities

### Order and Customer Retrieval
Get a list of all sales orders or specific customer contact details associated with those orders.

### Real-Time Stock Checking
Check current stock levels for any product SKU across your entire inventory catalog.

### Shipping and Fulfillment Tracking
List all past shipments or track the status of items currently in transit.

### Order Creation
Manually build a new sales order for a customer when one isn't automatically logged into the system.

## Use Cases

### The stock count is wrong, and I need to verify it.
A client asks: 'Does the Blue T-Shirt have enough stock for 50 units?' The agent runs `get_product_details` and returns the real-time count from multiple warehouses. You confirm the shortage and flag the inventory team.

### I need to know what happened with a specific order.
You ask your agent: 'Tell me everything about Order #12345.' The tool runs `get_order_details`, giving you line-item information, customer history, and fulfillment status all in one response.

### I'm onboarding a new client who needs an order logged fast.
Instead of manually creating the order on the website, you tell your agent to `create_manual_order` for the new customer. It logs the transaction instantly and keeps the record clean.

### I need a quick overview of everything we sold last week.
You prompt the agent to `list_orders`. It returns a summary list, allowing you to see which orders are pending shipment versus those already completed. This saves 10 minutes of dashboard clicking.

## Benefits

- Stop jumping between screens. You can list all shipments and get their tracking numbers using the `list_shipments` tool, right where you are working.
- Need to check if a product is available? Use `get_product_details` to fetch deep metadata on any SKU instantly.
- Building an order for a customer who missed checkout? You can use `create_manual_order` instead of logging in and navigating forms.
- Keep your contact records clean. The agent can run `list_customers` so you always have the right details when fulfilling an order.
- Monitor sales flow by using `list_orders`, giving you a quick summary view without needing to check individual invoices.

## How It Works

The bottom line is you talk to your agent, and the MCP executes the necessary e-commerce data calls behind the scenes.

1. Subscribe to this MCP and enter your Veeqo API Key in the platform settings.
2. Connect your preferred AI client (Claude, Cursor, or any compatible app) to the Vinkius catalog.
3. Ask your agent a question like 'What's the stock for SKU XYZ?' and it runs the query through Veeqo.

## Frequently Asked Questions

**Can I check the stock level of a specific SKU via AI?**
Yes! Use the `list_inventory_products` tool to see your catalog, or `get_product_details` with a specific Product ID to see variant stock levels.

**How do I see the latest shipping updates?**
Run the `list_shipments` query. The agent will retrieve a history of recent shipments, allowing you to monitor fulfillment progress directly from the conversation.

**Is it possible to create a manual order via AI?**
Absolutely. Use the `create_manual_order` action. You'll need to provide the customer details and an array of line items in JSON format to initiate the order.

**When I run `list_orders`, what parameters can I use to filter orders by date or status?**
You can specify filters like date ranges and order statuses. The AI agent handles this by passing the necessary query parameters to the tool call, so you don't have to manually filter large datasets.

**If I try to run `get_order_details` for an order ID that doesn't exist, what response do I get?**
It returns a clear error code and message. The agent will tell you the record wasn't found because the specific Order ID provided doesn't match any records in Veeqo.

**What process should I follow to correctly authenticate my connection before using `list_customers`?**
You must provide a valid Veeqo API key during setup. The MCP uses this credential only for transit, ensuring your keys are never stored on the platform.

**When I use `list_inventory_products`, does it return all available product metadata, or just basic stock levels?**
It returns comprehensive metadata. You get details like variant status and full descriptions alongside real-time inventory counts for accurate catalog management.

**Is there a limit to the number of shipments I can retrieve when calling `list_shipments`?**
The tool supports pagination, meaning it handles large volumes. If you need more than the initial batch, just ask your agent to 'continue listing' or specify a page offset.