Aisles MCP

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "size": {
      "type": "string",
      "description": "The clothing or shoe size the user stated, exactly as said, e.g. \"8\", \"10.5\", \"M\", \"32\". Only when the user gave one; a package amount is not a size."
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Number of listings to return (default 8)."
    },
    "query": {
      "type": "string",
      "description": "Product words only: brand, product name or kind, e.g. \"similac formula\", \"2% milk gallon\", \"dozen eggs\", \"nike air force 1\", \"levi's 501 jeans\", \"ugg\". A brand alone is fine when that is all the user named. Package quantities and amounts (\"gallon\", \"12 pack\", \"32 oz\") stay here. Leave out the place and the clothing or shoe size."
    },
    "location": {
      "type": "string",
      "description": "The place the user named: a covered metro slug or name (chicago, new-york, los-angeles, houston, phoenix, philadelphia, san-antonio, san-diego, dallas, fort-worth, charlotte, columbus, indianapolis, seattle, south-bend, orlando, atlanta, boston, fort-lauderdale, baltimore, detroit, danbury, tampa, oakland, denver, las-vegas, akron, riverside, trenton, pittsburgh, st-louis, norfolk, milwaukee, little-rock, tucson, west-palm-beach, miami, aurora, louisville, minneapolis, memphis, omaha, cincinnati, lancaster, myrtle-beach, austin, cypress, fredericksburg, rogers, modesto, daytona-beach, jacksonville, savannah, michigan-city, kansas-city, albuquerque, albany, buffalo, middletown, rochester, niles, tulsa, scranton, charleston, nashville, allen, el-paso, mcallen, puyallup, birmingham, mobile, fort-smith, camarillo, bakersfield, fairfield, escondido, fresno, salinas, sacramento, victorville, colorado-springs, grand-junction, pueblo, wilmington, hartford, fort-myers, destin, jensen-beach, ocala, panama-city, pensacola, sarasota, tallahassee, commerce, columbus-ga, augusta, coralville, davenport, sioux-city, boise, champaign, normal, rockford, springfield, evansville, fort-wayne, kokomo, lafayette, ashland, wichita, bowling-green, lexington, elizabethtown, paducah, alexandria, baton-rouge, worcester, hyannis, hagerstown, salisbury, flint, portage, duluth, columbia, st-cloud, springfield-mo, jackson, tupelo, missoula, asheville, greensboro, raleigh, fargo, wilmington-nc, manchester, rockaway, gallup, reno, syracuse, dayton, sandusky, st-clairsville, toledo, oklahoma-city, erie, allentown, columbia-sc, greenville, florence, sioux-falls, clarksville, knoxville, chattanooga, abilene, beaumont, college-station, corpus-christi, killeen, longview, laredo, lubbock, midland, san-angelo, san-marcos, texas-city, victoria, waco, richmond, lynchburg, roanoke, kennewick, portland, union-gap, green-bay, johnson-creek, madison, bridgeport, mount-hope, vienna, huntsville, florence-al, dothan, chico, yuba-city, palm-desert, palmdale, fort-collins, macon, gainesville-ga, eugene, grand-rapids) or a 5-digit ZIP code in those areas. Town and mall names are not resolved: for a town or mall inside a metro, use the metro (Del Amo Fashion Center or Torrance: los-angeles; King of Prussia or King of Prussia: philadelphia; Mall of Georgia or Buford: atlanta; Roosevelt Field or Garden City: new-york; Sawgrass Mills or Sunrise: fort-lauderdale; South Shore Plaza or Braintree: boston; The Galleria or Houston: houston; University Park Mall or Mishawaka: south-bend; Woodfield Mall or Schaumburg: chicago) or the town's ZIP. Leave it out when the user named no place: their approximate location is used if the app supplies it, and otherwise the reply asks for a city or ZIP."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price in US dollars."
    },
    "fulfillment": {
      "type": "array",
      "items": {
        "enum": [
          "curbside_pickup",
          "store_pickup",
          "pickup_today",
          "in_store_shopping",
          "local_delivery",
          "same_day_delivery",
          "ship_to_store"
        ],
        "type": "string"
      },
      "description": "Only stores offering all of these."
    },
    "size_system": {
      "type": "string",
      "description": "Only when the user said whose size it is: US_MENS, US_WOMENS, US_YOUTH, US_UNISEX, EU or UK. Never infer it from the number alone (\"size 8\" has no system)."
    },
    "availability": {
      "enum": [
        "available",
        "out_of_stock",
        "unknown",
        "any"
      ],
      "type": "string",
      "description": "Default \"available\": in stock or low stock."
    },
    "radius_miles": {
      "type": "number",
      "maximum": 50,
      "minimum": 0.1,
      "description": "Search radius in miles. Leave it out for a city to cover every store Aisles lists there, including malls outside the center; a ZIP defaults to 10 miles."
    }
  },
  "additionalProperties": false
}

{
  "title": "Find a product in stock at nearby stores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string",
      "description": "Optional: words a metro, its state, a chain or a mall must contain, e.g. \"TX\", \"Kroger\", \"Roosevelt Field\". Leave it out for every covered metro."
    }
  },
  "additionalProperties": false
}

{
  "title": "List covered metros, chains and malls",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "Covered metro slug: chicago, new-york, los-angeles, houston, phoenix, philadelphia, san-antonio, san-diego, dallas, fort-worth, charlotte, columbus, indianapolis, seattle, south-bend, orlando, atlanta, boston, fort-lauderdale, baltimore, detroit, danbury, tampa, oakland, denver, las-vegas, akron, riverside, trenton, pittsburgh, st-louis, norfolk, milwaukee, little-rock, tucson, west-palm-beach, miami, aurora, louisville, minneapolis, memphis, omaha, cincinnati, lancaster, myrtle-beach, austin, cypress, fredericksburg, rogers, modesto, daytona-beach, jacksonville, savannah, michigan-city, kansas-city, albuquerque, albany, buffalo, middletown, rochester, niles, tulsa, scranton, charleston, nashville, allen, el-paso, mcallen, puyallup, birmingham, mobile, fort-smith, camarillo, bakersfield, fairfield, escondido, fresno, salinas, sacramento, victorville, colorado-springs, grand-junction, pueblo, wilmington, hartford, fort-myers, destin, jensen-beach, ocala, panama-city, pensacola, sarasota, tallahassee, commerce, columbus-ga, augusta, coralville, davenport, sioux-city, boise, champaign, normal, rockford, springfield, evansville, fort-wayne, kokomo, lafayette, ashland, wichita, bowling-green, lexington, elizabethtown, paducah, alexandria, baton-rouge, worcester, hyannis, hagerstown, salisbury, flint, portage, duluth, columbia, st-cloud, springfield-mo, jackson, tupelo, missoula, asheville, greensboro, raleigh, fargo, wilmington-nc, manchester, rockaway, gallup, reno, syracuse, dayton, sandusky, st-clairsville, toledo, oklahoma-city, erie, allentown, columbia-sc, greenville, florence, sioux-falls, clarksville, knoxville, chattanooga, abilene, beaumont, college-station, corpus-christi, killeen, longview, laredo, lubbock, midland, san-angelo, san-marcos, texas-city, victoria, waco, richmond, lynchburg, roanoke, kennewick, portland, union-gap, green-bay, johnson-creek, madison, bridgeport, mount-hope, vienna, huntsville, florence-al, dothan, chico, yuba-city, palm-desert, palmdale, fort-collins, macon, gainesville-ga, eugene, grand-rapids."
    }
  },
  "additionalProperties": false
}

{
  "title": "List answered shopping questions for a metro",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Number of products to return (default 5)."
    },
    "query": {
      "type": "string",
      "description": "Product words: brand and product name, e.g. \"asics gel-nyc\", \"hanes crew socks\"."
    },
    "store": {
      "enum": [
        "hanes",
        "finish-line",
        "jd-sports"
      ],
      "type": "string",
      "description": "Only when the user asked about one store."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum listed price in US dollars."
    },
    "gift_cards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "store",
          "balance"
        ],
        "properties": {
          "store": {
            "enum": [
              "hanes",
              "finish-line",
              "jd-sports"
            ],
            "type": "string",
            "description": "The store the gift card is for."
          },
          "balance": {
            "type": "number",
            "maximum": 10000,
            "description": "Balance in US dollars.",
            "exclusiveMinimum": 0
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "description": "The gift card balances the user stated. Amounts only, never a card number, PIN or code."
    },
    "card_rewards_percent": {
      "type": "number",
      "maximum": 50,
      "minimum": 0,
      "description": "Only when the user stated it: percent back from their credit card, e.g. 2."
    }
  },
  "additionalProperties": false
}

{
  "title": "Compare online prices and net price after gift cards",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}