io.github.oliverhpage/stoop
Find licensed HVAC, plumbing, and electrical providers in Miami with verified ratings.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http stoop 'https://stoop-mcp-server.stoop.workers.dev/mcp'{
"mcpServers": {
"stoop": {
"type": "http",
"url": "https://stoop-mcp-server.stoop.workers.dev/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Frequently asked questions
What is io.github.oliverhpage/stoop?
Find licensed HVAC, plumbing, and electrical providers in Miami with verified ratings.
How do I install io.github.oliverhpage/stoop?
It runs as a remote server. In Claude Code: claude mcp add --transport http stoop 'https://stoop-mcp-server.stoop.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.oliverhpage/stoop need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.oliverhpage/stoop open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.oliverhpage/stoop?
It is published by oliverhpage. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.