Stoop

io.github.oliverhpage由 GitHub 帳號 oliverhpage 發布v1.0.0更新於 Oct 24, 2026

Find licensed HVAC, plumbing, and electrical providers in Miami with verified ratings.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

Stoop 是遠端 MCP 伺服器,讓助理在邁阿密地區尋找領有執照的暖通空調、水電與電氣承包商,並管理住宅檔案與歷史工單。

可以做什麼
  • 依工種、地點、急迫程度與預算搜尋領有執照的服務商,回傳含評分、價格區間與聯絡方式的排序結果
  • 檢視單一服務商的詳細資料,包括執照狀態、評價與服務紀錄
  • 檢視或更新已驗證使用者的住宅檔案,例如坪數、建成年份與已安裝系統
  • 查詢使用者過去的服務請求與已完成工單,可依工種篩選
適用情境
當邁阿密-戴德郡或布勞沃德郡一帶的使用者需要水電工、電工或暖通空調技師,希望直接取得領有執照、有評分的候選與聯絡方式,而不必開多個網站時適用。也適合集中保存住宅資訊與歷史工單,方便日後媒合。
執行需求
需要遠端 streamable HTTP 端點;README 範例透過 mcp-remote 橋接在桌面用戶端連線。未宣告任何 API 金鑰或環境變數。涵蓋範圍僅限邁阿密都會區與三個工種。
安裝前請注意
住宅檔案與工單歷史工具會讀取並修改與已驗證使用者綁定的資料,使用前應確認儲存內容。搜尋查詢會被保留用於分析,服務商資料來自 Google Places、Yelp 與佛羅里達州執照紀錄,查詢與位置資訊會傳送給第三方。清單中未宣告身分驗證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Stoop,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.oliverhpage%2Fstoop/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "stoop": {
      "type": "http",
      "url": "https://stoop-mcp-server.stoop.workers.dev/mcp"
    }
  }
}

README

Stoop — Find Licensed Contractors Through Your AI Assistant

Stoop is an MCP server that turns AI conversations into real contractor matches. Ask Claude for a plumber, HVAC tech, or electrician in Miami — get 3 licensed, rated providers with phone numbers and pricing, instantly.

No more Googling. No more opening 5 tabs. No more calling random numbers.

How It Works

You ask Claude something like:

"My kitchen faucet is leaking, I need a plumber in Miami"

Stoop returns 3 verified providers ranked by license status, ratings, proximity, and pricing — with direct call/text links.

What you get:

  • Licensed providers verified against the Florida DBPR database
  • Star ratings and review counts from Google Places + Yelp
  • Price ranges for your specific service
  • Phone numbers with one-tap call/text
  • Emergency detection (burst pipes get different results than tune-ups)

Quick Setup (2 minutes)

Claude Desktop

Add this to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{  "mcpServers": {    "stoop": {      "command": "npx",      "args": [        "mcp-remote",        "https://stoop-mcp-server.stoop.workers.dev/mcp"      ]    }  }}

Restart Claude Desktop. You're done.

Verify It Works

Ask Claude any of these:

  • "I need a plumber in Miami"
  • "My AC stopped working, it's 95 degrees"
  • "Emergency! Pipe burst in my basement"
  • "Find an electrician near Coral Gables for a panel upgrade"

What Stoop Searches

TradeCoverageLicense Type
Plumbing234 providersFL CFC License
Electrical230 providersFL EC License
HVAC175 providersFL CAC License

All providers are in the Miami-Dade and Broward County metro area. Data sourced from Google Places, Yelp Fusion, and the Florida Department of Business and Professional Regulation (DBPR).

MCP Tools

Stoop exposes 4 tools via the Model Context Protocol:

ToolDescription
service_searchSearch for providers by trade, location, urgency, and budget
provider_profileGet detailed info on a specific provider (license, hours, reviews)
home_profileStore your home details to improve future matches
job_historyView your past searches and contacts

How Ranking Works

Providers are scored on a 100-point scale:

FactorPointsNotes
Active FL license30Verified against DBPR
Star rating0–20Scaled from Google/Yelp rating
Review count0–15Log scale, caps at ~150 reviews
Proximity0–151 point per mile closer
Availability10Assumed available in v1
Price match10Within your budget
Emergency boost+15For urgent requests only

Tech Stack

  • Runtime: Cloudflare Workers (global edge)
  • Database: Supabase PostgreSQL + PostGIS
  • Intent Parsing: Keyword-first with Claude Sonnet fallback
  • Data Sources: Google Places API, Yelp Fusion API, FL DBPR
  • UI Components: React 19 MCP App cards with text/markdown fallback
  • Monorepo: Turborepo with shared TypeScript packages

Current Coverage

Miami metro only (Miami-Dade + Broward County). Three trades: HVAC, Plumbing, Electrical.

More cities and trades coming based on demand.

Privacy

  • Your search queries are stored for analytics (improving results)
  • No personal information is sent to the LLM — only the query text
  • Provider data comes from public sources (Google, Yelp, state licensing databases)
  • You can request data deletion at any time

Contributing

This is an early-stage product. Issues and feedback welcome at github.com/oliverhpage/stoop/issues.

License

MIT

來源:README.md,提交 49895fa

工具

4

provider_profile

Retrieve detailed profile information for a specific service provider including license status, reviews, and service history.

輸入參數provider_id必填

home_profile

Manage the authenticated user's home profile — view or update property details like square footage, year built, and systems installed.

輸入參數action必填fields

job_history

Retrieve the authenticated user's past service requests and completed jobs, optionally filtered by trade category.

輸入參數limitfilter_trade

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。