MCP servers - Layers

Layers exposes two Model Context Protocol (MCP) servers that let AI assistants interact directly with your stores. Use them to manage merchandising, search tuning, catalog operations, and storefront queries through any MCP-compatible client.

Server	Endpoint	Auth	Purpose
Layers MCP server	`https://app.uselayers.com/mcp/v1`	OAuth (`mcp:use` scope)	Full store management — catalog, merchandising, search tuning, metrics, and more
Storefront MCP server	`https://app.uselayers.com/mcp/storefront/v1`	Storefront API token	Read-only storefront operations — search, browse, recommendations

Layers MCP server

The main MCP server exposes tools for managing your Layers stores. It uses OAuth authentication and requires the mcp:use scope.

Connecting

Configure your MCP client with the following endpoint:

https://app.uselayers.com/mcp/v1

When you connect for the first time, you’ll be redirected to the Layers dashboard to authorize the connection. After authorization, your MCP client stores the OAuth tokens and reconnects automatically.

Available tools

Store & catalog

Tool	Description
`store-list`	List all stores you have access to
`store-details`	Get detailed configuration for a store
`store-configuration`	Get or update core store configuration (search instructions, autocomplete prompt, sync preferences, search tuning, storefront options)
`store-access`	List and manage store members, pending invites, and shareable invite links
`store-integrations`	List the integration catalog, enable or disable integrations, and queue Global-E rate resyncs
`catalog-search`	Search products in the catalog
`catalog-product-get`	Get full details for a specific product
`collections-list`	List collections with filtering
`collections-get`	Get details for a specific collection

Store operations & recovery

Tool	Description
`store-operational-status`	Get permission failures, sync blockers, recent tasks, and protected collection deletion events for a store
`store-clear-permission-failure`	Clear one recorded Shopify permission failure, or clear all when `clear_all` is true
`store-clear-operational-block`	Clear a specific operational block (for example OAuth access blocked or analytics catalog unavailable)
`store-dispatch-sync-operation`	Dispatch a Shopify sync operation (collections, metafield definitions, resource limits, locations, market pricing)
`store-list-collection-deletion-events`	List pending and recently resolved protected collection deletion events
`store-resolve-collection-deletion-event`	Approve or deny a pending protected collection deletion event

Tool	Description
`search-semantic`	Run a semantic text search
`search-browse`	Browse a collection with merchandising applied
`search-autocomplete`	Get predictive search suggestions

Attributes

Tool	Description
`attributes-list`	List all product attributes
`attributes-values`	Get values for a specific attribute
`attributes-manage`	Create, update, or delete attributes, and update or clear calculated-attribute drafts (`draft_update`, `draft_clear`)
`attributes-calculated-recipes`	List pre-built computed attribute templates
`attributes-generate-facet-sort`	Generate AI-powered facet value ordering

Search tuning

Tool	Description
`search-rules-list`	List search rules
`search-rules-manage`	Create, update, or delete search rules
`semantic-redirects-list`	List semantic redirects
`semantic-redirects-manage`	Create, update, or delete semantic redirects
`ranking-rules-list`	List ranking rules
`ranking-rules-manage`	Create, update, or delete ranking rules
`query-expansion-examples-list`	List query expansion examples
`query-expansion-examples-manage`	Create, update, or delete query expansion examples

Merchandising

Tool	Description
`merchandise-rules-list`	List merchandising rules
`merchandise-rules-manage`	Create, update, or delete merchandising rules with pins, expressions, and scheduling. Also supports `bulk_enable`, `bulk_disable`, and `bulk_delete`
`blocks-list`	List recommendation blocks
`blocks-manage`	Create, update, or delete blocks with strategies, safeguards, and fallback chains. Also supports `bulk_publish`, `bulk_unpublish`, `bulk_duplicate`, and `bulk_delete`
`block-strategies-list`	List block data strategies and their computation status

Sort orders

Tool	Description
`sort-orders-list`	List available sort orders
`sort-orders-preview`	Preview product ranking for a sort order

Products

Tool	Description
`product-families`	List, inspect, create, update, publish/unpublish, or delete manual product families
`product-sequences`	List, inspect, create, update, publish/unpublish, or delete ordered product sequence groups
`variant-breakouts`	List, inspect, create, update, enable, disable, or delete option-based variant breakout rules

Metrics & analytics

Tool	Description
`metrics-list`	List custom metrics
`metrics-manage`	Create, update, or delete metrics
`metrics-results`	Get computed results for a metric
`metrics-validate-query`	Validate a LayersQL expression
`analytics-dashboards`	List, inspect, create, update, or delete analytics dashboards, and discover visualizable metric blocks

Documentation

Tool	Description
`docs-search`	Search the Layers documentation

Usage pattern

List your stores

Call store-list to see all stores you have access to. Note the store slug for each store you want to work with.

Pass the store slug

Include the store slug in all subsequent tool calls. For example, if your store is my-store.myshopify.com, the slug is my-store.

Use manage tools to make changes

Tools ending in -manage accept an action parameter — typically create, update, or delete, plus tool-specific actions such as bulk variants. All other tools are read-only and safe to call freely.

Example: create a merchandising rule

Ask your AI assistant:

“Pin the product ‘Classic White Tee’ to position 1 in the Summer Sale collection, and boost all products where brand is ‘Nike’ using a soft boost expression.”

The assistant calls merchandise-rules-manage with action: "create" and the appropriate parameters — handling pin positions, collection targeting, and expression configuration automatically.

Bulk actions

Several -manage tools accept bulk variants so an assistant can apply the same change to many records in one call:

blocks-manage — bulk_publish, bulk_unpublish, bulk_duplicate, bulk_delete (pass block_ids)
merchandise-rules-manage — bulk_enable, bulk_disable, bulk_delete (pass rule_ids)

Use bulk actions to act on many records at once — for example, unpublishing all draft blocks after a seasonal campaign, or disabling a batch of merchandising rules outside their window.

{
  "store": "my-store",
  "action": "bulk_unpublish",
  "block_ids": ["blk_123", "blk_456", "blk_789"]
}

The response includes an affected_count so the assistant can confirm how many records changed.

MCP audit log

Every write action your assistant performs through the Layers MCP server is recorded in an audit log. Each entry captures the tool, action, user, store, timestamp, and a JSON context payload. Review activity in the dashboard:

Store activity — Configure → Access → MCP Audit Log shows every MCP action recorded for a single store.
Your activity — Profile → MCP Audit Log shows every MCP action recorded for your account across all stores.

Filter by event, action, or free-text search, and open any entry to inspect its full context.

Storefront MCP server

The Storefront MCP server exposes read-only storefront operations as MCP tools. It uses the same access token as the Storefront REST API, so you can integrate AI assistants into customer-facing experiences.

Connecting

Configure your MCP client with the storefront endpoint and your API token:

https://app.uselayers.com/mcp/storefront/v1

Authentication uses the same storefront access token you use for the REST API. Pass it as a bearer token in the authorization header.

Available tools

Tool	Description
`search-text`	Semantic text search with query understanding and typo tolerance
`browse-collection`	Browse a collection with sort orders, merchandising, and faceted filtering
`search-similar`	Find visually and semantically similar products
`search-autocomplete`	Get predictive search query suggestions
`facets-get`	Retrieve available filter facets for a collection
`sort-orders-list`	List available sort orders
`blocks-recommendations`	Get product recommendations from a configured block
`search-content`	Search non-product content (pages, articles, blogs)

Common parameters

Most search and browse tools accept these optional parameters:

Parameter	Description
`filter_group`	Nested filter conditions (AND/OR with operators like `eq`, `in`, `gt`, `lt`, `between`, and the geo operators `geoRadius`, `geoPolygon`, `geoBoundingBox` — see Geospatial filtering)
`facets`	Array of attribute codes to retrieve facet values for
`pagination`	`{ page, limit }` for paginated results
`sort_order_code`	Sort order to apply (use `sort-orders-list` to see available codes)
`attributes`	Array of attribute codes to include in the response
`context`	Contextual data for personalization (geo, customer, cart, marketing channel)
`identity`	Session, customer, and device identifiers for behavioral tracking

When to use each server

Use the Layers MCP server when you want an AI assistant to help manage your store — creating merchandising rules, tuning search behavior, building sort orders, or analyzing metrics.
Use the Storefront MCP server when you want to integrate AI-powered product discovery into a customer-facing experience. It’s also useful when building AI agents that need to search and browse your catalog.

Next steps

Manage API access to create storefront tokens
Learn about search rules and merchandising to understand what you can configure through MCP
Explore the API reference for the underlying REST endpoints

​Layers MCP server

​Connecting

​Available tools

​Usage pattern

​Example: create a merchandising rule

​Bulk actions

​MCP audit log

​Storefront MCP server

​Connecting

​Available tools

​Common parameters

​When to use each server

​Next steps

Layers MCP server

Connecting

Available tools

Usage pattern

Example: create a merchandising rule

Bulk actions

MCP audit log

Storefront MCP server

Connecting

Available tools

Common parameters

When to use each server

Next steps