Forage Shopping

Official7 toolsLive

by jalexspringer

AI shopping comparison — search 50M+ products, compare prices, find deals

🛠️ Key Features

name: io.github.jalexspringer/forage-shopping
description: AI shopping comparison — search 50M+ products, compare prices, find deals
topics: (not provided)
toolCount: (not provided)
readmeExcerpt: (not provided)

🚀 Use Cases

Compare product prices across retailers
Discover best deals and discounts
Quickly surface options from a large product catalog

⚡ Developer Benefits

Clear, concise server metadata for catalog listings
Grounded in actual server data fields (name, description)
Lightweight descriptor suitable for indexing and discovery

⚠️ Limitations

Limited data fields provided (no slug, topics, toolCount, or readmeExcerpt)
No explicit usage examples or API surface described
Details are strictly derived from the available description field

Captured live from the server via tools/list.

search_products

Search for products across merchants and return comparison results. Returns structured product listings with prices, merchants, and checkout links. Searches Shopify's global catalogue (50M+ products across all Shopify merchants) and Channel3's affiliate network. Results include direct checkout links.

Parameters3

query	string	required	What to search for, e.g. 'running shoes under £120'
max_results	integer	optional	Maximum number of results to return
session_id	any	optional	Optional session identifier to link tool calls in one conversation. Pass a stable string (e.g. conversation ID) across multiple tool calls.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "What to search for, e.g. 'running shoes under £120'",
      "title": "Query",
      "type": "string"
    },
    "max_results": {
      "default": 10,
      "description": "Maximum number of results to return",
      "title": "Max Results",
      "type": "integer"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional session identifier to link tool calls in one conversation. Pass a stable string (e.g. conversation ID) across multiple tool calls.",
      "title": "Session Id"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_productsArguments"
}

compare_prices

Compare prices for a specific product across multiple merchants. Finds the same product at different retailers and shows price differences.

Parameters2

product_name	string	required	Specific product to compare prices for, e.g. 'Nike Pegasus 41'
session_id	any	optional	Optional session identifier to link tool calls in one conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "product_name": {
      "description": "Specific product to compare prices for, e.g. 'Nike Pegasus 41'",
      "title": "Product Name",
      "type": "string"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional session identifier to link tool calls in one conversation.",
      "title": "Session Id"
    }
  },
  "required": [
    "product_name"
  ],
  "title": "compare_pricesArguments"
}

find_deals

Find the best current deals in a product category. Searches for discounted, on-sale, or best-value products.

Parameters3

category	string	required	Product category, e.g. 'headphones', 'running shoes', 'coffee machines'
budget	any	optional	Optional budget limit, e.g. '£100', '$50'
session_id	any	optional	Optional session identifier to link tool calls in one conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Product category, e.g. 'headphones', 'running shoes', 'coffee machines'",
      "title": "Category",
      "type": "string"
    },
    "budget": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional budget limit, e.g. '£100', '$50'",
      "title": "Budget"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional session identifier to link tool calls in one conversation.",
      "title": "Session Id"
    }
  },
  "required": [
    "category"
  ],
  "title": "find_dealsArguments"
}

start_checkout

Start a UCP checkout session for a product. Discovers the merchant's UCP capabilities, creates a checkout session, and attaches content attribution data from the current session's search and comparison activity. Returns the checkout status and any information the merchant still needs (email, shipping address, etc).

Parameters3

product_url	string	required	URL of the product to purchase. The merchant's domain is used for UCP discovery.
quantity	integer	optional	Number of items to purchase
session_id	any	optional	Session identifier to link checkout with earlier search telemetry.

Raw schema

{
  "type": "object",
  "properties": {
    "product_url": {
      "description": "URL of the product to purchase. The merchant's domain is used for UCP discovery.",
      "title": "Product Url",
      "type": "string"
    },
    "quantity": {
      "default": 1,
      "description": "Number of items to purchase",
      "title": "Quantity",
      "type": "integer"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Session identifier to link checkout with earlier search telemetry.",
      "title": "Session Id"
    }
  },
  "required": [
    "product_url"
  ],
  "title": "start_checkoutArguments"
}

update_checkout_info

Update a checkout session with buyer information. Provide the information the merchant requested (email, name, shipping address, discount codes). Call this after start_checkout when the merchant indicates what information is still needed. If the response has status 'requires_escalation', share the continue_url with the user so they can complete payment in their browser.

Parameters5

checkout_id	string	required	The checkout session ID from start_checkout
buyer_email	any	optional	Buyer's email address
buyer_name	any	optional	Buyer's full name
shipping_address	any	optional	Shipping address as a single string (the merchant will parse it)
discount_code	any	optional	Discount or promo code to apply

Raw schema

{
  "type": "object",
  "properties": {
    "checkout_id": {
      "description": "The checkout session ID from start_checkout",
      "title": "Checkout Id",
      "type": "string"
    },
    "buyer_email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Buyer's email address",
      "title": "Buyer Email"
    },
    "buyer_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Buyer's full name",
      "title": "Buyer Name"
    },
    "shipping_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Shipping address as a single string (the merchant will parse it)",
      "title": "Shipping Address"
    },
    "discount_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Discount or promo code to apply",
      "title": "Discount Code"
    }
  },
  "required": [
    "checkout_id"
  ],
  "title": "update_checkout_infoArguments"
}

complete_purchase

Complete a checkout and place the order. Only call this when the checkout status is 'ready_for_complete'. Records the purchase as a conversion in telemetry and ends the attribution session. Returns the order confirmation with order ID and receipt link.

Parameters2

checkout_id	string	required	The checkout session ID to complete
session_id	any	optional	Session identifier for telemetry. Use the same one from search/checkout.

Raw schema

{
  "type": "object",
  "properties": {
    "checkout_id": {
      "description": "The checkout session ID to complete",
      "title": "Checkout Id",
      "type": "string"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Session identifier for telemetry. Use the same one from search/checkout.",
      "title": "Session Id"
    }
  },
  "required": [
    "checkout_id"
  ],
  "title": "complete_purchaseArguments"
}

check_order

Check the status of a checkout session or order. Use this after the user has completed an escalation step (e.g. payment in the browser) to see if the checkout can now proceed, or to check on a completed order's status.

Parameters1

checkout_id

string

required

The checkout session ID to check

Raw schema

{
  "type": "object",
  "properties": {
    "checkout_id": {
      "description": "The checkout session ID to check",
      "title": "Checkout Id",
      "type": "string"
    }
  },
  "required": [
    "checkout_id"
  ],
  "title": "check_orderArguments"
}

Install

Tools (7)

search_productscompare_pricesfind_dealsstart_checkoutupdate_checkout_infocomplete_purchasecheck_order

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://forageshopping.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "forage-shopping": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://forageshopping.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_products

compare_prices

find_deals

start_checkout

update_checkout_info

complete_purchase

check_order

Install

Remote endpoint

Related servers