guide-webmcp.vercel.app

{
  "name": "get_portal_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read what Robert currently sees in the fictional Northstar Health portal, including bounded component personalization, human overrides, and pending actions. Calibration attempts and simulator state are intentionally excluded. Call this before continuing a shared workflow.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_northstar_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read Northstar’s supported goals, complete workflow steps, current availability, blocked and future actions, human decisions, consequential boundaries, assistance levels, and bounded interface adaptations. Use this instead of guessing from the visual layout.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "personalize_for_task",
  "kind": "act",
  "impl": "imperative",
  "description": "Primary personalization capability. Immediately compose Northstar’s existing semantic regions around the person’s goal, functional difficulty, presentation preferences, and desired help level. Use one call for requests such as “show me only what matters, use simple language, and help me reschedule, but let me choose the time” or for an initial response to difficult controls. This may open the non-committing chooser, but it never selects a time, confirms an appointment, changes permissions, hides required warnings, or injects arbitrary interface code. Reuse this tool to refine the live arrangement, such as switching between step-by-step and one-page presentation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "goal": {
        "type": "string",
        "enum": [
          "reschedule_appointment"
        ],
        "description": "The supported Northstar outcome the interface should prioritize."
      },
      "assistanceLevel": {
        "type": "string",
        "enum": [
          "show",
          "explain",
          "guide",
          "collaborate",
          "act"
        ],
        "description": "How much help to present. This never replaces confirmation rules."
      },
      "informationDensity": {
        "type": "string",
        "enum": [
          "focused",
          "balanced",
          "detailed"
        ],
        "description": "How prominently primary and supporting information are presented."
      },
      "languageStyle": {
        "type": "string",
        "enum": [
          "standard",
          "plain"
        ],
        "description": "Whether labels use standard portal language or plainer task language."
      },
      "workflowLayout": {
        "type": "string",
        "enum": [
          "step-by-step",
          "one-page"
        ],
        "description": "Whether workflow choices and review appear sequentially or together."
      },
      "navigationPresentation": {
        "type": "string",
        "enum": [
          "focused",
          "full"
        ],
        "description": "Focused keeps unrelated sections discoverable under progressive disclosure; full shows all section controls."
      },
      "guideVisibility": {
        "type": "string",
        "enum": [
          "visible",
          "minimal"
        ],
        "description": "Whether Guide visibly points and explains after the immediate website transformation."
      },
      "timeSelection": {
        "type": "string",
        "enum": [
          "person",
          "shared"
        ],
        "description": "Who may choose a replacement time. Use person when the person says they want to choose."
      },
      "regionAdjustments": {
        "type": "array",
        "maxItems": 6,
        "description": "Optional bounded adjustments to website-authored semantic regions. Unsupported combinations are ignored.",
        "items": {
          "type": "object",
          "properties": {
            "region": {
              "type": "string",
              "enum": [
                "primary_navigation",
                "appointment_summary",
                "appointment_actions",
                "status_indicators",
                "forms",
                "secondary_content"
              ]
            },
            "placement": {
              "type": "string",
              "enum": [
                "default",
                "first",
                "last"
              ]
            },
            "minimumTargetSize": {
              "type": "number",
              "enum": [
                28,
                36,
                38,
                44,
                52,
                56,
                64,
                72
              ]
            },
            "minimumControlGap": {
              "type": "number",
              "enum": [
                5,
                8,
                10,
                16,
                24,
                32
              ]
            },
            "layout": {
              "type": "string",
              "enum": [
                "row",
                "column",
                "step-by-step"
              ]
            },
            "informationPriority": {
              "type": "string",
              "enum": [
                "all",
                "primary"
              ]
            },
            "secondaryContent": {
              "type": "string",
              "enum": [
                "visible",
                "collapsed"
              ]
            },
            "labelStyle": {
              "type": "string",
              "enum": [
                "concise",
                "descriptive",
                "plain-language"
              ]
            },
            "statusPresentation": {
              "type": "string",
              "enum": [
                "color-and-text",
                "icon-shape-text"
              ]
            },
            "activationProtection": {
              "type": "string",
              "enum": [
                "standard",
                "review"
              ]
            },
            "focusVisibility": {
              "type": "string",
              "enum": [
                "standard",
                "enhanced"
              ]
            },
            "destructiveActionPlacement": {
              "type": "string",
              "enum": [
                "inline",
                "separate"
              ]
            }
          },
          "required": [
            "region"
          ],
          "additionalProperties": false
        }
      },
      "textScale": {
        "type": "number",
        "enum": [
          100,
          125,
          150,
          175,
          200
        ]
      },
      "contrast": {
        "type": "string",
        "enum": [
          "standard",
          "high"
        ]
      },
      "controlSize": {
        "type": "string",
        "enum": [
          "standard",
          "large"
        ]
      },
      "controlSpacing": {
        "type": "string",
        "enum": [
          "standard",
          "increased"
        ]
      },
      "colorIndependentStatus": {
        "type": "boolean"
      },
      "emphasizeInteractive": {
        "type": "boolean"
      },
      "openWorkflow": {
        "type": "boolean",
        "description": "Open the safe non-committing workflow entry when true. Defaults to true."
      }
    },
    "required": [
      "goal"
    ],
    "additionalProperties": false
  }
}

{
  "name": "configure_accessibility",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply one or more explicitly requested Northstar settings, such as “make text 175%” or “use stronger contrast,” while preserving omitted settings. For a complete task-centered reorganization, use personalize_for_task. Calibration is optional fine-tuning when the person asks for it or the first adaptation is insufficient.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "textScale": {
        "type": "number",
        "enum": [
          100,
          125,
          150,
          175,
          200
        ],
        "description": "Changes the visible text scale percentage."
      },
      "contrast": {
        "type": "string",
        "enum": [
          "standard",
          "high"
        ],
        "description": "Switches between standard and stronger visual contrast."
      },
      "density": {
        "type": "string",
        "enum": [
          "standard",
          "simplified"
        ],
        "description": "Simplified prioritizes primary tasks and reduces secondary information."
      },
      "controlSize": {
        "type": "string",
        "enum": [
          "standard",
          "large"
        ],
        "description": "Changes the visible size of interactive controls."
      },
      "spacing": {
        "type": "string",
        "enum": [
          "standard",
          "increased"
        ],
        "description": "Changes separation between controls and content groups."
      },
      "emphasizeInteractive": {
        "type": "boolean",
        "description": "Makes buttons and links more visually distinct when true."
      },
      "colorIndependentStatus": {
        "type": "boolean",
        "description": "Adds icons, shapes, and text so status is not conveyed by color alone."
      },
      "readAloud": {
        "type": "boolean",
        "description": "Enables optional webpage speech for visible Guide messages when true."
      }
    },
    "minProperties": 1,
    "additionalProperties": false
  }
}

{
  "name": "start_interface_calibration",
  "kind": "act",
  "impl": "imperative",
  "description": "Optional fine-tuning after an initial adaptation when the person repeatedly misses controls, does not know what target size or spacing works, or explicitly asks to calibrate. Do not require calibration before helping, and do not call from a diagnosis word alone. This opens safe local practice, selects a calibration family rather than a disability template, and never automatically confirms an appointment.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "domain": {
        "type": "string",
        "enum": [
          "pointer_precision"
        ],
        "description": "The implemented functional calibration family. Use pointer_precision for difficulty accurately acquiring controls."
      },
      "goal": {
        "type": "string",
        "enum": [
          "reschedule_appointment"
        ],
        "description": "The bounded portal task to continue locally after the person approves their preferences."
      }
    },
    "required": [
      "domain",
      "goal"
    ],
    "additionalProperties": false
  }
}

{
  "name": "guide_to",
  "kind": "act",
  "impl": "imperative",
  "description": "Move the distinct Guide pointer to a visible semantic target, highlight it, and explain it without activating the target. Use this when the person asks where something is or what it does.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "target": {
        "type": "string",
        "enum": [
          "home_navigation",
          "appointments_navigation",
          "messages_navigation",
          "billing_navigation",
          "insurance_navigation",
          "documents_navigation",
          "settings_navigation",
          "guide_status",
          "portal_surface",
          "upcoming_appointment",
          "reschedule_button",
          "appointment_slot_sep_11",
          "appointment_slot_sep_12",
          "appointment_slot_sep_14",
          "confirm_reschedule_button",
          "billing_balance",
          "insurance_status",
          "patient_responsibility",
          "update_insurance_button",
          "accessibility_controls",
          "personalize_interface",
          "calibration_practice_target"
        ],
        "oneOf": [
          {
            "type": "string",
            "const": "home_navigation",
            "title": "Home navigation",
            "description": "The control that opens the portal home section."
          },
          {
            "type": "string",
            "const": "appointments_navigation",
            "title": "Appointments navigation",
            "description": "The control that opens appointments."
          },
          {
            "type": "string",
            "const": "messages_navigation",
            "title": "Messages navigation",
            "description": "The control that opens administrative messages."
          },
          {
            "type": "string",
            "const": "billing_navigation",
            "title": "Billing navigation",
            "description": "The control that opens billing."
          },
          {
            "type": "string",
            "const": "insurance_navigation",
            "title": "Insurance navigation",
            "description": "The control that opens insurance."
          },
          {
            "type": "string",
            "const": "documents_navigation",
            "title": "Documents navigation",
            "description": "The control that opens documents."
          },
          {
            "type": "string",
            "const": "settings_navigation",
            "title": "Settings navigation",
            "description": "The control that opens portal settings."
          },
          {
            "type": "string",
            "const": "guide_status",
            "title": "Guide status",
            "description": "The portal indicator showing whether Guide tools are available."
          },
          {
            "type": "string",
            "const": "portal_surface",
            "title": "Portal content",
            "description": "The main visible portal content area."
          },
          {
            "type": "string",
            "const": "upcoming_appointment",
            "title": "Upcoming appointment",
            "description": "The visible card or summary for the upcoming appointment."
          },
          {
            "type": "string",
            "const": "reschedule_button",
            "title": "Reschedule appointment",
            "description": "The control that opens appointment rescheduling."
          },
          {
            "type": "string",
            "const": "appointment_slot_sep_11",
            "title": "September 11 at 9:00 AM",
            "description": "The September 11 reschedule option."
          },
          {
            "type": "string",
            "const": "appointment_slot_sep_12",
            "title": "September 12 at 11:30 AM",
            "description": "The September 12 reschedule option."
          },
          {
            "type": "string",
            "const": "appointment_slot_sep_14",
            "title": "September 14 at 3:00 PM",
            "description": "The September 14 reschedule option."
          },
          {
            "type": "string",
            "const": "confirm_reschedule_button",
            "title": "Confirm new time",
            "description": "The consequential control that commits the reviewed appointment time."
          },
          {
            "type": "string",
            "const": "billing_balance",
            "title": "Billing balance",
            "description": "The visible account balance summary."
          },
          {
            "type": "string",
            "const": "insurance_status",
            "title": "Insurance status",
            "description": "The visible insurance coverage status."
          },
          {
            "type": "string",
            "const": "patient_responsibility",
            "title": "Patient responsibility",
            "description": "The patient portion of the fictional bill."
          },
          {
            "type": "string",
            "const": "update_insurance_button",
            "title": "Update insurance",
            "description": "The control that opens the simulated insurance update."
          },
          {
            "type": "string",
            "const": "accessibility_controls",
            "title": "Accessibility preferences",
            "description": "The manual controls for portal presentation preferences."
          },
          {
            "type": "string",
            "const": "personalize_interface",
            "title": "Personalize interface",
            "description": "The control that opens bounded component personalization and safe calibration."
          },
          {
            "type": "string",
            "const": "calibration_practice_target",
            "title": "Calibration practice target",
            "description": "The safe non-operational control used during pointer precision calibration."
          }
        ],
        "description": "A stable semantic target in the visible Northstar interface."
      },
      "message": {
        "type": "string",
        "maxLength": 180,
        "description": "Short plain-text guidance to display beside the target."
      }
    },
    "required": [
      "target"
    ],
    "additionalProperties": false
  }
}

{
  "name": "open_section",
  "kind": "act",
  "impl": "imperative",
  "description": "Visibly navigate the shared portal to a named section using its semantic navigation control.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "section": {
        "type": "string",
        "enum": [
          "home",
          "appointments",
          "messages",
          "billing",
          "insurance",
          "documents",
          "settings"
        ]
      }
    },
    "required": [
      "section"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_upcoming_appointments",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read Robert’s fictional upcoming appointment without changing the interface or appointment.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_reschedule_options",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the available times for Robert’s fictional appointment without opening a workflow, selecting a time, or changing the appointment.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "appointmentId": {
        "type": "string",
        "enum": [
          "appointment_robert_2026_09_10"
        ]
      }
    },
    "required": [
      "appointmentId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "open_reschedule",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the existing non-committing time chooser when the person asks only to begin rescheduling. If they also ask for simpler language, focus, layout, or other presentation changes, use personalize_for_task instead. Nothing changes until a selected time is explicitly confirmed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "appointmentId": {
        "type": "string",
        "enum": [
          "appointment_robert_2026_09_10"
        ]
      }
    },
    "required": [
      "appointmentId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "select_reschedule_slot",
  "kind": "act",
  "impl": "imperative",
  "description": "Select one available fictional appointment time in the visible chooser. This prepares a review and never commits the appointment change.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "appointmentId": {
        "type": "string",
        "enum": [
          "appointment_robert_2026_09_10"
        ]
      },
      "slotId": {
        "type": "string",
        "enum": [
          "slot_2026_09_11_0900",
          "slot_2026_09_12_1130",
          "slot_2026_09_14_1500"
        ]
      }
    },
    "required": [
      "appointmentId",
      "slotId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_bill_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the fictional office-visit bill and its provider, insurance, and patient portions without giving financial advice.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_insurance_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the status of Robert’s fictional insurance card.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}