Skip to content
MCP server

Portage Store

Search a Shopify store's catalogue and look up products from an MCP client

Runs locallyStatus and history
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.0

Add 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.comRequired
  • SHOPIFY_STOREFRONT_ACCESS_TOKENStorefront API access tokenRequired
  • SHOPIFY_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

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data