mcp-server

Search for verified service professionals in Argentina by service type, city, neighborhood, verification status, minimum rating, and minimum review count. Returns a paginated list of professionals with display name, headline, ratings, verifications, and a `profile_url` that is the only sanctioned contact channel (no phone/email/whatsapp is ever returned). Use this for discovery; use `muovi_get_professional` for the full detail payload.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "minLength": 1,
      "description": "Service slug (e.g. \"electricidad\"). Matches `Service.slug` in the catalog."
    },
    "city": {
      "type": "string",
      "minLength": 1,
      "description": "City slug (e.g. \"caba\"). Matches `City.slug` in the catalog."
    },
    "neighborhood": {
      "type": "string",
      "minLength": 1,
      "description": "Neighborhood slug (e.g. \"palermo\"). Matches `Neighborhood.slug` in the catalog."
    },
    "verified_identity": {
      "type": "boolean",
      "description": "When true, only return pros whose identity has been verified by Muovi."
    },
    "has_matricula": {
      "type": "boolean",
      "description": "When true, only return pros with a verified professional matrícula on file (electricians, gas fitters, etc.)."
    },
    "min_rating": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "Minimum blended average rating, 0-5 inclusive."
    },
    "min_reviews": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum blended review count."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum number of results per page (default 20, max 50)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Zero-based offset into the result set for pagination."
    }
  },
  "additionalProperties": false
}

Fetch the full public profile for a single Muovi-verified professional by slug. Returns display name, headline, bio, portfolio image URLs, specialties, city + neighborhoods, services, ratings, verifications, and the canonical `profile_url`. The `profile_url` is the only sanctioned contact channel — phone, email, and whatsapp are never returned. Append `?create_task=1&service={slug}` to `profile_url` (or use `muovi_create_task_link`) to deep-link a user into the on-platform task creation flow targeted at this pro.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "The professional's URL-safe slug (e.g. \"juan-p-electricista-caba\"). Obtain from `muovi_search_professionals`."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

List every service category Muovi supports in Argentina — home trades (electricidad, plomería, gas, pintura, carpintería, cerrajería, albañilería, herrería, techista), limpieza, jardinería, aire acondicionado, and moving/hauling: mudanzas (movers) and fletes (light freight/hauling). Every listed professional is identity-verified and reviewed, with on-platform payment and dispute resolution. Each entry has a stable `slug` (used as the `service` parameter on `muovi_search_professionals` and `muovi_create_task_link`), a human-readable `name`, an optional description, and a `requires_matricula` flag indicating whether listed professionals must hold a verified professional license. Call this first when you need to map a user's natural-language request to a Muovi service slug.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List every Argentine city Muovi serves, with active neighborhoods nested under each. Each city has a stable `slug` (used as the `city` parameter on `muovi_search_professionals`) and a human-readable `name`. Each neighborhood has its own `slug` (used as the `neighborhood` parameter on `muovi_search_professionals`). Call this when you need to resolve a user's location wording to a Muovi city or neighborhood slug.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Fetch paginated reviews for a single Muovi-verified professional, sorted most-recent first. Each review has a 1-5 rating, an optional title and free-text comment, the author's reduced display name (e.g. "María G." — full surnames are never returned), the author role (`client` or `worker`), the service category the review is associated with, and an ISO `created_at` timestamp. Use this to surface social-proof when recommending a professional.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "The professional's URL-safe slug. Obtain from `muovi_search_professionals` or `muovi_get_professional`."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum number of reviews per page (default 20, max 50)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Zero-based offset into the review list for pagination."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Build the canonical Muovi deep-link that opens the on-platform task creation flow pre-filled with a specific professional and service. Returns a URL of the form `https://muovi.com.ar/p/{slug}?create_task=1&service={service-slug}`. This is a pure formatter — it makes no network call and creates no task. After running it, surface the URL to the user so they can complete the booking on Muovi. Muovi never lets agents create tasks server-side; the consumer always sees the on-platform flow to confirm details.

{
  "type": "object",
  "properties": {
    "professional_slug": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z0-9][a-z0-9.\\-]*$",
      "description": "The professional's URL-safe slug (from `muovi_search_professionals` or `muovi_get_professional`)."
    },
    "service_slug": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-z0-9][a-z0-9.\\-]*$",
      "description": "The service slug to pre-fill in the task flow (from `muovi_list_services`)."
    }
  },
  "required": [
    "professional_slug",
    "service_slug"
  ],
  "additionalProperties": false
}