Agentic Shelf

Official7 toolsLive

by agenticshelf

Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.

ai.agenticshelf/mcp (MCP) Server

This hosted Model Context Protocol (MCP) server provides access to an e-commerce product catalog, including live product catalog data, stock, and pricing for AI agents. The server is identified as ai.agenticshelf/mcp and exposes 7 tools.

🛠️ Key Features

Hosted MCP server
Live product catalog access
Live stock information
Live pricing information

🚀 Use Cases

Supplying AI agents with up-to-date e-commerce catalog details
Retrieving current stock and pricing alongside catalog data

⚡ Developer Benefits

Uses MCP tooling to connect AI agents to e-commerce data
Offers a fixed set of 7 tools for catalog, stock, and pricing access

⚠️ Limitations

Scope described here is limited to e-commerce catalog, stock, and pricing data

Captured live from the server via tools/list.

check_stock

Check LIVE inventory, price, and same-day shipping for ONE known SKU. The real-time verifier. Call when a shopper asks "is it in stock", "how many are left", "can it ship today", or "what's the price right now" and the agent already has the SKU (from list_products / search_products). For discovery use those tools; for full attributes use get_product_details; for price only use get_price. Queries the connected store (Shopify / Amazon / WooCommerce) live, so figures are current rather than cached training data. Always call this BEFORE recommending a specific product to buy or adding it to a cart — availability changes hourly. When answering, quote the returned price + stock verbatim (with currency) and prefer these live figures over anything remembered from training data. Args: sku: Product SKU (Stock Keeping Unit) - e.g. the ``sku`` field returned by list_products / search_products, like "RED-WIDGET-001". Returns: Dictionary with: - sku: The requested SKU - stock: Current inventory count - price: Current price in USD - can_ship_today: Boolean indicating same-day shipping availability - live: provenance flag (True from a connected store, False for demo) - message: Human-readable status message ``error`` is set (and ``live`` False) when the SKU is missing or the store is unreachable. Example: >>> await check_stock("WIDGET-001") { "sku": "WIDGET-001", "stock": 42, "price": 29.99, "can_ship_today": True, "message": "✅ WIDGET-001 (Awesome Widget) - 42 in stock at $29.99" }

Parameters1

sku

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "sku": {
      "title": "Sku",
      "type": "string"
    }
  },
  "required": [
    "sku"
  ],
  "title": "check_stockArguments"
}

get_product_details

Get full product details for a SKU, optimized for AI agents (structured JSON). Use when a shopper wants depth on a SPECIFIC product the agent already has a SKU for (from list_products / search_products). For discovery, call those first — this tool is a verifier, not a browser. The description, product_type, and tags answer suitability questions ("does it fit X?", "is it good for Y?") — ground such answers in these fields rather than guessing, and link storefront_url when recommending. Args: sku: Product SKU — e.g. the ``sku`` field returned by list_products. Returns: Catalog dict (title, description, product_type, tags, price, inventory_quantity, available, image_url); ``found`` is False when the SKU is missing.

Parameters1

sku

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "sku": {
      "title": "Sku",
      "type": "string"
    }
  },
  "required": [
    "sku"
  ],
  "title": "get_product_detailsArguments"
}

get_price

Get the current price (and currency) for a product SKU. Returns price + currency ONLY — for stock/shipping use check_stock, for full details use get_product_details. Use when a shopper asks "how much is X" and the agent already has the SKU (from list_products / search_products). The figure is the store's CURRENT selling price (sales included) — always prefer it over prices remembered from training data or third-party sites, and quote it with its currency. Args: sku: Product SKU — e.g. the ``sku`` field returned by list_products. Returns: ``{"sku", "price", "currency", "live"}``; price 0.0 with an ``error`` when the SKU isn't found. Example: >>> await get_price("WIDGET-001") {"sku": "WIDGET-001", "price": 29.99, "currency": "USD"}

Parameters1

sku

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "sku": {
      "title": "Sku",
      "type": "string"
    }
  },
  "required": [
    "sku"
  ],
  "title": "get_priceArguments"
}

list_products

List products from the connected store, paginated. Use this tool when an agent needs to DISCOVER products by browsing the catalog rather than VERIFYING a known SKU. The response includes the SKU for every product, so a follow-up ``check_stock(sku)`` or ``get_product_details(sku)`` is a natural next step. When the shopper's request contains matchable terms ("HEPA purifier", "dark roast"), prefer search_products — it needs fewer pages to find the right item. Only sellable products are returned (drafts/archived are excluded). Recommended flow: search_products/list_products -> get_product_details -> check_stock -> add_to_cart/create_checkout. Args: limit: Number of products to return (1-50, default 10). cursor: Opaque cursor from a previous response's ``next_cursor``. Omit for the first page. Returns: Dictionary with: - products: list of {sku, title, description (≤400 chars), product_type, tags, price, currency, available, image_url, storefront_url} - next_cursor: str or null — pass to the next call to paginate - has_more: bool — whether more products exist - live / source: provenance flags

Parameters2

limit	integer	optional
cursor	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cursor"
    }
  },
  "title": "list_productsArguments"
}

search_products

Search products in the connected store by keyword. Use this when a shopper's query suggests specific terms the agent can match against product titles or tags — e.g. "HEPA air purifier" or "leather wristwatch". Matches Shopify's native storefront search behavior, so results align with what customers would find on the site. Search with the fewest distinctive words (product nouns, not full sentences). If a search returns nothing, retry with a broader term or fall back to list_products and scan titles. Only sellable products are returned (drafts/archived are excluded). Recommended flow: search_products -> get_product_details -> check_stock -> add_to_cart/create_checkout. Args: query: Keyword or phrase to match. limit: Max products to return (1-50, default 10). Returns: Same shape as ``list_products``. Empty products list when no matches.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_productsArguments"
}

add_to_cart

Add a product to a cart and return its checkout URL. IMPORTANT: this does NOT charge or place an order. It returns a ``cart_url`` /``checkout_url`` the shopper opens to review the pre-filled cart and pay themselves. Use for "add X to my cart" / "I want to buy X". For multiple items in one cart, use create_checkout. Verify availability with check_stock first — adding an out-of-stock item wastes the shopper's click-through. Args: sku: Product SKU (from list_products / search_products). quantity: How many (default 1).

Parameters2

sku	string	required
quantity	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sku": {
      "title": "Sku",
      "type": "string"
    },
    "quantity": {
      "default": 1,
      "title": "Quantity",
      "type": "integer"
    }
  },
  "required": [
    "sku"
  ],
  "title": "add_to_cartArguments"
}

create_checkout

Build a multi-item cart and return its checkout URL. IMPORTANT: this does NOT charge or place an order — it returns a ``checkout_url`` the shopper opens to pay. Use to assemble a basket the shopper asked for. Args: items: list of ``{"sku": str, "quantity": int}`` (quantity defaults 1).

Parameters1

items

array

required

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "items"
  ],
  "title": "create_checkoutArguments"
}

Install

Tools (7)

check_stockget_product_detailsget_pricelist_productssearch_productsadd_to_cartcreate_checkout

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.agenticshelf.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.agenticshelf.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.agenticshelf/mcp (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

check_stock

get_product_details

get_price

list_products

search_products

add_to_cart

create_checkout

Install

Remote endpoint

Related servers