Use case · Store Catalog

Search a store's products by keyword, from an agent

Find products in one Shopify or WooCommerce store by keyword through the store's own public search, with prices, availability and the product URL.

The job

When the question is about one product rather than the whole catalog (does this store sell a wool runner, what does it charge, is it in stock) reading every product is wasteful. The store's own search already knows the answer.

Why an agent needs a tool for it

search_products sends the keyword to the store's public search and returns the matches in the same compact rows as list_products. The agent then calls get_product on the one it wants for variants and barcodes.

The calls

2 tool calls.

Live production call2026-10-01

Agent calls search_products

{
  "name": "search_products",
  "arguments": {
    "store_url": "https://www.allbirds.com",
    "query": "wool runner",
    "limit": 3
  }
}

Store Catalog answers

{
  "platform": "shopify",
  "store_url": "https://www.allbirds.com",
  "query": "wool runner",
  "products": [
    {
      "id": "1878275686469",
      "handle": "womens-wool-runners-natural-black",
      "title": "Women's Wool Runner - Natural Black (Black Sole)",
      "url": "https://www.allbirds.com/products/womens-wool-runners-natural-black",
      "vendor": "Allbirds",
      "product_type": "Shoes",
      "price": 110,
      "currency": "USD",
      "available": true,
      "image": "https://cdn.shopify.com/s/files/1/1104/4168/files/Allbirds_WL_RN_SF_PDP_Natural_Black_LAT.png?v=1751143102"
    },
    {
      "id": "7221394931792",
      "handle": "mens-wool-runner-nz-weathered-brown",
      "title": "Men's Wool Runner NZ - Weathered Brown (Weathered Brown Sole)",
      "url": "https://www.allbirds.com/products/mens-wool-runner-nz-weathered-brown",
      "vendor": "Allbirds",
      "product_type": "Shoes",
      "price": 110,
      "currency": "USD",
      "available": false,
      "image": "https://cdn.shopify.com/s/files/1/1104/4168/files/A12074_25Q4_Wool-Runner-NZ-Weathered-Brown-Weathered-Brown-Sole_PDP_LEFT.png?v=1758326551"
    }
  ]
}

handle is what get_product takes next, with the store URL, to read the variants. Shortened for this page: products shortened from 3 to 2.

Live production call2026-10-01

Agent calls search_products

{
  "name": "search_products",
  "arguments": {
    "store_url": "https://porterandyork.com",
    "query": "steak",
    "limit": 3
  }
}

Store Catalog answers

{
  "platform": "woocommerce",
  "store_url": "https://porterandyork.com",
  "query": "steak",
  "products": [
    {
      "id": "20885",
      "handle": "buy-flank-steak",
      "title": "Flank Steak",
      "url": "https://porterandyork.com/product/buy-flank-steak/",
      "categories": [
        "Beef",
        "Steaks"
      ],
      "price": 39,
      "currency": "USD",
      "available": true,
      "variant_count": 1,
      "image": "https://porterandyork.com/wp-content/uploads/Flank-Steak-e1527714926453.jpg"
    }
  ]
}

The same tool on a WooCommerce store, through its Store API search. Shortened for this page: products shortened from 3 to 1.

Limits worth knowing

Shopify's public search returns at most 10 results, WooCommerce up to 20. For more, page through list_products.
Relevance is the store's own. Two stores can rank the same keyword differently.

Pricing

2 credits for the calls on this page.

Tool	Credits per call
search_products	1

Credits are prepaid and shared across every server. Starter is $10 for 1,000 credits, packs never expire, and 100 credits are free without a card. Full pricing.

Prefer to run it without an MCP client? Store Catalog is also an Apify Actor, billed by Apify at $1.50 per 1,000 products, $0.005 per change detected.

Install

Connect Store Catalog to your agent.

A remote MCP server over Streamable HTTP. Get a free key, swap it in, and the calls above work as written, with answers reflecting the data on the day you call.

EndpointStreamable HTTP

https://storecatalog.agenttoolworks.com/mcp

Connect it, Claude Code

claude mcp add --transport http storecatalog \
  https://storecatalog.agenttoolworks.com/mcp \
  --header "Authorization: Bearer atw_live_your_key"

Setup for Claude Desktop, Cursor and Windsurf is in the docs.