{"slug": "show-hn-agent-first-shopify-competitor", "title": "Show HN: Agent First Shopify Competitor?", "summary": "Mercemur launched a Shopify competitor built around agent-first commerce, offering 571 API operations across catalogue, orders, customers, pricing, and money, plus an MCP endpoint at https://mcp.mercemur.com/mcp and a CLI that pulls a storefront to disk for local editing. The REST API at https://api.mercemur.com/api/v1 enforces 136 scopes across 66 families, requires an Idempotency-Key on every write, and represents all money as integers in the currency's minor unit. The company positions the MCP endpoint so AI clients such as Claude Desktop, IDEs, and other agents can read and write a live storefront directly.", "body_md": "## Start here\n\n## API\n\n571 operations across catalogue, orders, customers, pricing, and money. Call it\nfrom any platform that can send an HTTP request.\n\n## MCP\n\nPoint an AI client, Claude Desktop, an IDE, another agent, at one endpoint and it\ncan read and write your live storefront.\n\n## CLI\n\nPull your storefront to disk, edit it in your own editor with live preview, and\npublish when you’re ready.\n\nREST API base URL for every request: \n\n`https://api.mercemur.com/api/v1` · MCP\nendpoint: `https://mcp.mercemur.com/mcp`\n## The REST API in detail\n\n## Quickstart\n\nCreate a key and make your first call in under five minutes.\n\n## API reference\n\nEvery endpoint, with a playground you can fire against your own store.\n\n## Rate limits\n\nUnderstand throttling and how to back off correctly.\n\n## Authentication and security\n\n## API keys\n\nSecret keys, how to create them, and how to rotate one safely.\n\n## Scopes\n\nRead, write and delete are separate grants. 136 scopes across 66 families.\n\n## Error handling\n\nOne envelope for every refusal, at every status.\n\n## Making requests\n\n## Idempotency\n\nEvery write takes an \n\n`Idempotency-Key`. Retry safely.\n## Pagination\n\nCursor paging, forward only, signed and bound to the route that issued it.\n\n## Money\n\nEvery amount is an integer in the currency’s minor unit.\n\n## The four things that are not guessable from one endpoint\n\nIf you read nothing else, read these. They are the conventions that a single example request will not teach you, and each one has bitten an integration.\n## Money is an integer in minor units, never a decimal\n\n`1999` in a `usd` field is 19.99 USD. There are no fractional amounts anywhere\nin this API, and no field accepts a decimal. Currencies with no minor unit,\nsuch as JPY, take the whole number directly. See [Money](/requests/money).\n\n## Read and write are separate grants\n\nRead and write are separate grants\n\n`write_products` does **not** let a key read your catalogue, and deleting is a third grant again:\n\n`write_products:delete`. A key that keeps records up to date\ncannot destroy them unless you tick Delete as well. See [Scopes](/authentication/scopes).\n\n## Every write requires an Idempotency-Key\n\nEvery write requires an Idempotency-Key\n\nNot optional, and not only for retries. A request without the header is refused\nwith \n\n`idempotency_key_required`. Replaying the same key returns the stored\nresponse rather than executing twice. See [Idempotency](/requests/idempotency).\n## Paging is by cursor, forward only\n\nPaging is by cursor, forward only\n\nThere is no \n\n`page` or `offset` parameter. You send `?after=` with the\n`page.next_cursor` from the previous response **for that same endpoint**. A cursor from a different collection is refused. See[Pagination](/requests/pagination).\n## Branch on `code`, never on `message`\n\nEvery refusal on this API, at every status, has the same body:\n`code` is the contract and is safe to switch on. The `message` is English prose\nfor a human reading a log, and its wording is not part of this contract. See\n[Error envelope](/errors/envelope).", "url": "https://wpnews.pro/news/show-hn-agent-first-shopify-competitor", "canonical_source": "https://docs.mercemur.com/", "published_at": "2026-09-11 13:57:51+00:00", "updated_at": "2026-09-11 14:15:57.382126+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Mercemur", "Shopify", "Claude Desktop"], "alternates": {"html": "https://wpnews.pro/news/show-hn-agent-first-shopify-competitor", "markdown": "https://wpnews.pro/news/show-hn-agent-first-shopify-competitor.md", "text": "https://wpnews.pro/news/show-hn-agent-first-shopify-competitor.txt", "jsonld": "https://wpnews.pro/news/show-hn-agent-first-shopify-competitor.jsonld"}}