Tool detail

ForgeMesh ShopScout

Compares single-seller and split-basket shipping plans against rules you supply, returning cheapest, fastest and fewest-shipment picks.

Categories: Shopping

Use when

compare shipping cost across single-seller vs split-basket fulfillment options
find the cheapest or fastest shipping plan given your own shipping rules

Not for

not live carrier rates -- shipping plans are computed only from rules you supply
excludes tax and duties from all estimates

Inputs

POST JSON body: currency, destination.country, items[] (id, qty, offers), fulfillment_groups[] (shipping rules) all required; constraints optional

Admitted input schema

{
  "type": "object",
  "properties": {
    "constraints": {
      "type": "object",
      "properties": {
        "max_delivery_days": {
          "type": "integer",
          "minimum": 0,
          "maximum": 365
        },
        "max_shipments": {
          "type": "integer",
          "minimum": 1,
          "maximum": 6
        }
      },
      "required": [],
      "additionalProperties": false
    },
    "currency": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^[A-Z]{3}$",
      "description": "All input amounts use minor units of this currency; no currency conversion."
    },
    "destination": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string",
          "minLength": 0,
          "maxLength": 4096,
          "pattern": "^[A-Z]{2}$"
        }
      },
      "required": [
        "country"
      ],
      "additionalProperties": false
    },
    "fulfillment_groups": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "group_id": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
          },
          "merchant_id": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
          },
          "methods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "base_minor": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1000000000
                },
                "delivery_days_max": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 365
                },
                "free_over_subtotal_minor": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1000000000
                },
                "method_id": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 4096,
                  "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
                },
                "per_unit_minor": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1000000000
                }
              },
              "required": [
                "method_id",
                "base_minor",
                "per_unit_minor",
                "delivery_days_max"
              ],
              "additionalProperties": false
            },
            "minItems": 1,
            "maxItems": 4
          },
          "rule_source": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "ship_to_countries": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 0,
              "maxLength": 4096,
              "pattern": "^[A-Z]{2}$"
            },
            "minItems": 1,
            "maxItems": 100
          }
        },
        "required": [
          "group_id",
          "merchant_id",
          "rule_source",
          "ship_to_countries",
          "methods"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 12
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "item_id": {
            "type": "string",
            "minLength": 0,
            "maxLength": 4096,
            "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "group_id": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 4096,
                  "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
                },
                "offer_id": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 4096,
                  "pattern": "^[a-zA-Z0-9_.-]{1,80}$"
                },
                "unit_price_minor": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 1000000000
                }
              },
              "required": [
                "offer_id",
                "group_id",
                "unit_price_minor"
              ],
              "additionalProperties": false
            },
            "minItems": 1,
            "maxItems": 4
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          }
        },
        "required": [
          "item_id",
          "quantity",
          "offers"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 6
    }
  },
  "required": [
    "currency",
    "destination",
    "items",
    "fulfillment_groups"
  ],
  "additionalProperties": false
}

Endpoint

Method: POST
URL: https://shopscout.forgemesh.io/v1/shipping/compare

Payment

Protocol: x402
Listed price: 0.01 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: POST https://shopscout.forgemesh.io/v1/shipping/compare
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z