FindA.Sale

Working · 747 ms

sale.finda/findasalev2.0.0 Domain verified

Find yard sales, garage sales, auctions, flea markets and resale shops, and search items for sale.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

find_item_for_sale Read-only

Find a specific thing someone wants to buy (furniture, a collectible, a tool) across current public sales, optionally in one city and price range. Returns up to 10 matches with links to cite.

querystring, required

What the shopper is looking for, e.g. "Hummel figurine" or "oak dresser"

citystring

Only items in sales in this city

maxPricenumber

Maximum price in US dollars

minPricenumber

Minimum price in US dollars

Tools (10)

find_item_for_sale

Find a specific thing someone wants to buy (furniture, a collectible, a tool) across current public sales, optionally in one city and price range. Returns up to 10 matches with links to cite.

read-only

Argument	Type	Description
city	string	Only items in sales in this city
query*	string	What the shopper is looking for, e.g. "Hummel figurine" or "oak dresser"
maxPrice	number	Maximum price in US dollars
minPrice	number	Minimum price in US dollars

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "Only items in sales in this city"
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "What the shopper is looking for, e.g. \"Hummel figurine\" or \"oak dresser\""
    },
    "maxPrice": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price in US dollars"
    },
    "minPrice": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum price in US dollars"
    }
  }
}

get_item

Get one publicly listed item: title, description, price, condition, photos, and the sale it belongs to (title, city, dates, link).

read-only

Argument	Type	Description
itemId*	string	The FindA.Sale item id, as returned by a search tool

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The FindA.Sale item id, as returned by a search tool"
    }
  }
}

get_sale

Get one public sale: dates, city, approximate location, description, photos, organizer name and rating, and up to 25 available items. Street addresses are never included; the sale page shows them to signed-in shoppers from the day before the sale.

read-only

Argument	Type	Description
saleId*	string	The FindA.Sale sale id, as returned by a search tool

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "saleId"
  ],
  "properties": {
    "saleId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The FindA.Sale sale id, as returned by a search tool"
    }
  }
}

get_sales_starting_soon

List public sales starting in the next few days (default 7, max 14). Good for "what sales are this weekend near X" questions.

read-only

Argument	Type	Description
city	string	City name, e.g. "Chicago"
saleType	string	Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out).
daysAhead	integer	How many days ahead to look (default 7, max 14)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "City name, e.g. \"Chicago\""
    },
    "saleType": {
      "enum": [
        "ESTATE",
        "YARD",
        "AUCTION",
        "FLEA_MARKET",
        "RETAIL",
        "DORM_DASH"
      ],
      "type": "string",
      "description": "Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out)."
    },
    "daysAhead": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1,
      "description": "How many days ahead to look (default 7, max 14)"
    }
  }
}

get_trending_sales

List current public sales with the most shopper interest and recent activity, optionally in one city or of one sale type.

read-only

Argument	Type	Description
city	string	City name, e.g. "Grand Rapids"
limit	integer	Max results (default 10, max 25)
saleType	string	Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "City name, e.g. \"Grand Rapids\""
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max results (default 10, max 25)"
    },
    "saleType": {
      "enum": [
        "ESTATE",
        "YARD",
        "AUCTION",
        "FLEA_MARKET",
        "RETAIL",
        "DORM_DASH"
      ],
      "type": "string",
      "description": "Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out)."
    }
  }
}

list_categories

List item categories that currently have items for sale, with item counts. Use a name from this list as the category filter in search_items.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_cities

List cities with current public sales on FindA.Sale, busiest first, with active sale counts and a browse link for each city. Filter by state to narrow the list.

read-only

Argument	Type	Description
limit	integer	Max cities to return (default 100, max 500)
state	string	State or province code, e.g. "MI" or "ON"

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max cities to return (default 100, max 500)"
    },
    "state": {
      "type": "string",
      "maxLength": 3,
      "minLength": 2,
      "description": "State or province code, e.g. \"MI\" or \"ON\""
    }
  }
}

list_sale_types

List the sale type codes FindA.Sale uses (yard sale, whole-house sale, auction, flea market, shop, dorm move-out) with a short description of each.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

search_items

Search items listed for sale across current public FindA.Sale sales by keyword, with optional category, condition, price range and city filters. Returns item title, price, condition, photos and links to the item and its sale.

read-only

Argument	Type	Description
city	string	Only items in sales in this city
limit	integer	Max results (default 20, max 50)
query*	string	Keywords, e.g. "brass lamp" or "oak dresser"
sortBy	string	Sort order (default relevance)
category	string	Category name from list_categories, e.g. "Furniture"
priceMax	number	Maximum price in US dollars
priceMin	number	Minimum price in US dollars
condition	string	Condition filter, e.g. "NEW", "LIKE_NEW", "USED"

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "description": "Only items in sales in this city"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max results (default 20, max 50)"
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Keywords, e.g. \"brass lamp\" or \"oak dresser\""
    },
    "sortBy": {
      "enum": [
        "relevance",
        "newest",
        "price_asc",
        "price_desc"
      ],
      "type": "string",
      "description": "Sort order (default relevance)"
    },
    "category": {
      "type": "string",
      "maxLength": 100,
      "description": "Category name from list_categories, e.g. \"Furniture\""
    },
    "priceMax": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price in US dollars"
    },
    "priceMin": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum price in US dollars"
    },
    "condition": {
      "type": "string",
      "maxLength": 40,
      "description": "Condition filter, e.g. \"NEW\", \"LIKE_NEW\", \"USED\""
    }
  }
}

search_sales

Find current public sales (yard and garage sales, whole-house sales, auctions, flea markets, shops) by keyword, city, ZIP, map point, date range or sale type. Returns sale summaries with approximate location and a link to each sale page. Street addresses are never included.

read-only

Argument	Type	Description
lat	number	Latitude for a radius search (use with lng)
lng	number	Longitude for a radius search (use with lat)
zip	string	5-digit US ZIP code
city	string	City name, e.g. "Grand Rapids"
limit	integer	Max results (default 20, max 50)
query	string	Keywords to match in the sale title or description, e.g. "mid-century" or "tools"
endDate	string	Only sales starting on or before this date (YYYY-MM-DD)
radiusKm	number	Radius in kilometers for lat/lng search (default 25)
saleType	array

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "lat": { "type": "number", "maximum": 90, "minimum": -90, "description": "Latitude for a radius search (use with lng)" }, "lng": { "type": "number", "maximum": 180, "minimum": -180, "description": "Longitude for a radius search (use with lat)" }, "zip": { "type": "string", "pattern": "^\\d{5}$", "description": "5-digit US ZIP code" }, "city": { "type": "string", "maxLength": 80, "description": "City name, e.g. \"Grand Rapids\"" }, "limit": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Max results (default 20, max 50)" }, "query": { "type": "string", "maxLength": 100, "description": "Keywords to match in the sale title or description, e.g. \"mid-century\" or \"tools\"" }, "endDate": { "type": "string", "maxLength": 30, "description": "Only sales starting on or before this date (YYYY-MM-DD)" }, "radiusKm": { "type": "number", "maximum": 200, "minimum": 1, "description": "Radius in kilometers for lat/lng search (default 25)" }, "saleType": { "type": "array", "items": { "enum": [ "ESTATE", "YARD", "AUCTION", "FLEA_MARKET", "RETAIL", "DORM_DASH" ], "type": "string" }, "maxItems": 6, "description": "Sale type code: ESTATE (whole-house sale), YARD (yard or garage sale), AUCTION, FLEA_MARKET, RETAIL (shop or storefront, incl. consignment), DORM_DASH (dorm move-out)." }, "startDate": { "type": "string", "maxLength": 30, "description": "Only sales starting on or after this date (YYYY-MM-DD)" }, "minConfidence": { "type": "number", "maximum": 1, "minimum": 0, "description": "Minimum listing confidence 0 to 1. 0.7 = organizer-verified, 0.4 = corroborated by a third party." } } }