stoop

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