# Portage

> Portage is an open-source MCP server for e-commerce. Let an AI agent search online stores and buy for you, with your approval on every payment. It runs locally on your machine and is started by your AI client.

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

## About

Portage is built around a hard rule: nothing is bought without an explicit yes, and card data never passes through it. It works with stores that publish a UCP manifest at /.well-known/ucp, stores whose pages expose WebMCP tools, and platforms where you already hold API credentials. For anything else it builds what it can and then hands the checkout to you in your own browser.

The project is several pieces. A command-line tool called portage does the work, a Claude Code plugin named buy drives it, and a set of Ruby gems lets merchants serve the same open protocols (MCP and UCP) to shopping agents. Adapters exist for Shopify, Wix, WooCommerce, BigCommerce, Magento, Etsy and Instagram catalogues.

Setup is a one-time interactive portage setup run in a terminal, which asks for a shipping address, optional search keys and spending caps. The docs say it is pre-1.0, so APIs may change between minor versions, and it is MIT licensed and provided as-is.

## Features

- **Approval before purchase:** Shows real offers and a dry-run total, then waits for your yes.
- **Three-tier site handling:** Hands off, builds a cart in a separate profile, or stays out entirely for chosen hosts.
- **Claude Code plugin:** The buy plugin and a read-only shop-research skill drive the CLI.
- **Merchant gems:** Ruby gems let a store serve UCP and MCP endpoints to agents.
- **Platform adapters:** Covers Shopify, Wix, WooCommerce, BigCommerce, Magento, Etsy and Instagram.
- **Spending caps:** Setup lets you set limits on what an agent may spend.

## Good for

- Ask Claude to find a product under a price cap and show real offers
- Compare prices across stores before approving a purchase
- Build a shopping agent on the portage CLI JSON output
- Expose a store's catalogue and checkout to agents over UCP
- Write an adapter for a new commerce platform

## Install

### Claude Code (Terminal)

```sh
claude mcp add portage -- docker run -i --rm ghcr.io/tomtom87/portage-mcp:0.15.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "portage": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
```

## FAQ

### Can the agent pay without asking me?

No. The docs state nothing is bought without your explicit yes.

### Does Portage handle my card details?

No, card data never passes through it.

### Does it bypass CAPTCHAs or read my browser data?

No. It never solves a CAPTCHA and never reads your browser's password, cookie or autofill stores.

### How do I install the plugin?

Install the CLI with Homebrew or gem install portage-cli, then add the buy plugin from the tomtom87/Portage marketplace in Claude Code.

### Is it stable?

It is pre-1.0, so APIs may change between minor versions.

### Is Portage free?

Yes. Portage is open source, so you can use and self-host it for free.

### How do I add Portage to Claude Code?

Run this command in your terminal: claude mcp add portage -- docker run -i --rm ghcr.io/tomtom87/portage-mcp:0.15.0

### What are the best alternatives to Portage?

The closest alternatives to Portage 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
