# Peak PIM Developers > Peak PIM is a PIM (product information management) app for Shopify merchants running one or more stores. It keeps one canonical version of every product, variant, collection, and media file, plus one overridable version per store, and publishes changes back to Shopify. Developers can build on it two ways: a versioned REST API (scoped `pk_live_` bearer keys) and a remote MCP connector for AI assistants (OAuth 2.1 with consent tiers). Key facts: - REST API base URL: https://api.peak-pim.com, versioned under /api/v1, additive after the documented 2026-08-11 private-beta exception. Reads cover the catalog (products, variants, collections, media, stores) and the operations surface (markets, metafield/metaobject definitions, translations, sales channels, drops, data health). The first write endpoints are the data-health POSTs (scans, completeness-fills, divergence-reconciles — `pim:write`); unused-deletions (`pim:delete`) is documented but reserved. - Auth: `Authorization: Bearer pk_live_...` API key created in the Peak PIM app under Settings → API. Scopes: pim:read, pim:write, pim:publish, pim:webhooks. Every read endpoint needs pim:read. - Rate limits: 120 requests/minute per key, 240/minute per account; X-RateLimit-* headers on every response; 429 + Retry-After when over. - Errors: always `{"error": {"code", "message", "request_id"}}`. Branch on `code`: unauthorized, forbidden, forbidden_scope, not_found, validation_failed, pim_locked, rate_limited, conflict, internal_error. Sales-channel reads query Shopify live and are the only endpoints that can answer 502. - MCP connector URL: https://api.peak-pim.com/mcp (remote MCP, streamable HTTP, OAuth 2.1 with dynamic client registration + PKCE). 28 tools: 22 reads, 2 draft entity writes, 2 draft remediation batches, 1 data-health scan recompute, 1 live publish. Consent tiers: read / read_write / read_write_publish. - Data model: each entity has canonical values (inherited by every store) and per-store versions (overrides). MCP tool names call these "master" and "projection"; "channel" means a connected Shopify store. ## Documentation - [Introduction](https://developers.peak-pim.com/): What you can build; how the API and MCP surfaces relate. - [Core concepts](https://developers.peak-pim.com/docs/concepts): Canonical values, store versions, attributes, publish state, the operations layer. - [API or MCP?](https://developers.peak-pim.com/docs/choose-a-surface): Choosing between scoped API keys and a consented assistant connection. - [Sync your catalog](https://developers.peak-pim.com/docs/guides/sync-your-catalog): Full walk + incremental polling with updated_since and ETags. - [Audit drift across stores](https://developers.peak-pim.com/docs/guides/audit-store-drift): Compare canonical values against each store version. - [Monitor publishes](https://developers.peak-pim.com/docs/guides/monitor-publishes): Track pending_publish and last_publish_status. - [Metafields & metaobjects](https://developers.peak-pim.com/docs/guides/metafields-and-metaobjects): Read the definition schema layer. - [Translations & markets](https://developers.peak-pim.com/docs/guides/translations-and-markets): Locale/store-grouped translations; markets and catalogs. - [Scheduled drops](https://developers.peak-pim.com/docs/guides/drops): Scheduled field changes. - [Data health](https://developers.peak-pim.com/docs/guides/data-health): The scan → issues → remediation loop. - [Build an AI catalog operator](https://developers.peak-pim.com/docs/guides/ai-catalog-operator): Consent tiers, draft-then-publish, safety rails. ## REST API - [Overview](https://developers.peak-pim.com/api/): Base URL, endpoint families, data model, compatibility promise. - [Authentication](https://developers.peak-pim.com/api/authentication): Creating pk_live_ keys, scopes, security model, rotation. - [Quickstart](https://developers.peak-pim.com/api/quickstart): First calls with curl — ping, stores, products, store versions, polling. - [Pagination & filtering](https://developers.peak-pim.com/api/pagination): Cursors, bounded lists, updated_since, status, search, ETags. - [Errors](https://developers.peak-pim.com/api/errors): Error envelope, published codes, retry guidance. - [Rate limits](https://developers.peak-pim.com/api/rate-limits): Budgets, X-RateLimit headers, keeping syncs nearly free. - [Versioning](https://developers.peak-pim.com/api/versioning): The v1 compatibility promise, its documented private-beta exception, and the Deprecation/Sunset policy. - [Products](https://developers.peak-pim.com/api/products), [Variants](https://developers.peak-pim.com/api/variants), [Collections](https://developers.peak-pim.com/api/collections), [Media](https://developers.peak-pim.com/api/media), [Stores](https://developers.peak-pim.com/api/stores): Catalog resources with store versions. - [Markets](https://developers.peak-pim.com/api/markets), [Metafield definitions](https://developers.peak-pim.com/api/metafield-definitions), [Metaobject definitions](https://developers.peak-pim.com/api/metaobject-definitions), [Translations](https://developers.peak-pim.com/api/translations), [Sales channels](https://developers.peak-pim.com/api/sales-channels), [Drops](https://developers.peak-pim.com/api/drops), [Data health](https://developers.peak-pim.com/api/data-health): The operations surface. - [Endpoint index](https://developers.peak-pim.com/api/reference): Every path, method, and scope on one page. - [OpenAPI 3.1 spec](https://developers.peak-pim.com/api/openapi.yaml): The formal machine-readable API contract. ## MCP connector - [Overview](https://developers.peak-pim.com/mcp/): Connector URL, capabilities, consent tiers. - [Quickstart](https://developers.peak-pim.com/mcp/quickstart): Connect Claude, ChatGPT, Claude Code, Cursor, or any MCP client. - [Authorization & consent](https://developers.peak-pim.com/mcp/authorization): OAuth 2.1 flow, tiers, token lifetimes, revocation. - [Security & limits](https://developers.peak-pim.com/mcp/security): Tenancy, output clamps, timeouts, prompt-injection defenses. - [Tool index](https://developers.peak-pim.com/mcp/tools): All 28 tools with scopes. - [Entity reads](https://developers.peak-pim.com/mcp/tools/entity-reads), [Draft writes](https://developers.peak-pim.com/mcp/tools/writes), [Publish](https://developers.peak-pim.com/mcp/tools/publish): The 12 entity tools. - [Markets & definitions](https://developers.peak-pim.com/mcp/tools/markets-and-definitions), [Translations & sales channels](https://developers.peak-pim.com/mcp/tools/translations-and-sales-channels), [Drops](https://developers.peak-pim.com/mcp/tools/drops), [Data health](https://developers.peak-pim.com/mcp/tools/data-health): The 16 operations tools. ## Optional - [Changelog](https://developers.peak-pim.com/changelog): Every contract change, newest first. - [llms-full.txt](https://developers.peak-pim.com/llms-full.txt): The entire documentation as one plain-text file. - [Peak PIM marketing site](https://peak-pim.com): Product overview and pricing. - [Peak PIM app](https://app.peak-pim.com): Sign in to create API keys and manage MCP connections.