io.github.oliverhpage/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

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:

How Ranking Works

Providers are scored on a 100-point scale:

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