{
  "schema_version": "v1",
  "name": "Hire Local Crew — Local Services Agent API",
  "description": "Agent-callable API for discovering and quoting local home-service providers (tree removal, plumbing, HVAC, roofing, landscaping, and ~25 other trades) across the U.S. Southeast. Every endpoint is read + write structured. Read endpoints are public; write endpoints (quote, future bookings) accept an optional API key for attribution + higher rate limits.",
  "contact": {
    "email": "agents@hirelocalcrew.com",
    "website": "https://hirelocalcrew.com/agents"
  },
  "capabilities": {
    "provider_search": true,
    "provider_detail": true,
    "availability_query": true,
    "quote_request": true,
    "booking": false,
    "escrow": false,
    "reviews_read": true,
    "reviews_write": false
  },
  "endpoints": {
    "openapi_spec": "https://hirelocalcrew.com/api/agent/v1/openapi.json",
    "services_list": "https://hirelocalcrew.com/api/agent/v1/services",
    "locations_list": "https://hirelocalcrew.com/api/agent/v1/locations",
    "providers_search": "https://hirelocalcrew.com/api/agent/v1/providers",
    "provider_detail": "https://hirelocalcrew.com/api/agent/v1/providers/{id}",
    "provider_availability": "https://hirelocalcrew.com/api/agent/v1/providers/{id}/availability",
    "quote_request": "https://hirelocalcrew.com/api/agent/v1/quote",
    "booking_request": "https://hirelocalcrew.com/api/agent/v1/bookings"
  },
  "mcp": {
    "server_url": "https://hirelocalcrew.com/api/mcp",
    "protocol": "json-rpc-2.0",
    "transport": [
      "http",
      "streamable-http"
    ],
    "manifest_url": "https://hirelocalcrew.com/.well-known/mcp.json"
  },
  "auth": {
    "type": "bearer",
    "header": "Authorization: Bearer {api_key}",
    "register_url": "https://hirelocalcrew.com/agents#register",
    "anonymous_access": {
      "allowed": true,
      "rate_limit_per_ip": "100/hour"
    }
  },
  "rate_limits": {
    "registered_default": "10000/day",
    "registered_partner": "100000/day"
  },
  "standards": {
    "openapi": "3.1",
    "mcp": "2025-06-18",
    "schema_org": [
      "LocalBusiness",
      "Service",
      "OfferCatalog",
      "Review",
      "AggregateRating"
    ]
  },
  "roadmap": {
    "phase_b": [
      "bookings",
      "availability_realtime",
      "stripe_escrow"
    ],
    "phase_c": [
      "agent_passport_provider_identity",
      "verifiable_credentials"
    ]
  }
}