Jedi Collection Sort — MCP Server

Name: Jedi Collection Sort
Author: jediapps

The first Shopify collection-sort app with a native MCP server. Manage how products are ordered in your Shopify collections by chatting with Claude — or any MCP-capable client.

Jedi ‑ Collection Sort Pro automatically sorts products in Shopify collections: push down sold-out and out-of-stock items, surface bestsellers and new arrivals, AI multi-parameter sort, A/B testing, and analytics. This MCP server lets an AI assistant read and control that sorting for your store.

Things you can say once connected:

"Which of my collections haven't been sorted in the last week?"
"Assign the 'New arrivals first' strategy to the Summer collection and sort it now."
"Show me the layer configuration of my Default strategy."
"Turn off sorting on the Clearance collection."

Tools

Tool	What it does
`list_strategies`	List the store's sorting strategies (id, title, sort frequency, layer count)
`get_strategy`	Get one strategy including its full layer configuration
`list_collections`	List collections managed by Collection Sort, with strategy, sorting status, and last-sorted time (`active_only` filter)
`get_collection_config`	Get one collection's sorting config: assigned strategy with layers, status, and any pending sort job
`set_collection_sorting`	Assign a strategy to a collection and/or activate or deactivate sorting; changing the strategy of an active collection queues a re-sort
`sort_collection_now`	Queue an on-demand sort — idempotent, with a short cooldown after a completed sort
`list_sort_jobs`	List queued and processing sort jobs, newest first

All tools are bound to the authenticated shop; a connection can only ever see and manage its own store.

Requirements

Install Jedi ‑ Collection Sort Pro from the Shopify App Store.
A paid plan (from $2.99/month) — the MCP server and public API are included in every paid tier.

Connect from claude.ai / Claude Desktop (OAuth)

In the app, open Settings → Integrations and generate a connect code (one-time, expires in 10 minutes).
In claude.ai: Settings → Connectors → Add custom connector, paste https://api.collection-sort.jediapps.com/mcp.
Claude opens the consent page — enter your connect code to link your store.

The server is a full OAuth 2.1 authorization server (dynamic client registration, PKCE, refresh-token rotation), so any OAuth-capable MCP client works the same way.

Connect from Claude Code / header-capable clients (API key)

Generate an API key in Settings → Integrations (shown once, stored hashed), then:

bash

claude mcp add collection-sort --transport http https://api.collection-sort.jediapps.com/mcp \
  --header "Authorization: Bearer jcs_..."

Transport & security

Streamable HTTP transport, stateless — works with any MCP client that supports remote servers.
OAuth access and refresh tokens, API keys, and connect codes are stored hashed and are revocable from the app; everything is cleaned up on app uninstall.
Rate limited (60 requests/min per key) with idempotent sort triggering, so agent retry loops can't queue duplicate work.

REST API

The same operations are available as a REST API (https://api.collection-sort.jediapps.com/public-api/v1) with Bearer API-key auth — strategies, collections, sort triggering, and job status. See the documentation for endpoints and error codes.

Support

Docs & FAQ: jediapps.com/docs
App listing & support: apps.shopify.com/jedi-collection-sort

This repository documents the hosted MCP server operated by Jedi Apps as part of Jedi ‑ Collection Sort Pro. The server itself runs as part of the app's infrastructure — there is nothing to install from this repo.