# Afosto MCP MCP > Afosto is your dedicated retail and e-commerce engine, giving you natural language control over your entire online operation. Manage orders, monitor inventory across multiple warehouses, audit product catalogs, and access centralized customer profiles—all through simple conversations with your AI agent. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** retail-engine, multi-channel-commerce, inventory-tracking, order-fulfillment, product-catalog, warehouse-management ## Description This MCP connects your AI client directly to the core systems that run your retail business. It lets you manage everything from checking out a new order to auditing which products need price changes. Instead of logging into multiple dashboards or running complex database queries, you just talk to your agent and get answers instantly. Need to know if an item is in stock before confirming an order? Ask it. Want to see all the details on a customer's purchase history for support? It finds that data. The system pulls together records of multi-channel orders, real-time warehouse stock levels, product variants, and centralized buyer profiles. If you use Vinkius as your central catalog, this MCP gives you the hands-on control needed to keep your entire retail stack running smoothly. ## Tools ### list_orders Retrieves a list of recent multi-channel orders that have been placed through the platform. ### list_inventory Shows current stock counts for products, broken down by every warehouse location. ### list_products Gives you the entire product catalog, including all active variants and their assigned prices. ### list_customers Pulls a customer's full profile and their complete history of buying from the store. ## Prompt Examples **Prompt:** ``` List all pending orders from the last 24 hours. ``` **Response:** ``` I've retrieved your pending orders. You have 15 new orders awaiting fulfillment from your Web Store and Amazon channels. Would you like to see the inventory status for the items in these orders? ``` **Prompt:** ``` What is the current stock level for 'Wireless Headphones' in all warehouses? ``` **Response:** ``` I've checked the inventory. You have 120 units of 'Wireless Headphones' available: 80 in Main Warehouse and 40 in Northern Hub. There are 10 units currently reserved for pending orders. ``` **Prompt:** ``` Search for a customer profile with email 'john.doe@example.com'. ``` **Response:** ``` I've found the profile for John Doe. He is a 'Gold' tier customer with 5 lifetime orders. His last order was 2 weeks ago. Would you like to see his full interaction history? ``` ## Capabilities ### Audit fulfillment status for multiple orders The agent can list and check the current status of recent multi-channel e-commerce orders. ### Track stock across all warehouse locations It retrieves real-time inventory levels, aggregating stock counts from various warehouses and distribution hubs. ### Pull centralized customer data and history You can get full profiles on customers, including their lifetime purchase records and interaction history. ### List product details and pricing information The MCP provides the complete catalog, showing active variants and current retail pricing for any item. ## Use Cases ### Handling a complex support ticket A customer calls asking why their order is delayed. The agent first uses `list_customers` to verify the account, then runs `list_orders` to confirm the item details and current fulfillment status across channels. ### Preparing for a flash sale The ops manager needs to know if they can promise 100 units of a specific item. They use `list_inventory` first, checking all warehouse locations, before approving the marketing campaign that relies on accurate stock counts. ### Reviewing product data consistency Before launching a new line, the analyst uses `list_products` to verify every variant and its corresponding pricing structure. This prevents errors where old prices might accidentally appear online. ### Identifying sales gaps for reporting The business team needs to know if recent orders are coming from the right sources. They combine data from `list_orders` with `list_customers` to quickly identify which customer segments are driving volume. ## Benefits - Stop manually checking multiple dashboards. With the `list_inventory` tool, you get a single view of stock across every warehouse location, identifying exactly where replenishment is needed. - Customer support gets answers fast. Instead of asking another agent to check, your AI client uses `list_customers` and `list_orders` to pull up full profiles and order history immediately. - Keep your storefront accurate. Use `list_products` to ensure every variant and price listed in the catalog is correct before a sale goes live. - Audit fulfillment risk instantly. The agent handles complex queries on recent orders using `list_orders`, letting you track status across web stores and third-party channels. - Streamline reporting. Instead of exporting four different CSV files, your AI client aggregates data from all tools to give quick insights into sales trends or inventory bottlenecks. ## How It Works The bottom line is that you talk to your agent, and it executes complex queries against all your retail backend systems. 1. Subscribe to this MCP and provide your Afosto Client ID and Secret. 2. Connect your preferred AI client (like Claude or Cursor) through Vinkius. 3. Use natural conversation to ask the agent for specific data, such as checking inventory levels or listing orders. ## Frequently Asked Questions **How do I check stock using list_inventory?** You ask your agent to use `list_inventory`. It aggregates real-time counts for any product across every warehouse, letting you know exactly where the available units are located. **Can I find a customer's history using list_customers?** Yes. Running `list_customers` pulls up a centralized profile containing all of their historic e-commerce activity and interaction data, helping support teams resolve issues faster. **What does list_orders retrieve?** `list_orders` fetches recent multi-channel orders. This includes key fulfillment statuses so you know if an order is stuck in processing or ready to ship. **Does Afosto MCP help with product pricing? Use list_products.** The `list_products` tool gives you the complete, current view of your catalog. You can verify that all variants and their correct pricing are listed in one go. **When setting up access for list_customers, what credentials are required?** You'll need your Afosto Client ID and Secret Key. These credentials securely authenticate your AI client against the retail engine’s API endpoints, allowing your agent to retrieve centralized profiles. **When running list_products, can I filter by active variants or specific categories?** Yes, you can specify filters like category IDs or variant SKUs. This lets your agent pull only the precise data set you need from the complete product catalog. **If I run list_inventory frequently, how does Afosto handle rate limiting?** The MCP handles standard API rate limits automatically. Your AI client will receive clear error messages if you exceed the allowed call volume within a given timeframe, preventing service disruptions. **After using list_orders, how do I get corresponding inventory details?** You pass key identifiers, like order numbers or SKUs, to other tools. Your agent orchestrates the necessary calls across multiple MCP functions for a complete fulfillment picture. **How do I find my Afosto API credentials?** Log in to the Afosto Admin App, navigate to **Company** > **API Settings**. You can create a new integration there to generate your Client ID and Client Secret. **Can I check stock levels across multiple warehouses?** Yes! Use the `list_inventory` tool. It provides real-time stock data aggregated by location, helping you manage omnichannel fulfillment. **Does this support multi-channel orders?** Absolutely. The `list_orders` tool retrieves orders from all connected sales channels, including B2B, B2C, and integrated marketplaces.