Skip to content
MCP server

Portage

Let an AI agent search online stores and buy for you, with your approval on every payment

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.18.0
Listing updated
2 days ago

About Portage

Portage is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

MIT licence; provided as-is

Prices change. Check portage.readthedocs.io before you buy.

Portage 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 to Portage

  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