bymundi API

Suggest saved routes for a day

The suggest_routes MCP tool: suggest saved routes for a day.

suggest_routes · read-only

MCP only (no REST operation).

What the model reads

Suggests the agency's saved routes (Catalog → Routes) that fit one day of a trip, best first, each with its fit score, stops and what it is (profiles, traits); it does not time them — plan_day (or fill_days with dryRun) says whether one fits and when. rejected lists routes of this destino that do NOT fit, with why; fill_days refuses those. emphasize weights profiles (e.g. cultural, gastronomia). Pass a candidate's routeId to plan_day or fill_days.

Permissions: trips:read, catalog:read.

Input

Field Type Required Description
tripId uuid yes
day string yes The day (dia): its ref from get_itinerary, or its id. max 64 chars
emphasize "primera_vez" | "repetidor" | "familia_ninos" | "pareja" | "grupo" | "senior" | "movilidad_reducida" | "cultural" | "gastronomico" | "naturaleza" | "fotografia" | "otaku" | "compras" | "presupuesto_ajustado" | "premium"[] max 5 items
limit integer 1–5

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tripId": {
      "type": "string",
      "format": "uuid"
    },
    "day": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "The day (`dia`): its ref from get_itinerary, or its id."
    },
    "emphasize": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "primera_vez",
          "repetidor",
          "familia_ninos",
          "pareja",
          "grupo",
          "senior",
          "movilidad_reducida",
          "cultural",
          "gastronomico",
          "naturaleza",
          "fotografia",
          "otaku",
          "compras",
          "presupuesto_ajustado",
          "premium"
        ]
      },
      "maxItems": 5
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "tripId",
    "day"
  ],
  "additionalProperties": false
}