Repository avatar
Other Tools
v1.0.2
active

mcp-houzz-professionals

com.mambabuilt/mcp-houzz-professionals

Houzz contractors and home pros by category and city: phone, address, rating, reviews.

Documentation

Houzz Professionals Directory MCP Server

Glama score MCP Registry npm version npm downloads license

An MCP server for the Mamba Labs Houzz Professionals Directory actor on Apify. Houzz home services pros as rows.

What's Inside

What it does

Takes Houzz categories and US or Canadian cities, or Houzz directory URLs, and returns one row per professional listed, with phone, address, rating, review count, and typical job cost.

All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-houzz-professionals": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-houzz-professionals"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The find_houzz_professionals tool appears.

Prerequisites

Example prompts

  • "Find 30 general contractors in Denver, CO on Houzz with their phone numbers."
  • "List kitchen remodelers in Austin, TX on Houzz rated 4.5 or higher."

Tool

find_houzz_professionals. One tool. Example arguments:

{
  "categories": [
    "general contractor"
  ],
  "locations": [
    "Denver, CO"
  ],
  "max_results_per_search": 15
}

Inputs

Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.

InputTypeRequiredDescription
categoriesarraynoHouzz professional categories, such as general contractor, plumber, roofer, interior designer, kitchen remodelers, or a Houzz category slug such as general-contractor. One search per category per place. Houzz has 64 categories; a name Houzz does not know returns a free summary row.
locationsarraynoUS or Canadian cities as City, ST, for example Denver, CO or Toronto, ON. Put each place on its own line. A place Houzz does not recognize, or resolves to a different city, returns a free summary row.
start_urlsarraynoOptional. Houzz directory pages, for example https://www.houzz.com/professionals/general-contractor/c/Denver--CO. Profile pages are not read.
max_results_per_searchnumbernoProfessional rows to return for each category and place, or each URL, counting sponsored cards when they are included. Houzz lists 15 organic professionals a page. Default 15, maximum 1500.
include_sponsoredbooleannoyes (default) returns the paid placements Houzz mixes into the results, labeled sponsored and without a rank. no returns organic results only.
dedupebooleannoyes (default) returns each professional once per run, so a professional found by two searches, or shown again as a sponsored card on a later page, is charged once. no returns it again each time, charged each time.
max_charge_usdnumbernoOptional. The run stops before a charge that would pass this amount. Summary rows are always returned.

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

EventFree planBronzeSilverGold
pro-row, one professional$0.002$0.0019$0.0018$0.0017
apify-actor-start, per run start$0.004$0.004$0.004$0.004

Summary rows and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.

Full actor documentation

apify.com/mambalabs/houzz-professionals

License

MIT. See LICENSE.