# Fieldfolio MCP > Fieldfolio MCP connects your AI agent directly to a B2B wholesale marketplace, letting you manage complex operations without logging into a dashboard. You can list products, check real-time inventory levels, search the entire catalog by keyword, and pull up customer order history—all from a chat interface. It's designed for ops teams who need immediate data access on everything from stock counts to pending wholesale orders. ## Overview - **Category:** e-commerce - **Price:** Free - **Tags:** inventory-management, order-fulfillment, wholesale, crm, catalog-management ## Description This MCP lets your AI agent handle core wholesale operations using your Fieldfolio seller account credentials. Need to know if you have enough units of Product X? You can check the current stock levels and even update inventory quantities directly through a simple query. Want to see what's selling? It pulls up full lists of past orders, letting you track fulfillment status for every single sale. Beyond just counting items, your agent can access customer profiles, giving you instant history on any retail client. If you use Vinkius, you get immediate access to this tool alongside thousands of others, meaning you're not stuck rebuilding integrations; you just connect and start working across all your business systems. ## Tools ### get_customer Pulls details, including past orders, for a specific retail customer using their identity. ### get_me Retrieves key operational data and metadata about the authorized seller account itself. ### get_order Fetches detailed information for a single wholesale order, showing line items and status. ### get_product Gets all available details about one specific product using its ID or SKU. ### list_categories Retrieves a complete list of every product category defined in the wholesale catalog. ### list_customers Returns a full list of all registered retail customers associated with the seller account. ### list_inventory Provides an overview of current stock levels for every product in the catalog. ### list_orders Generates a list view of all historical and pending wholesale orders across the account. ### list_products Lists every product available in the entire wholesale catalog, without details. ### list_webhooks Displays all active webhooks configured for third-party data synchronization and auditing purposes. ### search_catalog Searches the entire wholesale product catalog using a keyword to narrow down results immediately. ### update_inventory Changes the stock count for a specific product, allowing you to adjust inventory levels in real time. ## Prompt Examples **Prompt:** ``` List my active wholesale orders. ``` **Response:** ``` I've retrieved your recent orders. You have 12 orders currently pending, including 'Retailer A' (Order #1025) and 'Store B' (Order #1026). Would you like to see the item breakdown for any of these? ``` **Prompt:** ``` Check the inventory level for 'Summer T-Shirt'. ``` **Response:** ``` Inspecting inventory... 'Summer T-Shirt' (SKU: ST-101) currently has 45 units in stock. Shall I alert you if it drops below 10? ``` **Prompt:** ``` Search the catalog for 'Ceramic Vases'. ``` **Response:** ``` Searching catalog... I found 3 matching items: 'Minimalist Ceramic Vase', 'Blue Glazed Vase', and 'Rustic Pot'. Which one would you like more details on? ``` ## Capabilities ### Manage product listings List every item in your wholesale catalog or fetch detailed metadata for a specific product. ### Track customer data Access and review profiles, including the complete order history, for any retail customer. ### Monitor orders and sales Retrieve full details on wholesale orders to track fulfillment status or check historical transaction records. ### Control inventory levels Query real-time stock counts across all products, and directly adjust the available quantity for specific items. ### Search your product catalog Find specific items quickly by running a keyword search against your entire wholesale inventory. ### View account details Retrieve key operational data and metadata for the connected seller account. ## Use Cases ### Fulfilling a high-priority rush order. A sales rep needs to confirm stock for a large, complex order. They tell their agent: 'Check the current inventory level for SKU XYZ.' The agent calls `list_inventory` and confirms availability, then uses `get_order` to verify the specific fulfillment requirements before confirming the sale. ### Auditing a client's account status. An ops manager needs to review Client A's history. They ask their agent about 'Retailer B.' The agent uses `get_customer` to pull up the profile and order details, giving instant visibility into past purchasing patterns. ### Updating product data after a bulk shipment. The inventory specialist receives 50 units of Model P. They instruct their agent: 'Update inventory for Model P by 50.' The agent calls `update_inventory`, immediately syncing the stock count and keeping records accurate without touching the dashboard. ### Finding a niche product quickly. A user knows they need something but doesn't know the exact category. They ask their agent to 'Search for gardening supplies.' The agent calls `search_catalog` and returns immediate, relevant suggestions. ## Benefits - Stop manually exporting reports. You can instantly pull up a list of all wholesale orders using `list_orders` or check fulfillment status for any single transaction with `get_order`. This saves hours in manual data assembly. - Know exactly what you have on hand, always. Use `list_inventory` to get real-time stock counts across the entire catalog, and if sales spike, use `update_inventory` to adjust levels immediately from your chat agent. - Never waste time searching multiple tabs. Instead of navigating through categories, just ask your agent to run `search_catalog` for a keyword like 'ceramic vase' and get instant matching results. - Keep better track of who you sell to. By calling `get_customer`, you pull up specific retail client profiles and their full order history in one go—great for account reviews. - Maintain data integrity across teams. You can list all active webhooks using `list_webhooks` to ensure every third-party integration remains synchronized with your core product data. ## How It Works The bottom line is you manage wholesale inventory, orders, and product data without ever leaving your chat window. 1. Subscribe to this MCP and provide your Fieldfolio API Token from Settings > Integrations. 2. Connect your preferred AI client (like Claude or Cursor) to Vinkius, granting it access to the Fieldfolio tools. 3. Issue a natural language query through your agent; it translates that request into specific tool calls, retrieves the data, and presents an actionable summary. ## Frequently Asked Questions **How do I use get_product to find details?** You provide the product ID or SKU. The tool returns comprehensive metadata, including descriptions, dimensions, and pricing tiers for that specific item. **Can list_customers help me track sales?** Yes. After listing all customers with `list_customers`, you can then use the customer's ID to run `get_customer` and retrieve their full order history. **Does update_inventory require an API key?** Yes, it requires the authenticated Fieldfolio seller token. This ensures that any stock adjustments are tied directly back to your authorized account for auditing purposes. **What is the difference between list_products and search_catalog?** `list_products` gives you a raw enumeration of every item ID in the system. `search_catalog` lets you use natural language keywords to narrow that entire list down quickly. **If I use get_order with an invalid ID, what happens?** The tool will return a specific error message. Your AI client catches that failure and tells you exactly why the order could not be retrieved. This means you don't have to guess if the order number is wrong. **What information does list_webhooks provide?** It lists all webhooks configured on your account. You can use this tool to audit which third-party systems are currently synced and running, ensuring nothing critical falls out of sync. **Does list_products handle large catalogs efficiently?** Yes. The tool handles massive catalogs using pagination automatically. You won't hit hard limits; the MCP client fetches product data in manageable chunks so you always get everything you need. **What specific details can I expect from get_customer?** You get core customer profile information, including name, contact details, and their historical purchasing records. This lets your agent pull together a full picture for personalized communication. **How do I obtain my Fieldfolio API Token?** Log in to your Fieldfolio Seller account, go to **Settings > Integrations**, and click on **Generate API Key**. Note that you must be on a qualifying paid plan to see this option. **Which plans include API access?** API access is available on Fieldfolio's Startup, Business, and Enterprise plans. **Can I update stock levels via this integration?** Yes! The `update_inventory` tool allows you to set new stock quantities for specific products in your catalog flawlessy.