Stoop

io.github.oliverhpagePublished by GitHub account oliverhpagev1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Stoop is a remote MCP server that lets an assistant find licensed HVAC, plumbing and electrical contractors in the Miami area and manage a home profile and…

What you can do
  • Search licensed providers by trade, location, urgency and budget, with ranked results including ratings, price ranges and contact info
  • Read a provider's detailed profile: license status, reviews and service history
  • View or update the authenticated user's home profile, such as square footage, year built and installed systems
  • Retrieve the user's past service requests and completed jobs, optionally filtered by trade
When to use it
Useful when someone in the Miami-Dade or Broward County area needs a plumber, electrician or HVAC technician and wants licensed, rated options with contact details instead of searching several sites. Also handy for keeping home details and past service jobs in one place for future matches.
Requirements
A remote streamable HTTP endpoint; the README shows connecting through the mcp-remote bridge from a desktop client. No API keys or environment variables are declared. Coverage is limited to the Miami metro area and three trades.
Before you install
The home profile and job history tools read and change data tied to the authenticated user, so review what is stored. Search queries are kept for analytics, and provider data is pulled from Google Places, Yelp and Florida licensing records, so queries and location details reach third parties. No authentication is declared in the manifest.

Installation

In SourceWeft

  1. Open Stoop in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.oliverhpage%2Fstoop/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Source: README.md at commit 49895fa

Tools

4

provider_profile

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

Parametersprovider_idrequired

home_profile

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

Parametersactionrequiredfields

job_history

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

Parameterslimitfilter_trade

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.