target-cart-mcp

An MCP server for searching Target products and generating Shopping Cart Share links from a list of TCINs.

Forked from @striderlabs/mcp-target (MIT). The upstream package exposes browser-session tools (login, add-to-cart, checkout, orders) that are unnecessary for agent-driven cart building and tend to confuse LLM agents into attempting them. This fork removes those tools, patches the browser automation layer for container stability, and adds a native create_share_a_cart_link tool backed by the Shopping Cart Share Firebase API.

Tools

Tool	Description
search_products	Search Target products by keyword, category, price range, or sort order
get_product	Get detailed product info (price, description, availability) by URL or TCIN
check_store_availability	Check in-store availability for a TCIN at a given zip code
create_share_a_cart_link	Build a Shopping Cart Share link from a list of TCINs — returns a shoppingcartshare.com/shared/cart/XXXXX URL

Changes from upstream

• Removed tools: status, login, logout, add_to_cart, view_cart, clear_cart, checkout, get_orders, track_order
• Added tool: create_share_a_cart_link — POSTs to the Shopping Cart Share Firebase backend and returns a shareable cart URL
• Browser patches: removed channel: "chrome" launch arg (crashes in containers without real Chrome), added dead-browser detection + automatic reset on crash, added memory-saving Chromium flags for low-memory containers, 45s idle close timer

Usage

Docker Compose

services:
  target-cart-mcp:
    image: target-cart-mcp:latest
    build: .
    container_name: target-cart-mcp
    volumes:
      - ./data/.striderlabs:/root/.striderlabs
    restart: unless-stopped
    shm_size: '256m'
    deploy:
      resources:
        limits:
          memory: 2G

The server exposes a Streamable HTTP MCP endpoint at http://localhost:8000/mcp.

MCP client config (openclaw / Claude Desktop)

{
  "mcp": {
    "servers": {
      "target": {
        "url": "http://target-cart-mcp:8000/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

Using create_share_a_cart_link

The returned URL (shoppingcartshare.com/shared/cart/XXXXX) opens a cart preview page. Clicking Use Cart with the Shopping Cart Share browser extension installed will import the items into your Target cart.

{
  "tool": "create_share_a_cart_link",
  "arguments": {
    "items": [
      { "tcin": "12345678", "title": "Product Name", "quantity": 2, "image": "https://..." }
    ],
    "cart_title": "Weekly Groceries"
  }
}

Building

docker compose build
docker compose up -d

License

MIT — derived from @striderlabs/mcp-target (MIT).