An unofficial MCP server for the Shopier REST API v1. It lets Claude, or any other MCP client, read the orders, products, shipping, refunds and balance of your Shopier shop, and optionally update products, orders and discounts.
Tool descriptions and error messages are in Turkish, because Shopier's users are Turkish sellers. Tool names, parameters and enum values are in English.
Experimental (v0.1.4). Tested against a real Shopier shop on 2026-11-15: every read tool except the product ones, and creating products with create_product. On that account Shopier returned 403 for reading and updating products (see Observed Shopier behaviour). Start with the read-only tools.
The only official sources are this GitHub repository and the shopier-mcp package on npm. Packages with similar names are not this project.
This is an independent, unofficial open-source project. It is not affiliated with, endorsed by, or supported by Shopier. "Shopier" and related marks belong to their respective owner and are used here only to identify the API this software talks to.
The software is provided under the MIT license, "as is", without warranty of any kind. You are responsible for every action taken in your shop (orders, products, discounts, refunds, deletions).
- A PAT grants full access to your account. Do not share it, paste it into a chat, or commit it.
- The server runs on your own machine. Your PAT is never sent to the project author or any other server; it goes only to
api.shopier.com. If you overrideSHOPIER_API_BASE_URL, the PAT is sent to that host instead. - The PAT is stored in plain text in your MCP client configuration. Do not share those files, and do not use
claude mcp add --scope project, which writes the PAT to.mcp.jsonin the project folder. - Read tools return customer data (names, addresses, phone numbers, emails, order contents). That data goes to your MCP client and the AI provider behind it. How you handle your customers' personal data is your responsibility.
- Write tools are off by default. Set
SHOPIER_ALLOW_WRITES=trueonly when you need them. SHOPIER_ALLOW_DANGEROUS=trueenables refunds and permanent deletion. These may be irreversible. Enable it only for the session that needs it, and do not auto-approve tool calls in your client.- If you suspect the PAT has leaked, delete it under Account > Personal Access Token in Shopier and create a new one.
- Node.js 22+
- A Shopier Personal Access Token (PAT)
- Enable two-factor authentication (2FA) on your Shopier account under Account > Account Security. A PAT cannot be created while 2FA is off.
- Under Account > Personal Access Token, give it a name and click Generate.
- The token is shown only once; copy it right away.
Source: Creating and using PATs.
Nothing to install: your MCP client downloads and runs the server from npm with npx. The examples pin the version (@0.1.4); bump it by hand to upgrade.
claude mcp add shopier --scope user -e SHOPIER_PAT=YOUR_PAT -- npx -y shopier-mcp@0.1.4--scope user makes the server available in all projects (the default, local, applies only to the current folder). Add -e SHOPIER_ALLOW_WRITES=true to enable the write tools.
This command writes the PAT to your shell history. To avoid that, start the command with a space (if HIST_IGNORE_SPACE is set in zsh) or delete it from the history afterwards.
In claude_desktop_config.json:
{
"mcpServers": {
"shopier": {
"command": "npx",
"args": ["-y", "shopier-mcp@0.1.4"],
"env": {
"SHOPIER_PAT": "YOUR_PAT",
"SHOPIER_ALLOW_WRITES": "false"
}
}
}
}git clone https://github.com/karadoganyi/shopier-mcp.git
cd shopier-mcp
npm installnpm install also builds the project (dist/). In the examples above, replace npx -y shopier-mcp@0.1.4 with node /ABSOLUTE/PATH/shopier-mcp/dist/index.js.
| Variable | Default | Description |
|---|---|---|
SHOPIER_PAT |
— | Required. Sent as a Bearer token, never logged. |
SHOPIER_ALLOW_WRITES |
false |
Enables the product, order, shipping, category and discount write tools. |
SHOPIER_ALLOW_DANGEROUS |
false |
With writes enabled, also enables refunds (create_refund) and permanent deletion (delete_resource). |
SHOPIER_API_BASE_URL |
https://api.shopier.com/v1 |
For testing. Only https is accepted (http for localhost); a non-default host prints a warning to stderr. |
Flags accept true, 1, yes or on. Disabled tools are not registered at all, so the model cannot see them.
Read (always on, 17 tools)
list_orders, get_order, get_order_transaction, list_products, get_product, list_categories, list_variations, list_selections, list_refunds, list_shippings, get_balance, list_balance_transactions, list_payouts, list_payout_transactions, get_shop_info, list_discounts, list_webhooks
Write (SHOPIER_ALLOW_WRITES=true, +9 tools)
create_product, update_product, fulfill_order, update_order_shipping_address, create_shipping_code, create_category, create_discount_code, update_discount_code, create_automatic_discount
Dangerous (SHOPIER_ALLOW_DANGEROUS=true, +2 tools)
create_refund (refunds the buyer), delete_resource (permanently deletes a product, category, discount, shipping code or webhook)
Changing shop settings (which can close the shop) and creating webhooks (which send customer data to a URL) are deliberately left out.
- Date format:
yyyy-MM-ddTHH:mm:ss+0300. The real API also accepted+03:00andZ, but rejects a date without a time. Discount dates useyyyy-MM-dd+0300. - Without dates,
list_ordersreturns only the last 60 days. - List endpoints return at most 50 items per page. Shopier sends pagination data in response headers; the server adds it to every list response as a
paginationfield. - Prices are sent as strings (
"249.90"). - Product images must be publicly reachable URLs.
- The rate limit is 200 requests per minute. On a 429, the request is retried once automatically if
Retry-Afteris 10 seconds or less. - On a 5xx, only read requests are retried once. For write requests (refunds included), a timeout or 5xx is reported as "outcome unknown" and the model is asked to check the record before retrying, which prevents double refunds.
- Empty updates, empty or
..IDs, negative amounts and the spec's conditionally required fields (the note for digital deliveries, the amount or percentage for each discount type) are rejected locally before any request is sent. - Product titles longer than 80 characters or containing
&,<or>are rejected locally (see below).
Seen on a real shop on 2026-11-15. Shopier's documentation does not describe these, so they may change or differ per account.
- Product read and update can be blocked.
create_productworked, butlist_products,get_productandupdate_productreturned403 forbidden, even for a product just created. Categories, variations and selections, which use the sameproducts:readscope, worked. Shopier's docs say to contact hello@shopier.com about a 403. Until it is resolved, edit products in the Shopier panel, and send every field correctly on the firstcreate_product. - Titles:
&is stored as&and shown that way on the product page, and long titles are cut at about 90 characters. The server therefore rejects titles over 80 characters or containing&,<or>. - Descriptions: line breaks sent through the API are not shown; the description is displayed as one paragraph.
- Images: Shopier downloads the image URLs and stores them as JPEG on its own CDN, so the source URL only has to work once.
- Shipping:
shippingPayer: "sellerPays"withpriceData.shippingPriceabove 0 charges the buyer that fee in the basket. WithoutshippingPrice, the product page shows "Ücretsiz kargo" and the API stores"0.00". - Dispatch time:
dispatchDuration: 3is shown as "3 iş günü içinde kargoda" (dispatched within 3 business days).
npm testNeeds no network and no real PAT:
test/smoke.mjs: MCP handshake, tool counts per flag (17 / 26 / 28), and the error message when no PAT is set.test/mock.mjs: against a local mock API — query parameters and pagination headers; request bodies ofcreate_product,update_product,fulfill_order,create_discount_codeandcreate_refund; DELETE and ID encoding; local validation (checking that no request is sent); 403/404 error messages; the 429 and 5xx retry rules; and that a PAT with invalid characters never leaks into an error message.
Optional: npm run test:live calls the real api.shopier.com with a fake token and expects a clean 401.
The real-shop checks above were done by hand and are not part of npm test. The 30-second timeout path for write requests has no automated test.
MIT. See LICENSE.