Portage

Name: Portage
Author: tomtom87

tomtom87

Get started Repository Website & docs

Let your agent go to the store (chill, you approve every payment 😃). CLI, Claude Code plugin and Ruby gems for MCP/UCP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add portage --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 ghcr.io/tomtom87/portage-mcp:0.15.0

~/.codex/config.toml

[mcp_servers.portage]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/tomtom87/portage-mcp:0.15.0"]
env = { SHOPIFY_SHOP_DOMAIN = "<SHOPIFY_SHOP_DOMAIN>", SHOPIFY_STOREFRONT_ACCESS_TOKEN = "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>", SHOPIFY_ADMIN_ACCESS_TOKEN = "<SHOPIFY_ADMIN_ACCESS_TOKEN>" }

# codex mcp add portage --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 ghcr.io/tomtom87/portage-mcp:0.15.0

~/.cursor/mcp.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ],
      "env": {
        "SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
        "SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

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

~/.gemini/settings.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ],
      "env": {
        "SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
        "SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ],
      "env": {
        "SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
        "SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "portage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tomtom87/portage-mcp:0.15.0"
      ],
      "env": {
        "SHOPIFY_SHOP_DOMAIN": "<SHOPIFY_SHOP_DOMAIN>",
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "<SHOPIFY_STOREFRONT_ACCESS_TOKEN>",
        "SHOPIFY_ADMIN_ACCESS_TOKEN": "<SHOPIFY_ADMIN_ACCESS_TOKEN>"
      }
    }
  }
}

Environment variables

SHOPIFY_SHOP_DOMAIN
SHOPIFY_STOREFRONT_ACCESS_TOKEN
SHOPIFY_ADMIN_ACCESS_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related