
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
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
- Quick start
- Prerequisites
- Example prompts
- Tool
- Inputs
- Pricing
- Full actor documentation
- License
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
- Node.js 18 or newer.
- An Apify API token from console.apify.com/account/integrations, set as
APIFY_TOKEN. The server lists its tool without a token; a call needs one.
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.
| Input | Type | Required | Description |
|---|---|---|---|
categories | array | no | Houzz 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. |
locations | array | no | US 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_urls | array | no | Optional. Houzz directory pages, for example https://www.houzz.com/professionals/general-contractor/c/Denver--CO. Profile pages are not read. |
max_results_per_search | number | no | Professional 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_sponsored | boolean | no | yes (default) returns the paid placements Houzz mixes into the results, labeled sponsored and without a rank. no returns organic results only. |
dedupe | boolean | no | yes (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_usd | number | no | Optional. 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.
| Event | Free plan | Bronze | Silver | Gold |
|---|---|---|---|---|
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.
@mambalabsdev/mcp-houzz-professionalsnpm install @mambalabsdev/mcp-houzz-professionalsRelated Servers
com.mambabuilt/mcp-account-hiring-watch
Watch company job boards for new, closed, and reposted postings, with 30 day hiring velocity.
com.mambabuilt/mcp-agent-accessibility-auditor
Audit whether an AI agent can read a site: llms.txt, robots AI rules, structured data.
com.mambabuilt/mcp-agent-brokerage-resolver
Find a US real estate agent's brokerage, brokerage size, and license status from state registers.