FindA.Sale MCP

An official MCP server provided by FindA.Sale that enables software agents to query live secondary sales data. It supports read-only tools to search for yard sales, garage sales, auctions, and flea markets, retrieve item details, list cities and categories, and find specific items for sale. The server ensures privacy by excluding street addresses and contact details, providing approximate coordinates and public organizer information.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by FindA.Sale

MCP endpoint (Streamable HTTP)

https://mcp.finda.sale/mcp

Vendor documentation

What you can do with it

Search for local yard sales, garage sales, or auctions by location or keyword
Retrieve detailed information about specific items for sale including photos and prices
List available cities, sale types, and categories to browse inventory
Find specific items for sale by name and city using the find_item_for_sale tool

Source and maintenance

Vendor evidenceRegistry 2.0.0

mcp-registry: sale.finda/findasale@2.0.0 Source repository Project website

Maintenance checked: Nov 1, 2026, 7:42 AM UTC

Protocol and capabilities

Server: sale.finda/findasale 2.0.0
MCP protocol: 2025-06-18
Tools: 10 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

FindA.Sale lists public secondary sales (yard and garage sales, whole-house sales, auctions, flea markets, resale shops) and the items in them. All tools are read-only. Use search_sales or get_sales_starting_soon to find sales, get_sale for one sale, and search_items or find_item_for_sale to find items. Results never include street addresses. Point shoppers to the sale url: signed-in shoppers see the address there from the day before the sale starts. Cite the url field of each result when you mention a sale or item.

Tools

10 advertised

search_sales — Search Sales

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

search_sales input schema

{
  "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."
    }
  }
}

search_sales annotations

{
  "title": "Search Sales",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_sale — Get Sale Details

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

get_sale input schema

{
  "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_sale annotations

{
  "title": "Get Sale Details",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

search_items — Search Items

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

search_items input schema

{
  "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_items annotations

{
  "title": "Search Items",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_item — Get Item Details

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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

get_item input schema

{
  "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_item annotations

{
  "title": "Get Item Details",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

list_cities — List Cities

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

list_cities input schema

{
  "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_cities annotations

{
  "title": "List Cities",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

list_sale_types — List Sale Types

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

list_sale_types input schema

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

list_sale_types annotations

{
  "title": "List Sale Types",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

list_categories — List Categories

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

list_categories input schema

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

list_categories annotations

{
  "title": "List Categories",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_trending_sales — Get Trending Sales

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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

get_trending_sales input schema

{
  "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)."
    }
  }
}

get_trending_sales annotations

{
  "title": "Get Trending Sales",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

get_sales_starting_soon — Get Sales Starting Soon

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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

get_sales_starting_soon input schema

{
  "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_sales_starting_soon annotations

{
  "title": "Get Sales Starting Soon",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

find_item_for_sale — Find Item For Sale

Advertised by the server during the last successful anonymous check.

Advertised read-onlyOpen-world

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.

find_item_for_sale input schema

{
  "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"
    }
  }
}

find_item_for_sale annotations

{
  "title": "Find Item For Sale",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 594 ms
95th percentile latency: 594 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 8:10 AM UTC · probe · passed · 594 ms · metadata changed · 10 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http finda-sale-mcp https://mcp.finda.sale/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add finda-sale-mcp --url https://mcp.finda.sale/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable finda-sale-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "finda-sale-mcp": {
      "url": "https://mcp.finda.sale/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "finda-sale-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.finda.sale/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start finda-sale-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "finda-sale-mcp": {
      "type": "http",
      "url": "https://mcp.finda.sale/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http finda-sale-mcp https://mcp.finda.sale/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "finda-sale-mcp": {
      "url": "https://mcp.finda.sale/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "finda-sale-mcp": {
      "serverUrl": "https://mcp.finda.sale/mcp"
    }
  }
}

Let your agent find its tools

Find servers like FindA.Sale MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 1,066

Do you run FindA.Sale MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

FindA.Sale MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other commerce servers

Do you run FindA.Sale MCP?