Skip to content

oliverhpage/stoop

Repository files navigation

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

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

Trade Coverage License Type
Plumbing 234 providers FL CFC License
Electrical 230 providers FL EC License
HVAC 175 providers FL 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:

Tool Description
service_search Search for providers by trade, location, urgency, and budget
provider_profile Get detailed info on a specific provider (license, hours, reviews)
home_profile Store your home details to improve future matches
job_history View your past searches and contacts

How Ranking Works

Providers are scored on a 100-point scale:

Factor Points Notes
Active FL license 30 Verified against DBPR
Star rating 0–20 Scaled from Google/Yelp rating
Review count 0–15 Log scale, caps at ~150 reviews
Proximity 0–15 1 point per mile closer
Availability 10 Assumed available in v1
Price match 10 Within your budget
Emergency boost +15 For 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

About

MCP server for AI-powered home services matching in Miami

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages