Skip to content
Back to search

mcp-houzz-professionals

MCP server for Houzz Professionals Directory: contractors and home services pros by category and city from Houzz.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mambalabsdev--mcp-houzz-professionals/badge.svg)](/listings/mambalabsdev--mcp-houzz-professionals)

HTML

<a href="/listings/mambalabsdev--mcp-houzz-professionals"><img src="/api/listings/mambalabsdev--mcp-houzz-professionals/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines
  1. # Houzz Professionals Directory MCP Server
  2. [![Glama score](https://glama.ai/mcp/servers/mambalabsdev/mcp-houzz-professionals/badges/score.svg)](https://glama.ai/mcp/servers/mambalabsdev/mcp-houzz-professionals) [![MCP Registry](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0%2Fservers%3Fsearch%3Dcom.mambabuilt%252Fmcp-houzz-professionals%26limit%3D1&query=%24.servers%5B0%5D._meta%5B%22io.modelcontextprotocol.registry%2Fofficial%22%5D.status&label=mcp%20registry&color=blue)](https://registry.modelcontextprotocol.io/v0/servers?search=com.mambabuilt/mcp-houzz-professionals&limit=1) [![npm version](https://img.shields.io/npm/v/@mambalabsdev/mcp-houzz-professionals)](https://www.npmjs.com/package/@mambalabsdev/mcp-houzz-professionals) [![npm downloads](https://img.shields.io/npm/dm/@mambalabsdev/mcp-houzz-professionals)](https://www.npmjs.com/package/@mambalabsdev/mcp-houzz-professionals) [![license](https://img.shields.io/github/license/mambalabsdev/mcp-houzz-professionals)](https://github.com/mambalabsdev/mcp-houzz-professionals/blob/main/LICENSE)
  3. An MCP server for the Mamba Labs Houzz Professionals Directory actor on Apify. Houzz home services pros as rows.
  4. ## What's Inside
  5. - [What it does](#what-it-does)
  6. - [Quick start](#quick-start)
  7. - [Prerequisites](#prerequisites)
  8. - [Example prompts](#example-prompts)
  9. - [Tool](#tool)
  10. - [Inputs](#inputs)
  11. - [Pricing](#pricing)
  12. - [Full actor documentation](#full-actor-documentation)
  13. - [License](#license)
  14. ## What it does
  15. 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.
  16. 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.
  17. ## Quick start
  18. You need Node.js 18 or newer and an Apify account with an API token.
  19. Add this to your Claude Desktop config (`claude_desktop_config.json`), Cursor, or any MCP client:
  20. ```json
  21. {
  22. "mcpServers": {
  23. "mamba-houzz-professionals": {
  24. "command": "npx",
  25. "args": [
  26. "-y",
  27. "@mambalabsdev/mcp-houzz-professionals"
  28. ],
  29. "env": {
  30. "APIFY_TOKEN": "your-apify-token"
  31. }
  32. }
  33. }
  34. }
  35. ```
  36. Restart the client. The `find_houzz_professionals` tool appears.
  37. ## Prerequisites
  38. - Node.js 18 or newer.
  39. - An Apify API token from [console.apify.com/account/integrations](https://console.apify.com/account/integrations), set as `APIFY_TOKEN`. The server lists its tool without a token; a call needs one.
  40. ## Example prompts
  41. - "Find 30 general contractors in Denver, CO on Houzz with their phone numbers."
  42. - "List kitchen remodelers in Austin, TX on Houzz rated 4.5 or higher."
  43. ## Tool
  44. `find_houzz_professionals`. One tool. Example arguments:
  45. ```json
  46. {
  47. "categories": [
  48. "general contractor"
  49. ],
  50. "locations": [
  51. "Denver, CO"
  52. ],
  53. "max_results_per_search": 15
  54. }
  55. ```
  56. ## Inputs
  57. Every buyer facing input of the actor. Omitted inputs take the actor's own defaults.
  58. | Input | Type | Required | Description |
  59. |---|---|---|---|
  60. | `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. |
  61. | `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. |
  62. | `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. |
  63. | `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. |
  64. | `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. |
  65. | `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. |
  66. | `max_charge_usd` | number | no | Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. |
  67. ## Pricing
  68. Pay per event on Apify, billed to your Apify account. Prices in USD.
  69. | Event | Free plan | Bronze | Silver | Gold |
  70. |---|---|---|---|---|
  71. | `pro-row`, one professional | $0.002 | $0.0019 | $0.0018 | $0.0017 |
  72. | `apify-actor-start`, per run start | $0.004 | $0.004 | $0.004 | $0.004 |
  73. Summary rows and refused input are free. Mamba Labs pays the platform costs of the run, Apify proxy traffic included.
  74. ## Full actor documentation
  75. [apify.com/mambalabs/houzz-professionals](https://apify.com/mambalabs/houzz-professionals)
  76. ## License
  77. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.