sessions_filter_schedule
Applies filters to the on-screen schedule and reports the result.
When to use it
Whenever the agent has narrowed results in conversation — so the person is looking at what is being described, rather than a full schedule.
To clear filters: call it with no arguments.
Parameters
activitystringoptionalActivity name or id.
staffstringoptionalStaff member name or id.
daystringoptionalA single day to show, as an ISO 8601 date.
searchstringoptionalFree-text search term.
Returns
Every tool returns two things: text for the model to read, and a structuredContent object beside it for code that would rather branch on a field.
Confirmation of which filters are now applied, and the path the page moved to. The filters are ordinary URL parameters, so the resulting view is shareable.
Example
Run this from any agent or script executing in the page.
const tools =
await document.modelContext.getTools();
const tool = tools.find(
(t) => t.name === 'sessions_filter_schedule',
);
const result = await document.modelContext
.executeTool(tool, {
"activity": "yoga",
"day": "2026-09-02"
});The page now shows the schedule filtered by
activity=yoga, day=2026-09-02. Call
sessions_list_schedule with the same arguments
to read back what is visible.{
"filters": [
"activity=yoga",
"day=2026-09-02"
],
"url": "/@capital-bodywork/schedule?activity=yoga&day=2026-09-02"
}What the agent is told
The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.