{
  "markdown": "# Stoop — Find Licensed Contractors Through Your AI Assistant\n\nStoop 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.\n\nNo more Googling. No more opening 5 tabs. No more calling random numbers.\n\n## How It Works\n\nYou ask Claude something like:\n\n> \"My kitchen faucet is leaking, I need a plumber in Miami\"\n\nStoop returns 3 verified providers ranked by license status, ratings, proximity, and pricing — with direct call/text links.\n\n**What you get:**\n- Licensed providers verified against the Florida DBPR database\n- Star ratings and review counts from Google Places + Yelp\n- Price ranges for your specific service\n- Phone numbers with one-tap call/text\n- Emergency detection (burst pipes get different results than tune-ups)\n\n## Quick Setup (2 minutes)\n\n### Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"stoop\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://stoop-mcp-server.stoop.workers.dev/mcp\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You're done.\n\n### Verify It Works\n\nAsk Claude any of these:\n- \"I need a plumber in Miami\"\n- \"My AC stopped working, it's 95 degrees\"\n- \"Emergency! Pipe burst in my basement\"\n- \"Find an electrician near Coral Gables for a panel upgrade\"\n\n## What Stoop Searches\n\n| Trade | Coverage | License Type |\n|-------|----------|-------------|\n| Plumbing | 234 providers | FL CFC License |\n| Electrical | 230 providers | FL EC License |\n| HVAC | 175 providers | FL CAC License |\n\nAll 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).\n\n## MCP Tools\n\nStoop exposes 4 tools via the Model Context Protocol:\n\n| Tool | Description |\n|------|-------------|\n| `service_search` | Search for providers by trade, location, urgency, and budget |\n| `provider_profile` | Get detailed info on a specific provider (license, hours, reviews) |\n| `home_profile` | Store your home details to improve future matches |\n| `job_history` | View your past searches and contacts |\n\n## How Ranking Works\n\nProviders are scored on a 100-point scale:\n\n| Factor | Points | Notes |\n|--------|--------|-------|\n| Active FL license | 30 | Verified against DBPR |\n| Star rating | 0–20 | Scaled from Google/Yelp rating |\n| Review count | 0–15 | Log scale, caps at ~150 reviews |\n| Proximity | 0–15 | 1 point per mile closer |\n| Availability | 10 | Assumed available in v1 |\n| Price match | 10 | Within your budget |\n| Emergency boost | +15 | For urgent requests only |\n\n## Tech Stack\n\n- **Runtime:** Cloudflare Workers (global edge)\n- **Database:** Supabase PostgreSQL + PostGIS\n- **Intent Parsing:** Keyword-first with Claude Sonnet fallback\n- **Data Sources:** Google Places API, Yelp Fusion API, FL DBPR\n- **UI Components:** React 19 MCP App cards with text/markdown fallback\n- **Monorepo:** Turborepo with shared TypeScript packages\n\n## Current Coverage\n\nMiami metro only (Miami-Dade + Broward County). Three trades: HVAC, Plumbing, Electrical.\n\nMore cities and trades coming based on demand.\n\n## Privacy\n\n- Your search queries are stored for analytics (improving results)\n- No personal information is sent to the LLM — only the query text\n- Provider data comes from public sources (Google, Yelp, state licensing databases)\n- You can request data deletion at any time\n\n## Contributing\n\nThis is an early-stage product. Issues and feedback welcome at [github.com/oliverhpage/stoop/issues](https://github.com/oliverhpage/stoop/issues).\n\n## License\n\nMIT\n",
  "bytes": 3870,
  "sha": "3bbdbdbcdf0711f3462ae405d3e41e48f7623cf8f87c7df44c0068e9df9cf7f9",
  "repo_slug": "oliverhpage/stoop",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_oliverhpage_stoop_ad3ece80/readme"
}