Portage Store
Search a Shopify store's catalogue and look up products from an MCP client
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.17.0
- Listing updated
- 2 days ago
About Portage Store
Portage Store is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
This is the merchant-side package of the Portage project: the portage-ucp server, distributed as an OCI container image, which publishes a Shopify store's catalogue to AI agents. Its registry entry describes catalogue search and product lookup, and says the separate Portage CLI is what adds full agentic buying.
It needs a SHOPIFY_SHOP_DOMAIN such as your-shop.myshopify.com and a Storefront API access token. An Admin API token is optional. The server runs over stdio, so it is started by the MCP client rather than hosted somewhere.
It is one of several adapter gems in the project, which also covers Wix, WooCommerce, BigCommerce, Magento and Etsy. The docs say every adapter ships a server executable and a PORTAGE_UCP_CONFIG hook. The project is pre-1.0, MIT licensed and provided as-is.
Install
Run in a terminal
claude mcp add portage-ucp --env SHOPIFY_SHOP_DOMAIN='<SHOPIFY_SHOP_DOMAIN>' --env SHOPIFY_STOREFRONT_ACCESS_TOKEN='<SHOPIFY_STOREFRONT_ACCESS_TOKEN>' --env SHOPIFY_ADMIN_ACCESS_TOKEN='<SHOPIFY_ADMIN_ACCESS_TOKEN>' -- docker run -i --rm -e SHOPIFY_SHOP_DOMAIN -e SHOPIFY_STOREFRONT_ACCESS_TOKEN -e SHOPIFY_ADMIN_ACCESS_TOKEN ghcr.io/tomtom87/portage-ucp:0.17.0Add to claude_desktop_config.json
{
"mcpServers": {
"portage-ucp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHOPIFY_SHOP_DOMAIN",
"-e",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN",
"-e",
"SHOPIFY_ADMIN_ACCESS_TOKEN",
"ghcr.io/tomtom87/portage-ucp:0.17.0"
],
"env": {
"SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
"SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"portage-ucp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHOPIFY_SHOP_DOMAIN",
"-e",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN",
"-e",
"SHOPIFY_ADMIN_ACCESS_TOKEN",
"ghcr.io/tomtom87/portage-ucp:0.17.0"
],
"env": {
"SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
"SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"portage-ucp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHOPIFY_SHOP_DOMAIN",
"-e",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN",
"-e",
"SHOPIFY_ADMIN_ACCESS_TOKEN",
"ghcr.io/tomtom87/portage-ucp:0.17.0"
],
"env": {
"SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
"SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"portage-ucp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHOPIFY_SHOP_DOMAIN",
"-e",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN",
"-e",
"SHOPIFY_ADMIN_ACCESS_TOKEN",
"ghcr.io/tomtom87/portage-ucp:0.17.0"
],
"env": {
"SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
"SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"portage-ucp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SHOPIFY_SHOP_DOMAIN",
"-e",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN",
"-e",
"SHOPIFY_ADMIN_ACCESS_TOKEN",
"ghcr.io/tomtom87/portage-ucp:0.17.0"
],
"env": {
"SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
"SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
"SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
}
}
}
}Configuration
SHOPIFY_SHOP_DOMAINYour shop, e.g. your-shop.myshopify.comRequiredSHOPIFY_STOREFRONT_ACCESS_TOKENStorefront API access tokenRequiredSHOPIFY_ADMIN_ACCESS_TOKENAdmin API access token (optional)
What it does
- Shopify catalogue search
- Lets an agent search the products of a connected store.
- Product lookup
- Returns details for a single product.
- Container image
- Ships as an OCI image for stdio use.
- Token-based setup
- Needs the shop domain and a Storefront access token; Admin token optional.
- UCP and MCP
- Serves the same open protocols the Portage CLI speaks.
Good for
- Let an assistant answer questions about products in your Shopify store
- Prototype an agent-readable storefront
- Test a store's catalogue before enabling agent purchases
- Pair with the Portage CLI for approved buying
Pricing
Open source
MIT licence; provided as-is
Prices change. Check portage.readthedocs.io before you buy.
Portage Store FAQ
What credentials does it need?
A shop domain and a Storefront API access token; an Admin API token is optional.
Can it complete purchases by itself?
The registry entry says it covers search and lookup, and that the Portage CLI adds full agentic buying.
How is it run?
As a stdio container image, ghcr.io/tomtom87/portage-ucp.
Is it stable?
The project is pre-1.0, so APIs may change between minor versions.
Is Portage Store free?
Yes. Portage Store is open source, so you can use and self-host it for free.
How do I add Portage Store to Claude Code?
Run this command in your terminal: claude mcp add portage-ucp --env SHOPIFY_SHOP_DOMAIN='<SHOPIFY_SHOP_DOMAIN>' --env SHOPIFY_STOREFRONT_ACCESS_TOKEN='<SHOPIFY_STOREFRONT_ACCESS_TOKEN>' --env SHOPIFY_ADMIN_ACCESS_TOKEN='<SHOPIFY_ADMIN_ACCESS_TOKEN>' -- docker run -i --rm -e SHOPIFY_SHOP_DOMAIN -e SHOPIFY_STOREFRONT_ACCESS_TOKEN -e SHOPIFY_ADMIN_ACCESS_TOKEN ghcr.io/tomtom87/portage-ucp:0.17.0
What are the best alternatives to Portage Store?
The closest alternatives to Portage Store are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).
Alternatives to Portage Store
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data