> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use alongside Shop

> Add Channel3's catalog to an agent built on Shop MCP by changing one URL.

If your agent already calls [Shop MCP](https://shop.dev/docs), it can search Channel3 too. Our catalog uses the same tool names, the same `catalog` arguments, and the same UCP response shape, so the client code you already have works against both.

## The one-line change

Send the same request you send to Shop, with the same headers and body, to a different URL:

```js theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await fetch("https://ucp.trychannel3.com/mcp", {
  // was https://mcp.shop.com/
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json, text/event-stream",
    "MCP-Protocol-Version": "2026-07-28",
    "Mcp-Method": "tools/call",
    "Mcp-Name": "search_catalog",
    "x-api-key": process.env.CHANNEL3_API_KEY, // optional
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "tools/call",
    params: {
      name: "search_catalog",
      arguments: {
        catalog: { query: "rain jacket", pagination: { limit: 10 } },
      },
      _meta: {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": {
          name: "my-app",
          version: "1.0.0",
        },
        "io.modelcontextprotocol/clientCapabilities": {},
      },
    },
  }),
});
const { result } = await response.json();
const products = result.structuredContent.products;
```

`search_catalog`, `lookup_catalog`, and `get_product` take the same `catalog` arguments as on Shop. Responses follow UCP `2026-08-25`: money in minor units, `pagination.cursor`, `messages[]`, and `variants[].seller`. MCP hosts such as Claude, ChatGPT, and Claude Code connect with the URL alone.

> [!WARNING]
>
> Don't send your Shop access token to Channel3. Use a [Channel3 API
> key](/docs/ucp/authentication.md) in `x-api-key` for Token-tier limits and buy links
> that credit your account. With no key, calls run on the Anonymous tier.

## Run both side by side

Send each search to both URLs and merge the results. Remember which server each product came from:

* Products from Shop go on to Shop's cart and checkout tools as usual.
* Products from Channel3 have no cart or checkout tools. Send the buyer to `variants[].url`, which opens the store's product page.

Product and variant IDs belong to the server that returned them. Don't pass a Channel3 ID to Shop, or a `gid://shopify/...` ID to Channel3.

## What's different

| | Shop MCP | Channel3 |
| - | - | - |
| Stores | Shopify stores | Stores on any platform |
| `pagination.limit` | 1–50, default 10 | 1–30, default 10. Larger values are lowered to 30 with a `pagination_limit_clamped` message |
| `pagination.total_count` | Returned | Not returned |
| `lookup_catalog` ids | Product or variant ID, URL, GTIN, UPC | Channel3 product or variant ID, or product page URL |

## Filters and context

| Field | Channel3 |
| - | - |
| `filters.price`, `filters.condition`, `filters.available` | Supported, same meaning. `price` is in minor units of `context.currency` |
| `filters.shops` | Supported. `seller.id`, store domains (`nike.com`), or Channel3 website IDs |
| `filters.categories` | Supported. Shopify taxonomy IDs (`aa-8-1` or `gid://shopify/TaxonomyCategory/aa-8-1`) or Channel3 [category](/docs/categories.md) slugs |
| `filters.attributes` | Supported. `Size`, `Color`, `Target gender`, and any other Shopify taxonomy attribute by name (`Material`, `Neckline`, ...). Values match exactly or by alias (`Grey` → `Gray`) |
| `ships_to`, `ships_from`, `price_tier`, `rating` | Not applied |
| `context.address_country`, `currency`, `language` | Supported for the markets Channel3 serves. Other values fall back to the default |
| `like` (one or two product IDs or images) | Supported |
| `get_product` `selected`, `preferences` | Supported |

Anything Channel3 can't apply, such as an unsupported filter or attribute value, an unserved market, or a third `like` entry, comes back as a `warning` in `messages[]` with the `path` of the input. Results are never narrowed by a filter that wasn't applied.

Channel3 adds fields of its own, such as `website_ids` and `brand_ids` filters and commission `placement` data. See the [Extension reference](/docs/ucp/catalog-global-extension.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.