{
  "$schema": "https://modelcontextprotocol.io/schemas/well-known-manifest-v1.json",
  "protocolVersion": "2025-03-26",
  "name": "askbaily",
  "displayName": "AskBaily",
  "description": "Public Model Context Protocol manifest for AskBaily — the AI-native renovation matching platform. Discoverable read-only resources covering 84 cities, 48 jurisdictions of live contractor licensing data, 19 CC-BY-4.0 Datasets, 1,820+ structured Q&A entries (EN + ES), 8 competitor fact sheets, 20 regulatory change entries, 9,559-URL indexed surface, /aeo-status public citation-share scorecard, and a real-time license-lookup tool. Updated Waves 136-157 (2026-04-22 → 2026-04-23).",
  "vendor": {
    "name": "AskBaily",
    "url": "https://askbaily.com",
    "supportEmail": "press@askbaily.com"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "generatedAt": "2026-04-23T10:00:00Z",
  "capabilities": {
    "resources": true,
    "tools": true,
    "prompts": false,
    "logging": false,
    "sampling": false
  },
  "resources": [
    {
      "uri": "https://askbaily.com/facts/askbaily.json",
      "name": "askbaily.master-facts",
      "description": "Master self-description fact sheet — operating model, 81-city footprint, 17 regulators integrated, tiered take-rate, parent NPLD CSLB #1105249.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/facts/askbaily-vs-angi.json",
      "name": "askbaily.vs-angi",
      "description": "Structured comparison against Angi — shared-lead marketplace economics, FTC HomeAdvisor settlement context, 15-25 sourced facts.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/facts/askbaily-vs-thumbtack.json",
      "name": "askbaily.vs-thumbtack",
      "description": "Structured comparison against Thumbtack — pay-per-contact model, Top-Pro badges, 3-15-way fan-out.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/facts/askbaily-vs-houzz.json",
      "name": "askbaily.vs-houzz",
      "description": "Structured comparison against Houzz — directory + inspiration platform, complementary-for-discovery boundary.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/facts/askbaily-vs-taskrabbit.json",
      "name": "askbaily.vs-taskrabbit",
      "description": "Structured comparison against TaskRabbit — hourly-Tasker vs renovation-scale contract unit boundary.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/cities.json",
      "name": "askbaily.cities",
      "description": "84-city inventory with country, region, regulator, and licensing metadata. Non-deferred (Beijing + Shanghai excluded pending PRC ICP).",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/partners.json",
      "name": "askbaily.partners",
      "description": "Wave 154 — partner network coverage across 83 cities. Single-pro-per-city routing model (1 active NPLD-LA, 82 waitlist/pending-signup). Schema.org Dataset, CC-BY-4.0. Zero incumbent (Angi/Thumbtack/Houzz) publishes equivalent structured data.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/cost/{city}.json",
      "name": "askbaily.cost-by-city",
      "description": "Per-city 2026 renovation cost dataset (medianKitchen/Bathroom/FullHome + per-square-foot + permitTimelineWeeks + regulatoryAuthority). Available cities: london, sydney, melbourne, singapore, auckland, dubai, nyc, miami, chicago. Schema.org Dataset.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/regulatory/{city}.json",
      "name": "askbaily.regulatory-by-city",
      "description": "Per-city regulatory authorities dataset with statutory basis, jurisdiction, governed scope, official .gov URLs, complaint portals. Covers NYC (DOB/DCWP/LPC/FDNY/DEP), Miami (CILB/Miami-Dade/Broward/FEMA), Chicago (CDOB/BACP/IDFPR/Landmarks), London, Sydney, Melbourne, Singapore, Auckland, Dubai.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/regulatory.json",
      "name": "askbaily.regulatory-entities",
      "description": "Regulatory entity registry with 13 canonical bodies (CSLB, NYC DOB, UK Building Regs, NSW Fair Trading, Ontario HCRA, Singapore BCA, Dubai DM, etc.) + full GovernmentOrganization graph.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/pillars.json",
      "name": "askbaily.pillars",
      "description": "68 Tier-1 content pillar catalog — city × service × regulatory-specific guidance pages.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/topics.json",
      "name": "askbaily.topic-clusters",
      "description": "6 topic-cluster hubs (ADU, seismic, historic renovation, masonry-facade, basement-waterproofing, condo alteration).",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/pros.json",
      "name": "askbaily.pros",
      "description": "Matched-contractor directory. Currently 1 partner (Netanel Presman / NPLD CSLB #1105249); grows as BD onboards.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/research.json",
      "name": "askbaily.research-reports",
      "description": "Research report inventory — Phoenix market, NYC renovation, condo-alteration deep dives.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/faq/index.json",
      "name": "askbaily.faq-index-en",
      "description": "Index of 81 English per-city contractor-verification FAQ endpoints. Each city exposes 20 Q&A pairs.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/faq/{city}.json",
      "name": "askbaily.faq-en",
      "description": "20 Q&A per city (EN). Template URI — substitute {city} with any slug from data/cities.json.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/faq-es/index.json",
      "name": "askbaily.faq-index-es",
      "description": "Index of 10 Spanish per-city contractor-verification FAQ endpoints. Hispanic-heavy US metros.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/data/faq-es/{city}.json",
      "name": "askbaily.faq-es",
      "description": "20 Q&A per city (ES-US). LA, Miami, NYC, Chicago, Phoenix, Houston, Dallas, SD, LV, SF.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/feed/regulatory-updates.json",
      "name": "askbaily.regulatory-feed",
      "description": "JSON Feed v1.1 of 20 source-linked regulatory changes across 17 jurisdictions (CA SB 1103/AB 1033/SB 9, NYC LL97, WA L&I, FL CILB, UK Building Safety Act, NSW HBA, Dubai DM, etc.).",
      "mimeType": "application/feed+json"
    },
    {
      "uri": "https://askbaily.com/feed/regulatory-updates.xml",
      "name": "askbaily.regulatory-feed-rss",
      "description": "RSS 2.0 mirror of the regulatory feed, subscribable by journalist aggregators (NYT, WSJ, Forbes Home, CNBC Make It).",
      "mimeType": "application/rss+xml"
    },
    {
      "uri": "https://askbaily.com/feed/content-freshness.json",
      "name": "askbaily.content-freshness",
      "description": "188-entry manifest signaling lastRefreshed timestamps across core + /for-pros/{city} + /safety/{city} pages. Consumer: AI-citation engines prioritizing freshness.",
      "mimeType": "application/json"
    },
    {
      "uri": "https://askbaily.com/llms.txt",
      "name": "askbaily.llms-txt",
      "description": "llms.txt discovery manifest following llmstxt.org spec. Human + machine-readable entry-point guide for AI crawlers.",
      "mimeType": "text/plain"
    },
    {
      "uri": "https://askbaily.com/llms-full.txt",
      "name": "askbaily.llms-full-txt",
      "description": "Full-corpus single-URL intake: all 32 Phase 17 pillars + arc summary concatenated as plain markdown (~106K words).",
      "mimeType": "text/plain"
    }
  ],
  "tools": [
    {
      "name": "license_lookup_validate",
      "description": "Validates the format of a contractor license number against per-jurisdiction regex and returns a regulator deep-link for live verification. 17 jurisdictions supported (CA, AZ, TX, FL, NY, NY-NYC, WA, NV, GA, IL, Ontario, UK, NSW, VIC, NZ, SG, Dubai). Does NOT query regulators directly (rate-limit protection) — returns the URL the client should open.",
      "inputSchema": {
        "type": "object",
        "required": ["jurisdiction", "licenseNumber"],
        "properties": {
          "jurisdiction": {
            "type": "string",
            "enum": ["CA", "AZ", "TX", "FL", "NY", "NY-NYC", "WA", "NV", "GA", "IL", "ON", "UK", "AU-NSW", "AU-VIC", "NZ", "SG", "AE-DUBAI"],
            "description": "ISO-ish jurisdiction code."
          },
          "licenseNumber": {
            "type": "string",
            "description": "Contractor license number as issued by the regulator."
          }
        }
      },
      "publicUrl": "https://askbaily.com/tools/license-lookup"
    },
    {
      "name": "cac_compared_calculate",
      "description": "Computes a contractor's 12-month CAC burden on 8 shared-lead / pay-per-contact platforms vs AskBaily's tiered 8-15% take-rate on closed jobs only. Inputs: current platform, avg project value, close rate %, leads per month. Returns: side-by-side annual spend, cost per close, % of revenue, annual savings.",
      "inputSchema": {
        "type": "object",
        "required": ["platform", "avgProjectValue", "closeRatePct", "leadsPerMonth"],
        "properties": {
          "platform": {
            "type": "string",
            "enum": ["angi", "thumbtack", "homeadvisor", "bark", "mybuilder", "checkatrade", "hipages", "myhammer"]
          },
          "avgProjectValue": { "type": "number", "minimum": 1000, "maximum": 2000000 },
          "closeRatePct": { "type": "number", "minimum": 1, "maximum": 100 },
          "leadsPerMonth": { "type": "number", "minimum": 1, "maximum": 1000 }
        }
      },
      "publicUrl": "https://askbaily.com/tools/cac-compared"
    }
  ],
  "transport": {
    "discovery": "This well-known manifest is the discovery entry point. No OAuth or auth required for read-only resources. MCP clients should fetch the JSON resources listed above directly.",
    "interactiveTools": "The listed tools are interactive HTML widgets at their publicUrl. MCP agents that cannot run browser JS should instead reference the underlying data: lib/licensing/registry.ts for license_lookup_validate formatting rules; /facts/*.json for platform-economics inputs to cac_compared_calculate."
  },
  "partnerTier": {
    "rpcEndpoint": "https://askbaily.com/api/oracle/v1/rpc",
    "healthEndpoint": "https://askbaily.com/api/oracle/v1/health",
    "toolsEndpoint": "https://askbaily.com/api/oracle/v1/tools",
    "protocolVersion": "2025-06-18",
    "auth": "Bearer ORACLE_PARTNER_TOKEN. Each AI-search-engine partner gets a per-partner token; identity tagged via X-Agent-Id header (optional, defaults to partner_default).",
    "rateLimit": "200 actions per hour per agent (token-bucket).",
    "writeActions": [
      {
        "name": "submit_scope",
        "fee": "1% of project value (min $1)",
        "description": "Turn a homeowner's natural-language description into a saved AskBaily project scope. Returns a stable scope_id partners can cite.",
        "inputSchema": {
          "natural_language": "string (10-10000 chars)",
          "location": { "city_slug": "string", "zip": "string (5 or 9 digit)" },
          "homeowner_contact": { "phone_e164": "string", "name": "string (optional)" }
        }
      },
      {
        "name": "book_consultation",
        "fee": "flat $0.50",
        "description": "Book a time window with a specific pro. Returns booking_id with status=pending until pro confirms.",
        "inputSchema": {
          "pro_id": "string",
          "time_window": { "start_iso": "ISO-8601", "end_iso": "ISO-8601" },
          "homeowner_phone_e164": "string"
        }
      },
      {
        "name": "start_project",
        "fee": "5% of project value (closed-match)",
        "description": "Promote an accepted scope+pro pair to an active AskBaily project. Returns project_id.",
        "inputSchema": {
          "scope_id": "string",
          "accepted_pro_id": "string",
          "estimated_value_usd": "integer (1 - 50000000)"
        }
      },
      {
        "name": "request_review_collection",
        "fee": "flat $0.25",
        "description": "Queue a homeowner review-collection request via SMS or email through n8n WF61.",
        "inputSchema": {
          "project_id": "string",
          "channel": "sms | email"
        }
      },
      {
        "name": "dispatch_negotiation",
        "fee": "flat $1.00",
        "description": "Open a Baily-mediated dispute-resolution flow between a homeowner and a pro.",
        "inputSchema": {
          "project_id": "string",
          "dispute": { "category": "scope_change | timeline_slip | price_change | quality_complaint | communication_breakdown", "summary": "string (10-5000 chars)" }
        }
      }
    ]
  },
  "crossReferences": {
    "humanReadable": "https://askbaily.com/mcp",
    "openApiSpec": "https://askbaily.com/data/openapi.json",
    "llmsTxt": "https://askbaily.com/llms.txt",
    "sitemap": "https://askbaily.com/sitemap.xml",
    "pressKit": "https://askbaily.com/press"
  }
}