Skip to main content
Glama
Sign In

Flipvo: licenses, entities, NPI, OFAC and OIG screens, carriers, OSHA, drive times

by io.github.stea4lth
OverviewDiscussionsAdmin

license_search

Read-only

$0.05 per call. Pay with x402 (USDC on Base) in _meta["x402/payment"]; MPP (tempo) on the HTTP URL /v1/license/search. Licensed contractors by trade and city, zip or county: license number, name, license type and class, status, expiry, address. Trades CA: asbestos_lead, boiler_piping, cabinets_finish_carpentry, concrete, demolition, drywall, electrical, elevator, fencing, fire_protection, flooring, framing, general, general_engineering, glazing, hvac, insulation, landscaping, lock_security, low_voltage, manufactured_home_setup, masonry, ornamental_metal, painting, parking_highway, paving, pipeline, plastering, plumbing, pool, reinforcing_steel, residential_remodeling, roofing, sewer_septic, sheet_metal, signs, solar, steel_erection, tile, traffic_control, tree_service, water_conditioning, welding, well_drilling; CO: electrical, plumbing; FL: alarm, demolition, drywall, electrical, garage_door, gas_line, general, glazing, hvac, irrigation, low_voltage, marine, plumbing, pollutant_storage, pool, pool_specialty, residential_electrical, roofing, sheet_metal, sign_electrical, solar, specialty_structure, underground_utility, window_door; LA: asbestos_lead, commercial_general, concrete, demolition, drywall, electrical, excavation, flooring, glazing, highway_heavy, home_improvement, house_moving, hvac, insulation, landscaping, low_voltage, marine, masonry, mold_remediation, painting, paving, plastering, plumbing, pollutant_storage, pool, reinforcing_steel, residential_general, roofing, sandblasting, sheet_metal, siding, solar, steel_erection, telecommunications, underground_utility, well_drilling; MN: boiler_piping, electrical, elevator, hvac, low_voltage, manufactured_home_setup, plumbing, residential_general, residential_remodeling, roofing, sign_electrical, underground_utility, water_conditioning; NJ: alarm, electrical, home_elevation, home_improvement, hvac, locksmith, plumbing, telecommunications; OR: commercial_general, commercial_specialty, home_inspector, lead_paint, locksmith, residential_general, residential_specialty; TN: asbestos_lead, boiler_piping, commercial_general, concrete, demolition, drywall, electrical, elevator, excavation, fencing, fire_protection, flooring, framing, gas_line, glazing, highway_heavy, hvac, insulation, irrigation, landscaping, low_voltage, masonry, ornamental_metal, painting, paving, plastering, plumbing, pool, residential_general, roofing, sandblasting, scaffolding, sheet_metal, sign_electrical, signs, steel_erection, telecommunications, tile, underground_utility, welding; TX: electrical, hvac, plumbing, sign_electrical; VA: accessibility, alarm, alternative_energy, asbestos_lead, cabinets_finish_carpentry, commercial_general, commercial_improvement, concrete, drilling_blasting, drywall, electrical, elevator, environmental, farm_improvement, fire_protection, flooring, framing, gas_line, glazing, highway_heavy, home_improvement, hvac, industrial_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, marine, masonry, modular_building, painting, paving, plumbing, pool, radon_mitigation, recreational_facility, residential_general, roofing, sewer_septic, signs, steel_erection, tile, underground_utility, vessel_construction, well_drilling; WA: alarm, appliances, asbestos_lead, awnings, backflow, boiler_piping, cabinets_finish_carpentry, central_vacuum, closets, concrete, construction_cleanup, demolition, doors_gates, drain_cleaning, drilling_blasting, drywall, electrical, electrical_maintenance, elevator, excavation, fencing, fire_protection, fireproofing, flooring, framing, garage_door, general, glazing, gutters, handyman, house_moving, hvac, industrial_equipment, institutional_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, masonry, metal_fabrication, painting, paving, pest_control, plastering, plumbing, pool, pressure_washing, pump_irrigation, residential_electrical, roofing, sandblasting, scaffolding, service_station_equipment, sewer_septic, siding, sign_electrical, signs, steel_erection, stoves, suspended_ceilings, tanks, telecommunications, tile, tree_service, underground_utility, water_conditioning, welding, well_drilling, window_coverings. Up to 25 results, active first, with total_matches; empty results is a paid 200.

Input Schema

NameRequiredDescriptionDefault
zipNo5-digit ZIP (ZIP+4 accepted; the first 5 digits match). Exactly one of city, zip or county.
cityNoExact match after normalizing case and spaces, on addresses in the requested state. Exactly one of city, zip or county.
limitNo
stateYes
tradeYesA trade slug. Each state offers its own list: GET /v1/license/trades (free)
countyNoOffered only where a state lists it; LA takes a parish. Exactly one of city, zip or county.
active_onlyNo

Output Schema

NameRequiredDescriptionDefault
queryYes
stateYes
sourceYes
resultsYes
coverageYes
truncatedYestotal_matches is more than the results returned.
data_as_ofYes
total_matchesYesMatches before the limit.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / county / description
      Previous value: -"Offered only where a state lists it. Exactly one of city, zip or county."New value: +"Offered only where a state lists it; LA takes a parish. Exactly one of city, zip or county."
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "CA",
-  "CO",
-  "FL",
-  "MN",
-  "NJ",
-  "OR",
-  "TN",
-  "TX",
-  "VA",
-  "WA"
-]New value: +[
+  "CA",
+  "CO",
+  "FL",
+  "LA",
+  "MN",
+  "NJ",
+  "OR",
+  "TN",
+  "TX",
+  "VA",
+  "WA"
+]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). MN and NJ: the subtype or type DLI or DCA files. TN: its board class ids in the trade. Null for OR and TX."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). MN and NJ: the subtype or type DLI or DCA files. TN: its board class ids in the trade. LA: its classes in the trade, joined by '; '. Null for OR and TX."
  2. Changed2 schema fields changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "CA",
-  "FL",
-  "MN",
-  "NJ",
-  "OR",
-  "TX",
-  "VA",
-  "WA"
-]New value: +[
+  "CA",
+  "CO",
+  "FL",
+  "MN",
+  "NJ",
+  "OR",
+  "TN",
+  "TX",
+  "VA",
+  "WA"
+]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). MN and NJ: the subtype or type DLI or DCA files. Null for OR and TX."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). MN and NJ: the subtype or type DLI or DCA files. TN: its board class ids in the trade. Null for OR and TX."
  3. Changed2 schema fields changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "CA",
-  "FL",
-  "MN",
-  "OR",
-  "TX",
-  "VA",
-  "WA"
-]New value: +[
+  "CA",
+  "FL",
+  "MN",
+  "NJ",
+  "OR",
+  "TX",
+  "VA",
+  "WA"
+]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). Null for OR and TX."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). MN and NJ: the subtype or type DLI or DCA files. Null for OR and TX."
  4. Changed1 schema field changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "CA",
-  "FL",
-  "OR",
-  "TX",
-  "VA",
-  "WA"
-]New value: +[
+  "CA",
+  "FL",
+  "MN",
+  "OR",
+  "TX",
+  "VA",
+  "WA"
+]
  5. Changed3 schema fields changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "FL",
-  "OR",
-  "TX",
-  "VA",
-  "WA"
-]New value: +[
+  "CA",
+  "FL",
+  "OR",
+  "TX",
+  "VA",
+  "WA"
+]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). Null for OR and TX."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). CA: the license's first classification in the trade (e.g. plumbing is C36). Null for OR and TX."
    • changedOutput schema / $defs / SearchResultOut / properties / status / description
      Previous value: -"As the state gives it: FL primary status 'C'/'P'/'S'; OR, TX and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'."New value: +"As the state gives it: FL primary status 'C'/'P'/'S'; CA primary status, e.g. 'CLEAR'; OR, TX and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'."
  6. Changed4 schema fields changed
    • changedInput schema / description
      Previous value: -"A two-letter state, a trade from that state's list, and a city or 5-digit zip."New value: +"A two-letter state, a trade from that state's list, and a city, 5-digit zip, or county."
    • changedInput schema / properties / city / description
      Previous value: -"Exact match after normalizing case and spaces, on addresses in the requested state. Exactly one of city or zip."New value: +"Exact match after normalizing case and spaces, on addresses in the requested state. Exactly one of city, zip or county."
    • addedInput schema / properties / county
      Added value: +{
+  "anyOf": [
+    {
+      "maxLength": 40,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Offered only where a state lists it. Exactly one of city, zip or county.",
+  "examples": [
+    "Harris"
+  ],
+  "title": "County"
+}
    • changedInput schema / properties / zip / description
      Previous value: -"5-digit ZIP (ZIP+4 accepted; the first 5 digits match)."New value: +"5-digit ZIP (ZIP+4 accepted; the first 5 digits match). Exactly one of city, zip or county."
  7. Changed5 schema fields changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "FL",
-  "OR",
-  "VA",
-  "WA"
-]New value: +[
+  "FL",
+  "OR",
+  "TX",
+  "VA",
+  "WA"
+]
    • changedInput schema / properties / trade / description
      Previous value: -"Offered per state. FL: alarm, demolition, drywall, electrical, garage_door, gas_line, general, glazing, hvac, irrigation, low_voltage, marine, plumbing, pollutant_storage, pool, pool_specialty, residential_electrical, roofing, sheet_metal, sign_electrical, solar, specialty_structure, underground_utility, window_door; OR: commercial_general, commercial_specialty, home_inspector, lead_paint, locksmith, residential_general, residential_specialty; VA: accessibility, alarm, alternative_energy, asbestos_lead, cabinets_finish_carpentry, commercial_general, commercial_improvement, concrete, drilling_blasting, drywall, electrical, elevator, environmental, farm_improvement, fire_protection, flooring, framing, gas_line, glazing, highway_heavy, home_improvement, hvac, industrial_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, marine, masonry, modular_building, painting, paving, plumbing, pool, radon_mitigation, recreational_facility, residential_general, roofing, sewer_septic, signs, steel_erection, tile, underground_utility, vessel_construction, well_drilling; WA: alarm, appliances, asbestos_lead, awnings, backflow, boiler_piping, cabinets_finish_carpentry, central_vacuum, closets, concrete, construction_cleanup, demolition, doors_gates, drain_cleaning, drilling_blasting, drywall, electrical, electrical_maintenance, elevator, excavation, fencing, fire_protection, fireproofing, flooring, framing, garage_door, general, glazing, gutters, handyman, house_moving, hvac, industrial_equipment, institutional_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, masonry, metal_fabrication, painting, paving, pest_control, plastering, plumbing, pool, pressure_washing, pump_irrigation, residential_electrical, roofing, sandblasting, scaffolding, service_station_equipment, sewer_septic, siding, sign_electrical, signs, steel_erection, stoves, suspended_ceilings, tanks, telecommunications, tile, tree_service, underground_utility, water_conditioning, welding, well_drilling, window_coverings."New value: +"A trade slug. Each state offers its own list: GET /v1/license/trades (free)"
    • removedInput schema / properties / trade / enum
      Removed value: -[
-  "accessibility",
-  "alarm",
-  "alternative_energy",
-  "appliances",
-  "asbestos_lead",
-  "awnings",
-  "backflow",
-  "boiler_piping",
-  "cabinets_finish_carpentry",
-  "central_vacuum",
-  "closets",
-  "commercial_general",
-  "commercial_improvement",
-  "commercial_specialty",
-  "concrete",
-  "construction_cleanup",
-  "demolition",
-  "doors_gates",
-  "drain_cleaning",
-  "drilling_blasting",
-  "drywall",
-  "electrical",
-  "electrical_maintenance",
-  "elevator",
-  "environmental",
-  "excavation",
-  "farm_improvement",
-  "fencing",
-  "fire_protection",
-  "fireproofing",
-  "flooring",
-  "framing",
-  "garage_door",
-  "gas_line",
-  "general",
-  "glazing",
-  "gutters",
-  "handyman",
-  "highway_heavy",
-  "home_improvement",
-  "home_inspector",
-  "house_moving",
-  "hvac",
-  "industrial_equipment",
-  "institutional_equipment",
-  "insulation",
-  "irrigation",
-  "landscaping",
-  "lead_paint",
-  "locksmith",
-  "low_voltage",
-  "manufactured_home_setup",
-  "marine",
-  "masonry",
-  "metal_fabrication",
-  "modular_building",
-  "painting",
-  "paving",
-  "pest_control",
-  "plastering",
-  "plumbing",
-  "pollutant_storage",
-  "pool",
-  "pool_specialty",
-  "pressure_washing",
-  "pump_irrigation",
-  "radon_mitigation",
-  "recreational_facility",
-  "residential_electrical",
-  "residential_general",
-  "residential_specialty",
-  "roofing",
-  "sandblasting",
-  "scaffolding",
-  "service_station_equipment",
-  "sewer_septic",
-  "sheet_metal",
-  "siding",
-  "sign_electrical",
-  "signs",
-  "solar",
-  "specialty_structure",
-  "steel_erection",
-  "stoves",
-  "suspended_ceilings",
-  "tanks",
-  "telecommunications",
-  "tile",
-  "tree_service",
-  "underground_utility",
-  "vessel_construction",
-  "water_conditioning",
-  "welding",
-  "well_drilling",
-  "window_coverings",
-  "window_door"
-]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). Null for OR."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). Null for OR and TX."
    • changedOutput schema / $defs / SearchResultOut / properties / status / description
      Previous value: -"As the state gives it: FL primary status 'C'/'P'/'S'; OR and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'."New value: +"As the state gives it: FL primary status 'C'/'P'/'S'; OR, TX and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'."
  8. Changed1 schema field changed
    • changedInput schema / description
      Previous value: -"Every input rule lives here, so an invalid body is refused before the 402 (#118)."New value: +"A two-letter state, a trade from that state's list, and a city or 5-digit zip."
  9. Changed5 schema fields changed
    • changedInput schema / properties / state / enum
      Previous value: -[
-  "FL",
-  "OR"
-]New value: +[
+  "FL",
+  "OR",
+  "VA",
+  "WA"
+]
    • changedInput schema / properties / trade / description
      Previous value: -"Offered per state. FL: alarm, demolition, drywall, electrical, garage_door, gas_line, general, glazing, hvac, irrigation, low_voltage, marine, plumbing, pollutant_storage, pool, pool_specialty, residential_electrical, roofing, sheet_metal, sign_electrical, solar, specialty_structure, underground_utility, window_door; OR: commercial_general, commercial_specialty, home_inspector, lead_paint, locksmith, residential_general, residential_specialty."New value: +"Offered per state. FL: alarm, demolition, drywall, electrical, garage_door, gas_line, general, glazing, hvac, irrigation, low_voltage, marine, plumbing, pollutant_storage, pool, pool_specialty, residential_electrical, roofing, sheet_metal, sign_electrical, solar, specialty_structure, underground_utility, window_door; OR: commercial_general, commercial_specialty, home_inspector, lead_paint, locksmith, residential_general, residential_specialty; VA: accessibility, alarm, alternative_energy, asbestos_lead, cabinets_finish_carpentry, commercial_general, commercial_improvement, concrete, drilling_blasting, drywall, electrical, elevator, environmental, farm_improvement, fire_protection, flooring, framing, gas_line, glazing, highway_heavy, home_improvement, hvac, industrial_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, marine, masonry, modular_building, painting, paving, plumbing, pool, radon_mitigation, recreational_facility, residential_general, roofing, sewer_septic, signs, steel_erection, tile, underground_utility, vessel_construction, well_drilling; WA: alarm, appliances, asbestos_lead, awnings, backflow, boiler_piping, cabinets_finish_carpentry, central_vacuum, closets, concrete, construction_cleanup, demolition, doors_gates, drain_cleaning, drilling_blasting, drywall, electrical, electrical_maintenance, elevator, excavation, fencing, fire_protection, fireproofing, flooring, framing, garage_door, general, glazing, gutters, handyman, house_moving, hvac, industrial_equipment, institutional_equipment, insulation, irrigation, landscaping, low_voltage, manufactured_home_setup, masonry, metal_fabrication, painting, paving, pest_control, plastering, plumbing, pool, pressure_washing, pump_irrigation, residential_electrical, roofing, sandblasting, scaffolding, service_station_equipment, sewer_septic, siding, sign_electrical, signs, steel_erection, stoves, suspended_ceilings, tanks, telecommunications, tile, tree_service, underground_utility, water_conditioning, welding, well_drilling, window_coverings."
    • changedInput schema / properties / trade / enum
      Previous value: -[
-  "alarm",
-  "commercial_general",
-  "commercial_specialty",
-  "demolition",
-  "drywall",
-  "electrical",
-  "garage_door",
-  "gas_line",
-  "general",
-  "glazing",
-  "home_inspector",
-  "hvac",
-  "irrigation",
-  "lead_paint",
-  "locksmith",
-  "low_voltage",
-  "marine",
-  "plumbing",
-  "pollutant_storage",
-  "pool",
-  "pool_specialty",
-  "residential_electrical",
-  "residential_general",
-  "residential_specialty",
-  "roofing",
-  "sheet_metal",
-  "sign_electrical",
-  "solar",
-  "specialty_structure",
-  "underground_utility",
-  "window_door"
-]New value: +[
+  "accessibility",
+  "alarm",
+  "alternative_energy",
+  "appliances",
+  "asbestos_lead",
+  "awnings",
+  "backflow",
+  "boiler_piping",
+  "cabinets_finish_carpentry",
+  "central_vacuum",
+  "closets",
+  "commercial_general",
+  "commercial_improvement",
+  "commercial_specialty",
+  "concrete",
+  "construction_cleanup",
+  "demolition",
+  "doors_gates",
+  "drain_cleaning",
+  "drilling_blasting",
+  "drywall",
+  "electrical",
+  "electrical_maintenance",
+  "elevator",
+  "environmental",
+  "excavation",
+  "farm_improvement",
+  "fencing",
+  "fire_protection",
+  "fireproofing",
+  "flooring",
+  "framing",
+  "garage_door",
+  "gas_line",
+  "general",
+  "glazing",
+  "gutters",
+  "handyman",
+  "highway_heavy",
+  "home_improvement",
+  "home_inspector",
+  "house_moving",
+  "hvac",
+  "industrial_equipment",
+  "institutional_equipment",
+  "insulation",
+  "irrigation",
+  "landscaping",
+  "lead_paint",
+  "locksmith",
+  "low_voltage",
+  "manufactured_home_setup",
+  "marine",
+  "masonry",
+  "metal_fabrication",
+  "modular_building",
+  "painting",
+  "paving",
+  "pest_control",
+  "plastering",
+  "plumbing",
+  "pollutant_storage",
+  "pool",
+  "pool_specialty",
+  "pressure_washing",
+  "pump_irrigation",
+  "radon_mitigation",
+  "recreational_facility",
+  "residential_electrical",
+  "residential_general",
+  "residential_specialty",
+  "roofing",
+  "sandblasting",
+  "scaffolding",
+  "service_station_equipment",
+  "sewer_septic",
+  "sheet_metal",
+  "siding",
+  "sign_electrical",
+  "signs",
+  "solar",
+  "specialty_structure",
+  "steel_erection",
+  "stoves",
+  "suspended_ceilings",
+  "tanks",
+  "telecommunications",
+  "tile",
+  "tree_service",
+  "underground_utility",
+  "vessel_construction",
+  "water_conditioning",
+  "welding",
+  "well_drilling",
+  "window_coverings",
+  "window_door"
+]
    • changedOutput schema / $defs / SearchResultOut / properties / class_code / description
      Previous value: -"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade, and for OR."New value: +"FL: the license's class when the trade names a class inside its license type (e.g. SCC glazing is class GLZ); null when the whole type is the trade. WA: the specialty that matched the trade (e.g. CC roofing is CD). VA: the license's first specialty in the trade (e.g. hvac is HVA or REF). Null for OR."
    • changedOutput schema / $defs / SearchResultOut / properties / status / description
      Previous value: -"As the state gives it: FL primary status 'C'/'P'/'S'; OR 'active'/'expired'."New value: +"As the state gives it: FL primary status 'C'/'P'/'S'; OR and VA 'active'/'expired'; WA the L&I status, e.g. 'ACTIVE'."
  10. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the read-only/open-world/idempotent profile, and the description adds genuinely useful behavior beyond them: $0.05 per call with x402 payment via _meta, MPP on the HTTP URL, max 25 results ordered active-first with total_matches, and that empty results are still a paid 200. It stops short of detailing auth/error handling beyond payment.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The payment/pricing lead is well front-loaded, but the inline enumeration of hundreds of trade slugs per state is enormous, and the schema already points to a free endpoint for that list. The volume crowds out the operationally important content and makes the definition hard to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values needn't be restated, yet the description lists them anyway while omitting usage routing against license_verify. Payment, result cap, and ordering are complete, but selection guidance relative to siblings is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is moderate (57%), and the description does compensate for the trade parameter by enumerating per-state trade slugs and naming the free /v1/license/trades endpoint. However, limit and active_only get no description-level meaning, and city/zip/county semantics are left to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — searching licensed contractors by state/trade and city, zip, or county — and enumerates the returned fields (license number, name, class, status, expiry, address). This clearly separates it from the sibling license_verify, which handles single-license verification. An agent can select it without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implies usage context (lookup by location + trade, cost per call, paid empty 200), but never states when to prefer this over license_verify or other lookup siblings, nor when not to use it. The 'exactly one of city, zip or county' constraint is only conveyed via the schema, not the description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Flipvo: licenses, entities, NPI, OFAC and OIG screens, carriers, OSHA, drive times toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources