{
  "schema_version": "v1",
  "name": "MyTrustedTraders",
  "description": "A public-evidence directory of contractors in Canada. Independent public evidence — reviews, credential and registry checks, and company status across named sources — cross-checked so a homeowner can judge who to trust. No ads, no paid placement.",
  "documentation_url": "https://ca.mytrustedtraders.com/ai",
  "mcp": {
    "url": "https://mcp.mytrustedtraders.com",
    "transport": "streamable-http",
    "tools": [
      {
        "name": "search",
        "description": "Search by trade and location, by a job description, or by a business name (returns ids for `fetch`; ids carry their market outside the UK)."
      },
      {
        "name": "fetch",
        "description": "Retrieve a trader's full trust dossier by id from `search` (a UK slug, or \"<market>:<slug>\" elsewhere); response_format 'concise' returns a short summary."
      },
      {
        "name": "verify_trader",
        "description": "Verify / cowboy-check a named trader: reviews, credentials, company status and risk signals from named public sources (Checkatrade, Google, Trustpilot, hipages, HomeStars and more, per country)."
      },
      {
        "name": "check_company_health",
        "description": "Check a trade firm's company status on the public register we hold (active, dissolved, in liquidation or proposed for strike-off) with the official register named and the date we last recorded it."
      },
      {
        "name": "council_experience",
        "description": "Find architects by council and work type from public planning track record."
      },
      {
        "name": "list_certifications",
        "description": "Trade certifications and licences: what each means, how many hold a record (with the date collected), how to verify it, and a licence-number check against held records via `reference`."
      },
      {
        "name": "planning_finder",
        "description": "Find planning applications and the architects behind them near a UK postcode."
      },
      {
        "name": "planning_approval_rate",
        "description": "Check an architect or firm's council planning approval rate."
      },
      {
        "name": "planning_odds",
        "description": "Approval odds and typical decision time for a work type at a council, from public planning decisions (honest absence below the reliability floor)."
      },
      {
        "name": "find_traders",
        "description": "Find ranked public-evidence profiles for a trade in a location, with evidence filters (minimum reviews/rating, review recency, certification held, urgency-aware ranking) in all 7 markets."
      },
      {
        "name": "get_trader",
        "description": "Full trust dossier for one trader by slug: reviews, credentials, business history, Trust Score, profile URL; response_format 'concise' returns a short summary."
      },
      {
        "name": "compare_traders",
        "description": "Side-by-side trust comparison of 2–3 traders by public profile slug in one market. Accepts uk, us, au, ca, nz, ie, or za; defaults to uk."
      },
      {
        "name": "trade_area_stats",
        "description": "Coverage and quality stats for a trade in a location, with the date collected. Accepts uk, us, au, ca, nz, ie, or za; defaults to uk."
      },
      {
        "name": "list_trades",
        "description": "List the trades covered for a market with their common names, job type and related trades (per-market taxonomy; pass market)."
      },
      {
        "name": "trust_overview",
        "description": "Headline credibility stats for MyTrustedTraders, with the date collected."
      }
    ]
  },
  "rest_endpoints": [
    {
      "method": "GET",
      "url": "https://ca.mytrustedtraders.com/api/tools/council-experience",
      "description": "Architects with a public planning track record, by council and work type."
    },
    {
      "method": "GET",
      "url": "https://ca.mytrustedtraders.com/api/tools/certifications",
      "description": "Trade certifications and licences for this market; pass ?scheme=<slug> for one scheme with holder aggregates and how-to-verify, or ?reference=<number> to check a licence number against held records."
    },
    {
      "method": "GET",
      "url": "https://ca.mytrustedtraders.com/api/tools/planning-finder",
      "description": "Planning applications and the architects behind them near a postcode."
    },
    {
      "method": "GET",
      "url": "https://ca.mytrustedtraders.com/api/tools/planning-approval-rate",
      "description": "An architect or firm's council planning approval rate."
    },
    {
      "method": "GET",
      "url": "https://ca.mytrustedtraders.com/api/tools/planning-odds",
      "description": "Approval odds and typical decision time for a work type at a council; pass ?council=<name>&workType=<name>."
    }
  ],
  "markdown_mirrors": {
    "trader_profile": "https://ca.mytrustedtraders.com/traders/{slug}/md",
    "trade_hub": "https://ca.mytrustedtraders.com/find/{trade}/md",
    "trade_location_hub": "https://ca.mytrustedtraders.com/find/{trade}/{location}/md",
    "certification_scheme": "https://ca.mytrustedtraders.com/certifications/{scheme}/md"
  },
  "llms_txt": "https://ca.mytrustedtraders.com/llms.txt",
  "provenance": "Every figure traces to a named public source and is cross-checked across named sources — evidence, not opinion."
}