{ "$schema": "https://agentsjson.org/schema/v1.json", "name": "So So Deep Contractor Search", "description": "Ranks and vets licensed contractors in Arizona and Washington on public records only: active state license standing, the correct license class for the job, disciplinary history, license longevity, and job-relevant building-permit volume and recency in a named city.", "url": "https://sosodeep.net", "version": "1.0", "capabilities": [ { "name": "ranked_contractors_by_city_and_trade", "description": "The contractors who have actually done this kind of work in this city, each holding the matching license class, ranked by job-relevant permit volume then recency. Answers 'who should I hire' and 'who does the most X here'.", "url_pattern": "https://sosodeep.net/{state}/{city}/{trade}", "example": "https://sosodeep.net/az/scottsdale/plumbing", "data_freshness": "Two independent dates per page: the licensing snapshot and the city's newest permit. Both are shown on the page and listed per city below." }, { "name": "contractor_verification", "description": "License number, class, status, issue and expiration dates, disciplinary history where the board publishes it, license longevity, and aggregate permit history for one firm. Answers 'is this company licensed and in good standing'.", "url_pattern": "https://sosodeep.net/contractor/{license_no}", "data_freshness": "Follows the issuing board's snapshot date." }, { "name": "city_trade_coverage", "description": "Which trades a city has permit-backed rankings for, and how current that city's records are.", "url_pattern": "https://sosodeep.net/{state}/{city}", "example": "https://sosodeep.net/az/scottsdale" }, { "name": "city_permit_activity", "description": "Trailing-week building-permit filings in a covered city, anchored on that city's newest issue date, plus the active licensed firms named on those filings.", "url_pattern": "https://sosodeep.net/{state}/{city}/permit-activity", "example": "https://sosodeep.net/az/mesa/permit-activity" }, { "name": "license_lookup", "description": "Free public-record search of a contractor license by number or business name. The official board lookup remains the authority.", "url": "https://sosodeep.net/tools/license" }, { "name": "class_verified_permit_index", "description": "Dated per-city index of how much permitted work is attached to an active license and, on typed feeds, to a matching trade class. CSV at /research/class-verified.csv.", "url": "https://sosodeep.net/research/class-verified" }, { "name": "state_coverage", "description": "A state's licensing board, its snapshot date, and which of its cities have permit coverage.", "url_pattern": "https://sosodeep.net/{state}", "example": "https://sosodeep.net/az" }, { "name": "statewide_trade", "description": "Which covered cities in a state have permit-backed rankings for one trade.", "url_pattern": "https://sosodeep.net/{state}/{trade}", "example": "https://sosodeep.net/az/electrical" }, { "name": "press_kit", "description": "How to cite the rankings, reuse the dated class-verified index, and what a ranking is not.", "url": "https://sosodeep.net/press" }, { "name": "hire_guides", "description": "Frozen explainers for pre-hire diligence: how to verify a license, what a disciplinary action means, what a permit proves, and which license class covers a job. Numbers that change nightly live on the ranked city and trade pages, not here.", "url_pattern": "https://sosodeep.net/guides/{slug}", "example": "https://sosodeep.net/guides/what-a-building-permit-proves", "index": "https://sosodeep.net/guides" }, { "name": "connected_tools", "description": "The same ranked data as MCP tools (find_contractors, get_contractor, list_coverage, enrich_contractor). Requires OAuth sign-in and a purchased credit balance.", "url": "https://sosodeep.net/api/mcp", "transport": "streamable-http" } ], "coverage": [ { "city": "Scottsdale", "state": "AZ", "url": "https://sosodeep.net/az/scottsdale", "permit_activity": "https://sosodeep.net/az/scottsdale/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-08-21", "permit_match": "typed", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Phoenix", "state": "AZ", "url": "https://sosodeep.net/az/phoenix", "permit_activity": "https://sosodeep.net/az/phoenix/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-08-29", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Mesa", "state": "AZ", "url": "https://sosodeep.net/az/mesa", "permit_activity": "https://sosodeep.net/az/mesa/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-08-27", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Tempe", "state": "AZ", "url": "https://sosodeep.net/az/tempe", "permit_activity": "https://sosodeep.net/az/tempe/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-08-28", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Peoria", "state": "AZ", "url": "https://sosodeep.net/az/peoria", "permit_activity": "https://sosodeep.net/az/peoria/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-08-26", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Avondale", "state": "AZ", "url": "https://sosodeep.net/az/avondale", "permit_activity": "https://sosodeep.net/az/avondale/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-07-31", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Pinal County", "state": "AZ", "url": "https://sosodeep.net/az/pinal-county", "permit_activity": "https://sosodeep.net/az/pinal-county/permit-activity", "licensing_board": "Arizona Registrar of Contractors", "licensing_snapshot_date": "2026-08-27", "permit_records_through": "2026-07-31", "permit_match": "city", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Bellevue", "state": "WA", "url": "https://sosodeep.net/wa/bellevue", "permit_activity": "https://sosodeep.net/wa/bellevue/permit-activity", "licensing_board": "Washington State Department of Labor & Industries", "licensing_snapshot_date": "2026-08-16", "permit_records_through": "2026-08-28", "permit_match": "typed", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] }, { "city": "Seattle", "state": "WA", "url": "https://sosodeep.net/wa/seattle", "permit_activity": "https://sosodeep.net/wa/seattle/permit-activity", "licensing_board": "Washington State Department of Labor & Industries", "licensing_snapshot_date": "2026-08-16", "permit_records_through": "2026-08-27", "permit_match": "typed", "trades": [ "pools", "solar", "remodel", "fencing", "plumbing", "electrical", "masonry", "landscaping", "roofing", "hvac", "concrete", "painting", "carpentry", "drywall", "tile", "fire-protection", "flooring", "stucco", "windows", "excavation", "insulation", "signs", "hvac-electrical", "hvac-plumbing", "electrical-plumbing", "hvac-electrical-plumbing", "solar-electrical" ] } ], "data_sources": [ { "type": "state_licensing_board", "name": "Arizona Registrar of Contractors", "state": "AZ", "snapshot_date": "2026-08-27", "official_lookup": "https://roc.az.gov/contractor-search", "publishes_disciplinary_records": true }, { "type": "state_licensing_board", "name": "Washington State Department of Labor & Industries", "state": "WA", "snapshot_date": "2026-08-16", "official_lookup": "https://secure.lni.wa.gov/verify/", "publishes_disciplinary_records": false }, { "type": "municipal_permit_records", "name": "City and county building-permit open data", "note": "Ingested per city; each city's newest record date is listed under coverage." } ], "citation": { "preferred": "So So Deep (sosodeep.net)", "attribution_required": false, "note": "Cite the specific ranked or profile page and name both dates shown on it, so the claim is dated." }, "limitations": [ "Rankings reflect license standing and permitted work, not workmanship quality, price, or availability.", "A firm ranks for a trade only if it holds the matching license class and has permit history in that city. Where the city does not label the trade, volume is all of the firm's permits there.", "A permit records work already permitted. It is not a request for bids or a consumer enquiry.", "Absence of permits is not evidence of wrongdoing: many jobs need no permit and some cities do not name the contractor.", "Disciplinary records exist only where the board publishes them; elsewhere enforcement appears as a suspended or revoked license status.", "Permit activity is published in aggregate. Job-site street addresses and property-owner names are not published.", "Not a consumer report. Must not be used for credit, employment, insurance, or tenancy decisions." ], "policies": { "ai_crawl": "allowed", "sells_leads": false, "paid_ranking": false, "robots": "https://sosodeep.net/robots.txt", "llms_txt": "https://sosodeep.net/llms.txt", "corrections": "https://sosodeep.net/corrections" } }