# Spocket MCP > Spocket connects your entire dropshipping operation directly into your AI agent. Use this server to browse the full product catalog, check real-time stock levels with `get_inventory`, retrieve specific product details via `get_product`, place new customer orders using `create_order`, and track existing order status with `get_order`. Manage everything without leaving your chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** dropshipping, product-catalog, order-fulfillment, inventory-tracking, retail ## Description Your AI agent connects straight into your entire dropshipping operation using this server. You'll manage everything—from product research to final order tracking—without ever leaving your chat window. It’s built for people who gotta run a storefront and don't have time to switch between apps. **List Catalog Products:** If you need to browse what’s available, you can use `list_products`. This tool pulls the full product lineup from Spocket, letting you paginate through pages of items. You can filter these results by specific categories too; that helps narrow down your search fast. When you run this command, your agent returns a list of products, giving you enough initial data to see what’s selling. **Get Product Details:** Need the deep dive on one item? Use `get_product`. This tool takes a unique product ID and pulls every piece of metadata associated with that single Spocket listing. You'll get all the specifics—descriptions, specifications, pricing details—for one focused look at what you’re selling. **Check Real-Time Stock:** Before you commit to anything, you gotta know if it's actually in stock. `get_inventory` lets you check the current available count for any specific product ID or variant. It gives you a definitive number on how much inventory is sitting there right now. This is critical because it tells you exactly what you can sell before placing an order. **Place New Orders:** When a customer buys something, `create_order` handles the submission immediately into your Spocket account. You feed the tool the necessary customer details and product information, and it sends the new purchase request directly through. This action gets the sales processed instantly within your workflow. **Track Order Status:** After you place an order, tracking it is key. `get_order` lets you pull up a unique order ID's full history and current fulfillment status. You’ll get details on where that shipment is, who handled it, and what the next steps are for getting it to the customer. It gives you the whole picture of an existing sale. This server links all these operations together: First, you use `list_products` or `get_product` to find exactly what you want to sell; then, before accepting a purchase, you run `get_inventory` to verify stock levels. Once verified, the agent uses that information to process the sale via `create_order`. Finally, if you need an update on that completed transaction, running `get_order` gives you the full tracking history. You manage the whole cycle—discovery, verification, sales, and fulfillment status—all through simple commands sent to your AI client. ## Tools ### create_order Submits a new customer order request into your Spocket account. ### get_inventory Checks the current, available stock quantity for any specific product ID. ### get_order Retrieves the full status and details history of an existing order using its unique ID. ### get_product Fetches all detailed information for a single, specified Spocket product. ### list_products Lists products from the entire catalog and allows filtering by category or page number. ## Prompt Examples **Prompt:** ``` List all products in the 'Electronics' category from Spocket. ``` **Response:** ``` I've found several products in the Electronics category. Here are the top items: 'Wireless Earbuds' (ID: sp_789) and 'Smart Watch' (ID: sp_456). Would you like more details on any of these? ``` **Prompt:** ``` Check the inventory level for product ID sp_123. ``` **Response:** ``` The current inventory for product sp_123 is 45 units. It is currently in stock and available for ordering. ``` **Prompt:** ``` Create an order for John Doe at 123 Main St, New York, NY 10001, US for product sp_456 with quantity 1. ``` **Response:** ``` Order successfully created! The Order ID is ord_556677. You can track its status using this ID. ``` ## Capabilities ### List Catalog Products Fetch all available products from Spocket, supporting pagination and filtering by category. ### Get Product Details Retrieve full metadata for one specific product using its unique ID. ### Check Real-Time Stock Verify the current, available stock count for a specified Spocket product or variant. ### Place New Orders Submit and create a new customer order directly into your Spocket account. ### Track Order Status Get the current fulfillment status and history for an existing order ID. ## Use Cases ### Client Inquiry on Availability A client asks about 'Wireless Earbuds.' Your agent uses `get_product` first to confirm the model details, then runs `get_inventory`. You instantly reply with the product specs and confirmed stock count. Problem solved in three steps. ### Placing a Bulk Replenishment Order You notice several items are running low. Your agent first uses `list_products` to gather all 'Electronics' SKUs, then checks the inventory for each one using `get_inventory`. Finally, you confirm and run `create_order` for everything needed. ### Tracking a Missing Shipment A customer complains their order is late. Your agent takes the Order ID and calls `get_order`. It reports the last status update (e.g., 'Shipped via USPS') and confirms the tracking number, letting you respond with facts immediately. ### Product Line Research You're brainstorming a new line of goods. You ask your agent to `list_products` filtered by 'Kitchen'. The agent returns paginated results, allowing you to quickly see if the catalog has enough variety to support a new campaign. ## Benefits - Checks Stock Instantly: Use `get_inventory` to confirm real-time stock levels in seconds. This stops you from placing an order for something that just sold out. - Builds Orders Seamlessly: The agent handles the sequence of checks and calls `create_order` when you're ready, reducing manual input errors significantly. - Deep Catalog Access: Don’t just see names. Use `get_product` to fetch deep metadata for a product, letting your AI client make better decisions on sourcing or pricing. - Tracks Fulfillment Status: Need to know if that order shipped? Just call `get_order`. You get the status history without logging into the Spocket dashboard. - Finds Products Fast: Instead of scrolling through hundreds of SKUs, use `list_products` and category filters to narrow down your search immediately. ## How It Works The bottom line is: you use natural language to control complex e-commerce backend actions. 1. Subscribe to this server and enter your Spocket API Key. 2. Tell your AI agent what you need (e.g., 'List all electronics products'). 3. The agent selects the right tool (`list_products` or `get_inventory`), executes it, and returns the actionable data. ## Frequently Asked Questions **How do I check if a product is available before ordering using get_inventory?** Run `get_inventory` and provide the exact Product ID. The tool returns the current stock count for that item, confirming availability in real-time so you don't risk overselling. **Can I list all products using list_products?** Yes. `list_products` pulls the entire catalog, and it supports filtering by category or page number if you have a huge inventory to browse through. **What is the difference between get_product and list_products?** `list_products` gives you a searchable overview of many items. `get_product` drills down, giving you every piece of metadata for one specific item only. **Does create_order handle shipping details automatically?** You must provide the full customer and product details when calling `create_order`. The tool processes those inputs to finalize the order submission in Spocket. **What happens if I need to filter products when using `list_products`?** The tool accepts category or keyword filters directly in the request body. This lets you narrow down results immediately, saving time versus manually checking every item returned through pagination. **How do I check an order's history using `get_order`?** The tool returns a detailed status log for the given Order ID. This includes timestamps and specific changes, helping you track fulfillment steps from creation to shipping confirmation. **If I run `create_order` and it fails, how do I troubleshoot the issue?** The API response provides a distinct error code and message. This tells you immediately if the failure was due to payment issues, invalid product IDs, or insufficient stock. **What is the process for retrieving all available metadata using `get_product`?** The tool provides a full data payload for one item. You get details like descriptions, dimensions, and variant options in a single call, perfect for building structured product listings. **Can I check the current stock level for a specific product?** Yes! Use the `get_inventory` tool with the product ID. The agent will return the real-time stock levels for that item or its variants. **How do I track the status of a customer's order?** Simply provide the Order ID to the `get_order` tool. Your AI agent will retrieve the current fulfillment status and order details from Spocket. **Can I filter products by a specific category?** Yes, the `list_products` tool allows you to pass a `category` parameter to narrow down the results to only the items you are interested in.