# Portage Store

> Portage Store is an open-source MCP server for e-commerce. Search a Shopify store's catalogue and look up products from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://portage.readthedocs.io
- **Repository:** https://github.com/tomtom87/portage
- **MCP Registry name:** io.github.tomtom87/portage-ucp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/portage-store
