Getting started
Peak PIM MCP connector
A remote Model Context Protocol server that lets AI assistants work on your catalog: browse products, compare stores, audit data health, draft edits, and — if you allow it — publish to Shopify. You authorize each connection in your browser and choose exactly how much it can do.
At a glance
| Connector URL | https://api.peak-pim.com/mcp |
|---|---|
| Transport | Remote MCP (streamable HTTP) |
| Authentication | OAuth 2.1 — dynamic client registration, PKCE, refresh tokens. No API key to copy around. See Authorization & consent. |
| Permissions | Three consent tiers: read · read & write · read, write & publish |
| Works with | Claude (web/desktop connectors, Claude Code), ChatGPT (developer mode), Cursor, and any MCP client that supports remote servers with OAuth |
| Tools | 118 tools — 75 reads, 32 write-tier tools, 11 publish-tier |
What an assistant can do with it
- "List my products and show me which ones have unpublished changes."
- "Show me product Trail Runner 2 on each of my stores — where do the titles or prices differ?"
- "Which markets sell in EUR, and through which catalogs?"
- "What is scheduled to change on this product, and when?" (Drops)
- "Run a completeness scan and fill the missing SEO titles as drafts." (write tier)
- "Publish product X to all my stores and tell me exactly what succeeded and what failed." (publish tier)
118 tools, three scopes
The catalog has 118 versioned (_v1) tools for catalog reads,
definitions, relationships, activity, publish monitoring, creation, collection
sources, media, translations, bulk editing, and checkout discounts. By required scope:
| Scope | Tools | What they touch |
|---|---|---|
read pim:read | 75 | Browse, compare, export, and monitor. Some reads query Shopify live, including collection membership and sales channels. |
write pim:write | 32 | Create and edit drafts, recompute scans, manage collection sources, upload and attach media. Duplication and adding product options can also publish as part of their workflow. |
publish pim:publish | 11 | Single and batch publish, cancel a publish operation, media replacement, translation copy with publication, and the discount commands (turn on or off, replace, remove from stores). |
No tool deletes catalog data, and a delete permission is not grantable at all.
The one exception is publish-tier: delete_discount_v1
removes store discounts from Shopify after an explicit confirmation.
Consent tiers
Adding the connector opens a browser consent page on the Peak PIM app. The consent screen shows who is asking and offers up to three permission tiers. You pick one (or deny):
| Tier | Scopes granted | Allows |
|---|---|---|
| Read | pim:read | Browse and compare the catalog. Nothing can be changed. |
| Read & write | pim:read pim:write | Create and edit drafts, run scans, and manage relationships. Two creation workflows also reach Shopify: duplication publishes the copy, and adding a product option republishes existing store versions. |
| Read, write & publish | pim:read pim:write pim:publish | Also push items live to your Shopify stores. |
The pim:publish scope can only be granted through this consent screen — never through any other credential surface. A tool outside the granted tier fails with a clear permission error and re-authorization guidance. Full details in Authorization & consent.
Where to go next
Quickstart
Connect Claude, Claude Code, ChatGPT, Cursor, or any OAuth-capable MCP client, and verify with a first prompt.
Getting startedAuthorization & consent
The OAuth 2.1 flow, discovery endpoints, the three tiers, token lifetimes, and how to revoke a connection.
Getting startedSecurity & limits
Tenancy from the token, minimized data-only results, and the operational limits every tool call runs under.
ReferenceTool index
All 118 tools with their scopes, one-line behavior, and links to the per-group detail pages.