Portage
Let an AI agent search online stores and buy for you, with your approval on every payment
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"portage": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tomtom87/portage-mcp:0.15.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"portage": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tomtom87/portage-mcp:0.15.0"
]
}
}
}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
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