{"protocolVersion":"0.3.0","name":"Relate","description":"A teacher's agent: turns a lesson topic into hooks built from what young people in the school's city love right now, grounded in Qloo Taste AI. Read-only; aggregate taste only.","url":"https://relate.retailbox-automation.com/mcp","preferredTransport":"MCP-STREAMABLE-HTTP","version":"0.2.0","provider":{"organization":"RetailBox Automation"},"capabilities":{"streaming":false,"pushNotifications":false},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"lesson_hooks","name":"Lesson Hooks","description":"Prepare the opening of a lesson. Use this when a teacher asks to prepare, plan or warm up a lesson\non a topic for a grade in a city (e.g. \"a lesson on slope for 8th grade in Austin\").\nReturns 3 hooks (worked example, word problem, analogy or discussion), a discussion starter and an\nexit ticket, each built on named Qloo entities the city's young audience has high affinity for, with\n`uses` (Qloo entity ids), a one-line `why` citing the affinity, math answers that were recomputed\nwhen possible (`answer_checked`), the classroom-safety exclusions, a no-Qloo baseline for\ncomparison, and the full Qloo call provenance. Keep the `id`: explain_hook takes it.\nAggregate taste only; no student data is used or needed.","tags":["education","teachers","qloo","taste","read-only"],"inputSchema":{"properties":{"topic":{"description":"The lesson topic in plain words, e.g. 'Slope and rate of change'.","maxLength":200,"minLength":3,"title":"Topic","type":"string"},"grade":{"description":"Grade level of the class, 6 to 12.","maximum":12,"minimum":6,"title":"Grade","type":"integer"},"city":{"description":"The school's city, ideally with the state, e.g. 'Austin, TX'.","maxLength":120,"minLength":2,"title":"City","type":"string"},"subject":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Optional subject: math, science, ELA, social studies, or other.","title":"Subject"}},"required":["topic","grade","city"],"title":"lesson_hooksArguments","type":"object"}},{"id":"class_taste","name":"Class Taste","description":"What the young audience in a city is into right now, without writing hooks. Use it when a teacher\nasks what their students' age group likes, or to brainstorm before choosing a topic.\nReturns classroom-safe video games, TV shows, movies, music artists, podcasts and brands with Qloo\nids, affinity, popularity and trend, plus what was excluded for the grade and why. Source: Qloo\nInsights with the city as location signal and Qloo's youngest age band (24 and under); aggregate\ntaste, not data about any student.","tags":["education","teachers","qloo","taste","read-only"],"inputSchema":{"properties":{"city":{"description":"The school's city, ideally with the state, e.g. 'Austin, TX'.","maxLength":120,"minLength":2,"title":"City","type":"string"},"grade":{"description":"Grade level of the class, 6 to 12.","maximum":12,"minimum":6,"title":"Grade","type":"integer"}},"required":["city","grade"],"title":"class_tasteArguments","type":"object"}},{"id":"explain_hook","name":"Explain Hook","description":"Show the evidence behind one hook from an earlier lesson_hooks result: the Qloo entities it is\nbuilt on (affinity, popularity, trend, tags), the exact Qloo requests that produced them, and the\naudience signal used. Use it when a teacher asks why a hook was chosen or whether it is grounded.","tags":["education","teachers","qloo","taste","read-only"],"inputSchema":{"properties":{"audit_id":{"description":"The `id` returned by lesson_hooks.","maxLength":40,"minLength":4,"title":"Audit Id","type":"string"},"hook_index":{"description":"0-based index into `hooks`.","maximum":9,"minimum":0,"title":"Hook Index","type":"integer"}},"required":["audit_id","hook_index"],"title":"explain_hookArguments","type":"object"}}],"endpoints":{"mcp":"https://relate.retailbox-automation.com/mcp","rest_hooks":"https://relate.retailbox-automation.com/api/hooks","connect":"https://relate.retailbox-automation.com/connect"}}