Local Trades Kit

Working · 163 ms

com.modernmustardseed/trades-kitv1.0.0 Domain verified

US data for home-service trades: service-area ZIPs, seasonal demand, review timing, service pages.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.modernmustardseed.com/trades-kit

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

list_trades Read-only

List every trade the kit covers with its id, common names it matches, its 2022 NAICS industry code and its job type ids. Static reference.

This tool takes no arguments.

Tools (5)

list_trades

List every trade the kit covers with its id, common names it matches, its 2022 NAICS industry code and its job type ids. Static reference.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

review_request_timing

Plan when and how a home-service business asks customers for reviews, by trade and job type: what to say at completion, the window for the one written request (with dates when a completion date is given), the moment the customer can first judge the work, and the rules that apply, from Google Maps policy, Yelp, the FTC consumer review rule (16 CFR 465) and the TCPA for texts, each cited with an as-of date. Includes the field-experiment and survey findings the timing rests on. Informational, not legal advice.

read-only

Argument	Type	Description
trade*	string	The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as "plumber" or "AC repair".
job_type	string	One job type id from list_trades, such as water_heater, replacement or mowing, or a job class (repair, install, project, recurring, emergency, inspection). Leave out to get every job type for the trade.
completed_on	string	The date the job was finished, YYYY-MM-DD, to get the request window as dates.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trade"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "job_type": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "One job type id from list_trades, such as water_heater, replacement or mowing, or a job class (repair, install, project, recurring, emergency, inspection). Leave out to get every job type for the trade."
    },
    "completed_on": {
      "type": "string",
      "maxLength": 10,
      "description": "The date the job was finished, YYYY-MM-DD, to get the request window as dates."
    }
  }
}

seasonal_demand

Show the busy and slow months for a home-service trade in a US state, a NOAA climate region (Northeast, Upper Midwest, Ohio Valley, Southeast, Northern Rockies and Plains, South, Southwest, Northwest, West) or the whole country. The month-by-month index is measured from BLS QCEW private-sector employment for the trade's NAICS industry, 2022 to 2024. Beside it: NOAA 1991-2020 monthly temperature, degree day and precipitation normals for the same area, and seasonal drivers for the trade (tune-up seasons, freeze months, hurricane season, lawn fertilization windows, termite swarms and others) where a public source supports them. Every claim carries its source.

read-only

Argument	Type	Description
state	string	A US state: two-letter code (MT) or full name (Montana).
trade*	string	The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as "plumber" or "AC repair".
region	string	Instead of a state, a NOAA climate region: Northeast, Upper Midwest, Ohio Valley, Southeast, Northern Rockies and Plains, South, Southwest, Northwest, West.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trade"
  ],
  "properties": {
    "state": {
      "type": "string",
      "maxLength": 30,
      "minLength": 2,
      "description": "A US state: two-letter code (MT) or full name (Montana)."
    },
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "region": {
      "type": "string",
      "maxLength": 40,
      "minLength": 4,
      "description": "Instead of a state, a NOAA climate region: Northeast, Upper Midwest, Ohio Valley, Southeast, Northern Rockies and Plains, South, Southwest, Northwest, West."
    }
  }
}

service_area

Work out what a local service business covers. Give a base (a 5-digit ZIP or "City, ST") and a radius in miles, or a list of ZIPs. Returns every ZIP Code Tabulation Area inside it with distance, population, housing units and owner-occupied homes; the cities, towns and Census places inside it; the counties it touches with the population inside the area; totals; and up to 20 candidate areas for a Google Business Profile service area with Google's written rules. Uses Census Gazetteer, relationship-file and ACS 2020-2024 data stored on the server. Distances are straight-line miles, not driving distance.

read-only

Argument	Type	Description
base	string	Where the business is based: a 5-digit ZIP such as 59901, or a city with its state such as "Kalispell, MT". Use with radius_miles.
zips	array	Instead of a base and radius: the ZIPs the business serves.
max_zips	integer	How many ZIPs to list (default and maximum 250). Totals always count every ZIP.
radius_miles	number	Straight-line radius in miles, 1 to 100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "base": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Where the business is based: a 5-digit ZIP such as 59901, or a city with its state such as \"Kalispell, MT\". Use with radius_miles."
    },
    "zips": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 10
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "Instead of a base and radius: the ZIPs the business serves."
    },
    "max_zips": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "How many ZIPs to list (default and maximum 250). Totals always count every ZIP."
    },
    "radius_miles": {
      "type": "number",
      "maximum": 100,
      "minimum": 1,
      "description": "Straight-line radius in miles, 1 to 100."
    }
  }
}

trade_service_pages

List the standard website page set for a home-service trade: home, services hub, one page per core service with what it must cover, projects, service area, reviews, about, questions and contact, plus location pages for up to 20 cities. Comes with Google's written rules on doorway pages, people-first content, LocalBusiness structured data and business names, each cited. The service taxonomy is curated per trade and mapped to the trade's 2022 NAICS industry.

read-only

Argument	Type	Description
trade*	string	The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as "plumber" or "AC repair".
cities	array	Towns the business really serves, for location pages, such as ["Whitefish, MT", "Columbia Falls, MT"].
emergency_service	boolean	Whether the business takes emergency or after-hours calls. Defaults to what is typical for the trade.
maintenance_plans	boolean	Whether the business sells recurring service or maintenance plans. Defaults to what is typical for the trade.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trade"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80,
        "minLength": 2
      },
      "maxItems": 20,
      "description": "Towns the business really serves, for location pages, such as [\"Whitefish, MT\", \"Columbia Falls, MT\"]."
    },
    "emergency_service": {
      "type": "boolean",
      "description": "Whether the business takes emergency or after-hours calls. Defaults to what is typical for the trade."
    },
    "maintenance_plans": {
      "type": "boolean",
      "description": "Whether the business sells recurring service or maintenance plans. Defaults to what is typical for the trade."
    }
  }
}