[{"_1":2,"_501":-5,"_502":-5},"loaderData",{"_3":4,"_301":302,"_399":400},"root",{"_5":6,"_11":-5,"_12":13,"_14":-5,"_15":16,"_17":18,"_102":103,"_105":106,"_107":16,"_108":109,"_110":111,"_170":113,"_171":115,"_116":117,"_172":173,"_194":195,"_219":-5,"_220":-7,"_221":222},"userId",{"_7":8,"_9":10},"id","7c63df10-9b04-4c1f-98dd-aa69db956376","type","cookie.clientId","preferences","progress",[],"user","userHasAccess",false,"apps",[19,26,30,34,38,42,46,50,54,58,62,66,70,74,78,82,86,90,94,98],{"_20":21,"_22":23,"_24":25},"name","01.01.problem","fullPath","/myapp/workshop-content/exercises/01.advanced-tools/01.problem.annotations","relativePath","exercises/01.advanced-tools/01.problem.annotations",{"_20":27,"_22":28,"_24":29},"01.01.solution","/myapp/workshop-content/exercises/01.advanced-tools/01.solution.annotations","exercises/01.advanced-tools/01.solution.annotations",{"_20":31,"_22":32,"_24":33},"01.02.problem","/myapp/workshop-content/exercises/01.advanced-tools/02.problem.structured","exercises/01.advanced-tools/02.problem.structured",{"_20":35,"_22":36,"_24":37},"01.02.solution","/myapp/workshop-content/exercises/01.advanced-tools/02.solution.structured","exercises/01.advanced-tools/02.solution.structured",{"_20":39,"_22":40,"_24":41},"02.01.problem","/myapp/workshop-content/exercises/02.elicitation/01.problem","exercises/02.elicitation/01.problem",{"_20":43,"_22":44,"_24":45},"02.01.solution","/myapp/workshop-content/exercises/02.elicitation/01.solution","exercises/02.elicitation/01.solution",{"_20":47,"_22":48,"_24":49},"03.01.problem","/myapp/workshop-content/exercises/03.sampling/01.problem.simple","exercises/03.sampling/01.problem.simple",{"_20":51,"_22":52,"_24":53},"03.01.solution","/myapp/workshop-content/exercises/03.sampling/01.solution.simple","exercises/03.sampling/01.solution.simple",{"_20":55,"_22":56,"_24":57},"03.02.problem","/myapp/workshop-content/exercises/03.sampling/02.problem.advanced","exercises/03.sampling/02.problem.advanced",{"_20":59,"_22":60,"_24":61},"03.02.solution","/myapp/workshop-content/exercises/03.sampling/02.solution.advanced","exercises/03.sampling/02.solution.advanced",{"_20":63,"_22":64,"_24":65},"04.01.problem","/myapp/workshop-content/exercises/04.long-running-tasks/01.problem.progress","exercises/04.long-running-tasks/01.problem.progress",{"_20":67,"_22":68,"_24":69},"04.01.solution","/myapp/workshop-content/exercises/04.long-running-tasks/01.solution.progress","exercises/04.long-running-tasks/01.solution.progress",{"_20":71,"_22":72,"_24":73},"04.02.problem","/myapp/workshop-content/exercises/04.long-running-tasks/02.problem.cancellation","exercises/04.long-running-tasks/02.problem.cancellation",{"_20":75,"_22":76,"_24":77},"04.02.solution","/myapp/workshop-content/exercises/04.long-running-tasks/02.solution.cancellation","exercises/04.long-running-tasks/02.solution.cancellation",{"_20":79,"_22":80,"_24":81},"05.01.problem","/myapp/workshop-content/exercises/05.changes/01.problem.list-changed","exercises/05.changes/01.problem.list-changed",{"_20":83,"_22":84,"_24":85},"05.01.solution","/myapp/workshop-content/exercises/05.changes/01.solution.list-changed","exercises/05.changes/01.solution.list-changed",{"_20":87,"_22":88,"_24":89},"05.02.problem","/myapp/workshop-content/exercises/05.changes/02.problem.resources-list-changed","exercises/05.changes/02.problem.resources-list-changed",{"_20":91,"_22":92,"_24":93},"05.02.solution","/myapp/workshop-content/exercises/05.changes/02.solution.resources-list-changed","exercises/05.changes/02.solution.resources-list-changed",{"_20":95,"_22":96,"_24":97},"05.03.problem","/myapp/workshop-content/exercises/05.changes/03.problem.subscriptions","exercises/05.changes/03.problem.subscriptions",{"_20":99,"_22":100,"_24":101},"05.03.solution","/myapp/workshop-content/exercises/05.changes/03.solution.subscriptions","exercises/05.changes/03.solution.subscriptions","repoUpdates",{"_104":16},"updatesAvailable","unmutedNotifications",[],"exerciseChanges","loggedInProductHosts",[],"workshopConfig",{"_112":113,"_114":115,"_116":117,"_123":124,"_141":142,"_143":144,"_145":146,"_154":155,"_160":161,"_164":165,"_166":167,"_168":169},"title","Advanced MCP Features 🐡","subtitle","Dive deeper into the Model Context Protocol","instructor",{"_20":118,"_119":120,"_121":122},"Kent C. Dodds","avatar","/images/instructor.png","𝕏","kentcdodds","product",{"_125":126,"_127":128,"_129":130,"_131":132,"_133":134,"_135":136,"_137":138},"host","www.epicai.pro","displayName","EpicAI.pro","displayNameShort","Epic AI","logo","/logo.svg","slug","advanced-mcp-features-flccv","discordChannelId","1446549245246177371","discordTags",[139,140],"1446550493949198457","1446550296682823731","githubRepo","https://github.com/epicweb-dev/advanced-mcp-features","githubRoot","https://github.com/epicweb-dev/advanced-mcp-features/tree/main","stackBlitzConfig",{"_147":148,"_149":150,"_151":152,"_153":150},"view","editor","hidedevtools","1","terminalHeight","0","hideNavigation","forms",{"_156":157,"_158":159},"workshop","https://docs.google.com/forms/d/e/1FAIpQLSdRmj9p8-5zyoqRzxp3UpqSbC3aFkweXvvJIKes0a5s894gzg/viewform?hl=en&embedded=true&entry.2123647600={workshopTitle}","exercise","https://docs.google.com/forms/d/e/1FAIpQLSf3o9xyjQepTlOTH5Z7ZwkeSTdXh6YWI_RGc9KiyD3oUN0p6w/viewform?hl=en&embedded=true&entry.1836176234={workshopTitle}&entry.428900931={exerciseTitle}","testTab",{"_162":163},"enabled",true,"initialRoute","/","notifications",[],"sidecarProcesses",{},"workshopTitle","workshopSubtitle","ENV",{"_174":175,"_176":177,"_178":179,"_180":142,"_181":144,"_182":163,"_183":184,"_185":186,"_187":188,"_189":163,"_190":191,"_192":193},"MODE","production","EPICSHOP_CONTEXT_CWD","/myapp/workshop-content","EPICSHOP_WORKSHOP_INSTANCE_ID","4e1570b81d1baf3d16bd3a08ece570cb","EPICSHOP_GITHUB_REPO","EPICSHOP_GITHUB_ROOT","EPICSHOP_DEPLOYED","EPICSHOP_APP_VERSION","6.49.3","EPICSHOP_PARENT_PORT","3742","EPICSHOP_PARENT_TOKEN","fb5617225c8649c66e052fadf31064349077b09eaf177fc5c69b69c923c2d294","EPICSHOP_IS_PUBLISHED","SENTRY_DSN","https://cd51fbf4ca0834f7b3529a478a8ece4c@o913766.ingest.us.sentry.io/4509630082252800","SENTRY_PROJECT_ID","4509630082252800","requestInfo",{"_196":197,"_198":199,"_200":201,"_202":203,"_204":203,"_205":206,"_213":214,"_215":216,"_217":165,"_218":163},"protocol","http:","hostname","advanced-mcp-features.epicai.pro","port","","origin","http://advanced-mcp-features.epicai.pro","domain","hints",{"_207":208,"_209":210,"_211":212},"theme","light","timeZone","UTC","reducedMotion","no-preference","path","/exercise/01/finished","session",{"_207":-5},"separator","online","toast","confettiId","presence",{"_223":224},"users",[225,250,264,275,283,290],{"_7":226,"_227":163,"_228":229,"_230":231,"_232":229,"_20":233,"_108":234,"_236":237,"_246":247},"62365a61-9c34-47f2-85f9-7880a106df9c","hasAccess","avatarUrl","https://www.gravatar.com/avatar/9f8c80517d1f769442540671a1dc3447?size=512&default=identicon","imageUrlSmall","https://www.gravatar.com/avatar/9f8c80517d1f769442540671a1dc3447?size=64&default=identicon","imageUrlLarge","Anand",[235],"www.epicweb.dev","location",{"_170":238,"_239":235,"_158":240},"Mocking Techniques in Vitest","productHost",{"_9":241,"_242":243,"_244":245},"solution","exerciseNumber",3,"stepNumber",1,"locations",[248],{"_170":238,"_239":235,"_158":249},{"_9":241,"_242":243,"_244":245},{"_7":251,"_227":163,"_230":252,"_232":253,"_20":254,"_108":255,"_236":256,"_246":260},"fcf4b5ec-b9be-4a92-8e0d-1dde927ba54e","https://www.gravatar.com/avatar/be16d6368712f7a1320e303df84ef1b9?size=64&default=identicon","https://www.gravatar.com/avatar/be16d6368712f7a1320e303df84ef1b9?size=512&default=identicon","Steve",[126],{"_170":257,"_239":126,"_158":258},"MCP Fundamentals 🧱",{"_242":259},2,[261,263],{"_170":257,"_239":126,"_158":262},{"_242":259},{"_170":257,"_239":126},{"_7":265,"_227":16,"_108":266,"_236":267,"_246":272},"9c210b29-5060-44e0-959e-62af7bd23c25",[],{"_170":268,"_239":269,"_158":270},"React Fundamentals ⚛","www.epicreact.dev",{"_9":241,"_242":271,"_244":245},4,[273],{"_170":268,"_239":269,"_158":274},{"_9":241,"_242":271,"_244":245},{"_7":276,"_236":277,"_246":280},"6da24415-c79b-4ccb-8398-b10548f94595",{"_170":278,"_158":279},"Full Stack Foundations 🔭",{"_242":259},[281],{"_170":278,"_158":282},{"_242":259},{"_7":284,"_108":285,"_236":286,"_246":288},"d57c9aed-0749-4388-b00b-896dfd50fa0a",[126],{"_170":287,"_239":235},"Epic Workshop App Tutorial 👨‍🏫",[289],{"_170":287,"_239":235},{"_7":8,"_108":291,"_236":292},[],{"_170":113,"_202":203,"_239":126,"_293":184,"_294":295,"_158":300},"epicshopVersion","repoStatus",{"_104":16,"_296":-5,"_297":-5,"_298":-5,"_299":-5},"commitsAhead","commitsBehind","localCommit","remoteCommit",{"_242":245,"_244":-5,"_9":-5},"routes/_app+/_layout",{"_170":113,"_303":304,"_395":396,"_398":16},"exercises",[305,326,337,354,371],{"_242":245,"_112":306,"_307":308,"_313":314,"_317":318},"Advanced Tools","solutions",[309,311],{"_244":245,"_112":310,"_20":27},"Annotations",{"_244":259,"_112":312,"_20":35},"Structured Output","problems",[315,316],{"_244":245,"_112":310,"_20":21},{"_244":259,"_112":312,"_20":31},"steps",[319,323],{"_244":245,"_112":310,"_20":21,"_320":321,"_241":322},"problem",{"_20":21,"_112":310},{"_20":27,"_112":310},{"_244":259,"_112":312,"_20":31,"_320":324,"_241":325},{"_20":31,"_112":312},{"_20":35,"_112":312},{"_242":259,"_112":327,"_307":328,"_313":331,"_317":333},"Elicitation",[329],{"_244":245,"_112":330,"_20":43},"Elicit Confirmation",[332],{"_244":245,"_112":330,"_20":39},[334],{"_244":245,"_112":330,"_20":39,"_320":335,"_241":336},{"_20":39,"_112":330},{"_20":43,"_112":330},{"_242":243,"_112":338,"_307":339,"_313":344,"_317":347},"Sampling",[340,342],{"_244":245,"_112":341,"_20":51},"Simple Sampling",{"_244":259,"_112":343,"_20":59},"Advanced Sampling Prompt",[345,346],{"_244":245,"_112":341,"_20":47},{"_244":259,"_112":343,"_20":55},[348,351],{"_244":245,"_112":341,"_20":47,"_320":349,"_241":350},{"_20":47,"_112":341},{"_20":51,"_112":341},{"_244":259,"_112":343,"_20":55,"_320":352,"_241":353},{"_20":55,"_112":343},{"_20":59,"_112":343},{"_242":271,"_112":355,"_307":356,"_313":361,"_317":364},"Long Running Tasks",[357,359],{"_244":245,"_112":358,"_20":67},"Progress Updates",{"_244":259,"_112":360,"_20":75},"Cancellation",[362,363],{"_244":245,"_112":358,"_20":63},{"_244":259,"_112":360,"_20":71},[365,368],{"_244":245,"_112":358,"_20":63,"_320":366,"_241":367},{"_20":63,"_112":358},{"_20":67,"_112":358},{"_244":259,"_112":360,"_20":71,"_320":369,"_241":370},{"_20":71,"_112":360},{"_20":75,"_112":360},{"_242":372,"_112":373,"_307":374,"_313":381,"_317":385},5,"Changes",[375,377,379],{"_244":245,"_112":376,"_20":83},"List Changed",{"_244":259,"_112":378,"_20":91},"Resource Template List Changed",{"_244":243,"_112":380,"_20":99},"Subscriptions",[382,383,384],{"_244":245,"_112":376,"_20":79},{"_244":259,"_112":378,"_20":87},{"_244":243,"_112":380,"_20":95},[386,389,392],{"_244":245,"_112":376,"_20":79,"_320":387,"_241":388},{"_20":79,"_112":376},{"_20":83,"_112":376},{"_244":259,"_112":378,"_20":87,"_320":390,"_241":391},{"_20":87,"_112":378},{"_20":91,"_112":378},{"_244":243,"_112":380,"_20":95,"_320":393,"_241":394},{"_20":95,"_112":380},{"_20":99,"_112":380},"playground",{"_397":-5,"_242":-2,"_244":-2,"_9":-7},"appName","isMenuOpened","routes/_app+/exercise+/$exerciseNumber_.finished",{"_401":402,"_170":113,"_158":403,"_483":484,"_485":486,"_487":488,"_492":493,"_498":499},"articleId","workshop-advanced-mcp-features-1-finished",{"_22":404,"_242":245,"_405":406,"_112":306,"_407":408,"_409":410,"_411":412,"_414":415,"_317":417,"_313":465,"_307":474},"/myapp/workshop-content/exercises/01.advanced-tools","dirName","01.advanced-tools","instructionsCode","var Component=(()=>{var m=Object.create;var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var y=Object.getPrototypeOf,u=Object.prototype.hasOwnProperty;var f=(a,e)=>()=>(e||a((e={exports:{}}).exports,e),e.exports),x=(a,e)=>{for(var t in e)r(a,t,{get:e[t],enumerable:!0})},i=(a,e,t,s)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let l of b(e))!u.call(a,l)&&l!==t&&r(a,l,{get:()=>e[l],enumerable:!(s=p(e,l))||s.enumerable});return a};var v=(a,e,t)=>(t=a!=null?m(y(a)):{},i(e||!a||!a.__esModule?r(t,\"default\",{value:a,enumerable:!0}):t,a)),g=a=>i(r({},\"__esModule\",{value:!0}),a);var c=f((B,o)=>{o.exports=_jsx_runtime});var N={};x(N,{default:()=>h,frontmatter:()=>k});var n=v(c()),k=void 0;function d(a){let e={a:\"a\",code:\"code\",div:\"div\",em:\"em\",h1:\"h1\",h2:\"h2\",h3:\"h3\",h4:\"h4\",li:\"li\",ol:\"ol\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",table:\"table\",tbody:\"tbody\",td:\"td\",th:\"th\",thead:\"thead\",tr:\"tr\",ul:\"ul\",...a.components},{EpicVideo:t}=e;return t||w(\"EpicVideo\",!0),(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(e.h1,{children:\"Advanced Tools\"}),`\n`,(0,n.jsx)(t,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/intro~2nnka\"}),`\n`,(0,n.jsx)(e.h2,{children:\"Tool Annotations\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Tool annotations are metadata attached to each tool definition. They help clients and users understand the tool's behavior, especially regarding side effects, safety, and intended use. Annotations do \",(0,n.jsx)(e.strong,{children:\"not\"}),\" affect the tool's execution. They are hints for UI, approval flows, and documentation.\"]}),`\n`,(0,n.jsx)(\"callout-warning\",{children:(0,n.jsxs)(e.p,{children:[\"Annotations are \",(0,n.jsx)(e.em,{children:\"not\"}),` security features. They are advisory only and should not\nbe relied on for access control or sandboxing.`]})}),`\n`,(0,n.jsx)(e.h3,{children:\"Why Use Annotations?\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"UX clarity:\"}),\" Help users understand what a tool does before approving its use.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Safety:\"}),\" Warn about potentially destructive or open-world actions.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Automation:\"}),\" Allow clients to group, filter, or require extra approval for certain tools.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.h3,{children:\"Example Tool Definition: Launch Real-Life Confetti\"}),`\n`,(0,n.jsx)(e.p,{children:\"Here's a fun (and slightly dangerous) example of a tool that launches a real confetti cannon in the physical world:\"}),`\n`,(0,n.jsx)(e.pre,{\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"name\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"launch_confetti\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\":\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\"\t\t\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Launch a real confetti cannon in the physical world to celebrate! (Warning: may make a mess)\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"object\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"properties\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"color\"}),\": { \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\", \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"The color of the confetti\"}),\"'\",\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"intensity\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"11\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"enum\"}),\": [\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"low\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"medium\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"high\"}),\"'\",\"],\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"12\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"How much confetti to launch\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"13\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"14\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"location\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"15\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"16\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\":\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"17\",children:[\"\t\t\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Where to launch the confetti (e.g., 'main office', 'living room')\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"18\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"19\",children:[\"\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"20\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"required\"}),\": [\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"color\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"location\"}),\"'\",\"],\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"21\",children:[\"\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"22\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"annotations\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"23\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"title\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Launch Real-Life Confetti\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"24\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"readOnlyHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"false\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"25\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"destructiveHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"26\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"idempotentHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"false\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"27\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"openWorldHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"28\",children:[\"\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"29\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"readOnlyHint: false\"}),\" - This tool physically changes the environment (and makes a mess!).\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"destructiveHint: true\"}),\" - Launching confetti can be considered a destructive action (cleanup required).\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"openWorldHint: true\"}),\" - This tool literally interacts with the real world, not just the local system/service provider.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"idempotentHint: false\"}),\" - This tool is not idempotent because it makes a mess (and the cannon may need a reload to work again).\"]}),`\n`]}),`\n`,(0,n.jsx)(\"callout-warning\",{children:(0,n.jsx)(e.p,{children:`A tool like this should require explicit user approval and be used with\ncaution. Imagine the consequences of launching confetti in the wrong place at\nthe wrong time!`})}),`\n`,(0,n.jsx)(e.h3,{children:\"Table of Annotations\"}),`\n`,(0,n.jsxs)(e.table,{children:[(0,n.jsx)(e.thead,{children:(0,n.jsxs)(e.tr,{children:[(0,n.jsx)(e.th,{children:\"Annotation\"}),(0,n.jsx)(e.th,{children:\"Default\"}),(0,n.jsx)(e.th,{children:\"Description\"}),(0,n.jsx)(e.th,{children:\"Relevance\"})]})}),(0,n.jsxs)(e.tbody,{children:[(0,n.jsxs)(e.tr,{children:[(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"readOnlyHint\"})}),(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"false\"})}),(0,n.jsx)(e.td,{children:\"If true, the tool does not modify its environment.\"}),(0,n.jsx)(e.td,{children:\"Always relevant\"})]}),(0,n.jsxs)(e.tr,{children:[(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"destructiveHint\"})}),(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"true\"})}),(0,n.jsx)(e.td,{children:\"If true, the tool may perform destructive updates to its environment.\"}),(0,n.jsxs)(e.td,{children:[\"Irrelevant when \",(0,n.jsx)(e.code,{children:\"readOnlyHint\"}),\" is true\"]})]}),(0,n.jsxs)(e.tr,{children:[(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"idempotentHint\"})}),(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"false\"})}),(0,n.jsx)(e.td,{children:\"If true, calling the tool repeatedly with the same arguments will have no additional effect on its environment.\"}),(0,n.jsxs)(e.td,{children:[\"Irrelevant when \",(0,n.jsx)(e.code,{children:\"readOnlyHint\"}),\" is true\"]})]}),(0,n.jsxs)(e.tr,{children:[(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"openWorldHint\"})}),(0,n.jsx)(e.td,{children:(0,n.jsx)(e.code,{children:\"true\"})}),(0,n.jsx)(e.td,{children:`If true, this tool may interact with an \"open world\" of external entities (outside of the tool's domain).`}),(0,n.jsx)(e.td,{children:\"Always relevant\"})]})]})]}),`\n`,(0,n.jsx)(e.h3,{children:\"Pragmatic Annotation Guidelines\"}),`\n`,(0,n.jsx)(e.p,{children:\"For practical tool design, consider these guidelines:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"Use \",(0,n.jsx)(e.code,{children:\"destructiveHint: true\"}),\" for tools that \",(0,n.jsx)(e.strong,{children:\"delete\"}),\" records or data\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Use \",(0,n.jsx)(e.code,{children:\"destructiveHint: false\"}),\" for tools that \",(0,n.jsx)(e.strong,{children:\"modify\"}),\" content (even if original is overwritten).\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Use \",(0,n.jsx)(e.code,{children:\"idempotentHint: true\"}),\" for tools that produce the same logical result regardless of call count. Ignore metadata changes (timestamps, access logs, etc.). Focus on the core operation outcome.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Use \",(0,n.jsx)(e.code,{children:\"idempotentHint: false\"}),\" for tools that produce a different result each time they are called.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"Use \",(0,n.jsx)(e.code,{children:\"openWorldHint: true\"}),\" for tools that interact with systems external to your application.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Examples:\"})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"delete_user(id: 123)\"}),\" - \",(0,n.jsx)(e.strong,{children:\"Destructive, Idempotent\"})]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:'update_user(id: 123, {name: \"John\"})'}),\" - \",(0,n.jsx)(e.strong,{children:\"Non-destructive, Idempotent\"})]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"increment_counter(id: 123)\"}),\" - \",(0,n.jsx)(e.strong,{children:\"Non-destructive, Not idempotent\"})]}),`\n`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"This approach prioritizes \",(0,n.jsx)(e.strong,{children:\"practical usability\"}),\" over theoretical precision because being pedantic about \",(0,n.jsx)(e.code,{children:\"updatedAt\"}),\" timestamps makes annotations effectively meaningless.\"]}),`\n`,(0,n.jsx)(e.h3,{children:\"How Annotations Affect the Client\"}),`\n`,(0,n.jsx)(e.p,{children:\"Clients can use annotations to:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsx)(e.li,{children:\"Display warnings or require confirmation for destructive tools\"}),`\n`,(0,n.jsx)(e.li,{children:\"Group or filter tools (e.g., show only read-only tools)\"}),`\n`,(0,n.jsx)(e.li,{children:\"Provide friendlier names in the UI\"}),`\n`,(0,n.jsx)(e.li,{children:\"Decide when to allow automation or require human approval\"}),`\n`]}),`\n`,(0,n.jsx)(\"callout-success\",{children:(0,n.jsx)(e.p,{children:`Annotations make it easier to build safe, user-friendly interfaces for tool\ninvocation.`})}),`\n`,(0,n.jsx)(e.h3,{children:\"Recommended Practices\"}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Be accurate about side effects:\"}),\" Mark tools as \",(0,n.jsx)(e.code,{children:\"readOnlyHint: true\"}),\" only if they never modify state.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Use descriptive titles:\"}),\" The \",(0,n.jsx)(e.code,{children:\"title\"}),\" annotation should be clear and human-friendly.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Indicate idempotency:\"}),\" Use \",(0,n.jsx)(e.code,{children:\"idempotentHint: true\"}),\" only if repeated calls with the same arguments are safe and have no extra effect.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Set open/closed world hints:\"}),\" Use \",(0,n.jsx)(e.code,{children:\"openWorldHint: true\"}),\" for tools that interact with the internet or external systems.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Remember: annotations are hints!\"}),\" Never rely on them for security or correctness.\"]}),`\n`]}),`\n`,(0,n.jsx)(\"callout-muted\",{children:(0,n.jsx)(e.p,{children:\"Annotations are for humans and UIs, not for enforcing security or correctness.\"})}),`\n`,(0,n.jsx)(e.h3,{children:\"Learn More \\u{1F4DC}\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"For a full list of available annotations and their meanings, see the \",(0,n.jsx)(e.a,{href:\"https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations\",children:\"official MCP documentation on tool annotations\"}),\".\"]}),`\n`,(0,n.jsx)(e.h2,{children:\"Structured Output and Output Schemas\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Structured output allows tools to return rich, machine-validated data instead of just plain text. By defining an \",(0,n.jsx)(e.code,{children:\"outputSchema\"}),\" for a tool, the server ensures that all tool responses conform to a specific structure, making it easier for clients and LLMs to consume, validate, and act on the results.\"]}),`\n`,(0,n.jsx)(e.h3,{children:\"Why Use Structured Output?\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Reliability:\"}),\" Ensures tool responses are predictable and machine-parseable.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Validation:\"}),\" Automatic schema validation prevents malformed or incomplete data from propagating.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Automation:\"}),\" Enables downstream automation, UI rendering, and chaining of tool results.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Safety:\"}),\" Reduces the risk of misinterpretation or injection by strictly defining expected output.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.h3,{children:\"How It Works\"}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Tool Definition:\"}),\" The tool specifies an \",(0,n.jsx)(e.code,{children:\"outputSchema\"}),\" (JSON Schema) describing the expected result structure.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Tool Execution:\"}),\" When the tool is called, the server validates the output against the schema before returning it to the client.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Client Consumption:\"}),\" Clients and LLMs can safely parse and use the structured result, knowing it matches the schema.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Error Handling:\"}),\" If the output does not match the schema, an error is returned instead of invalid data.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.h3,{children:\"Example Tool with Output Schema\"}),`\n`,(0,n.jsx)(e.p,{children:\"Suppose we have a tool that generates a random fantasy character profile:\"}),`\n`,(0,n.jsx)(e.pre,{\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"name\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"generate_fantasy_character\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\":\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\"\t\t\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Creates a random fantasy character profile for games or stories.\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"object\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"properties\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"theme\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\":\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"11\",children:[\"\t\t\t\t\t\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:'Optional theme for the character (e.g., \"forest\", \"fire\", \"ice\")'}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"12\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"13\",children:[\"\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"14\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"required\"}),\": [],\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"15\",children:[\"\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"16\",children:[\"\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"outputSchema\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"17\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"object\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"18\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"properties\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"19\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"name\"}),\": { \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\", \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"The character's name\"}),'\"',\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"20\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"species\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"21\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"22\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"The fantasy species (e.g., elf, orc, dragon)\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"23\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"24\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"characterClass\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"25\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"26\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\":\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"27\",children:[\"\t\t\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"The character's class or role (e.g., wizard, rogue, paladin)\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"28\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"29\",children:[\"\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"abilities\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"30\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"array\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"31\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"items\"}),\": { \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"type\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"string\"}),\"'\",\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"32\",children:[\"\t\t\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"A list of special abilities or powers\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"33\",children:[\"\t\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"34\",children:[\"\t\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"35\",children:[\"\t\t\",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"required\"}),\": [\",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"name\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"species\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"characterClass\"}),\"'\",\", \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"abilities\"}),\"'\",\"],\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"36\",children:[\"\t},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"37\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsx)(e.h3,{children:\"Example Request/Response with Structured Content\"}),`\n`,(0,n.jsx)(e.h4,{children:\"Request\"}),`\n`,(0,n.jsx)(e.pre,{\"data-filename\":\"client-request.json\",\"data-nocopy\":\"\",\"data-line-numbers\":\"true\",\"data-lang\":\"json\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"jsonrpc\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"2.0\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"id\"}),'\"',\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"99\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"method\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"tools/call\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"params\"}),'\"',\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"name\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"generate_fantasy_character\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\"\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"arguments\"}),'\"',\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\"\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"theme\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"forest\"}),'\"',`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"\t\t}\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"\t}\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"11\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsx)(e.h4,{children:\"Response\"}),`\n`,(0,n.jsx)(e.pre,{\"data-filename\":\"server-response.json\",\"data-nocopy\":\"\",\"data-line-numbers\":\"true\",\"data-lang\":\"json\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"jsonrpc\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"2.0\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"id\"}),'\"',\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"99\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\"\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"result\"}),'\"',\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\"\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"content\"}),'\"',\": [\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"\t\t\t{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\"\t\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"type\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"text\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\"\t\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"text\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"{\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"name\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\": \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Lirael Mosswhisper\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\", \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"species\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\": \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Elf\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\", \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"characterClass\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\": \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Druid\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\", \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"abilities\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\": [\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Speak with Animals\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\", \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Vine Whip\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\", \"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Forest Camouflage\"}),(0,n.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"]}\"}),'\"',`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"\t\t\t}\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"\t\t],\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"11\",children:[\"\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"structuredContent\"}),'\"',\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"12\",children:[\"\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"name\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Lirael Mosswhisper\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"13\",children:[\"\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"species\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Elf\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"14\",children:[\"\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"characterClass\"}),'\"',\": \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Druid\"}),'\"',\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"15\",children:[\"\t\t\t\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"abilities\"}),'\"',\": [\",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Speak with Animals\"}),'\"',\", \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Vine Whip\"}),'\"',\", \",'\"',(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Forest Camouflage\"}),'\"',\"]\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"16\",children:[\"\t\t}\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"17\",children:[\"\t}\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"18\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsx)(e.h3,{children:\"Validation Flow\"}),`\n`,(0,n.jsx)(e.p,{children:\"Below is a sequence diagram showing how structured content is validated:\"}),`\n`,(0,n.jsx)(e.div,{className:\"mermaid not-prose\",dangerouslySetInnerHTML:{__html:''}}),`\n`,(0,n.jsx)(e.h3,{children:\"Recommended Practices\"}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Define clear output schemas:\"}),\" Use JSON Schema to describe all possible fields and types.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Validate on the server:\"}),\" Always validate tool output before returning to the client (the SDK does this for us).\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Handle validation errors gracefully:\"}),\" Inform users or clients when output does not match the schema (the SDK does this for us).\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"For more details, see the \\u{1F4DC} \",(0,n.jsx)(e.a,{href:\"https://modelcontextprotocol.io/specification/2025-06-18/server/tools#structured-content\",children:\"official MCP documentation on structured content and output schemas\"}),\".\"]})]})}function h(a={}){let{wrapper:e}=a.components||{};return e?(0,n.jsx)(e,{...a,children:(0,n.jsx)(d,{...a})}):d(a)}function w(a,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+a+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return g(N);})();\n;return Component;","finishedCode","var Component=(()=>{var f=Object.create;var s=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var h=Object.getPrototypeOf,w=Object.prototype.hasOwnProperty;var x=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),_=(e,t)=>{for(var n in t)s(e,n,{get:t[n],enumerable:!0})},c=(e,t,n,a)=>{if(t&&typeof t==\"object\"||typeof t==\"function\")for(let r of m(t))!w.call(e,r)&&r!==n&&s(e,r,{get:()=>t[r],enumerable:!(a=l(t,r))||a.enumerable});return e};var g=(e,t,n)=>(n=e!=null?f(h(e)):{},c(t||!e||!e.__esModule?s(n,\"default\",{value:e,enumerable:!0}):n,e)),j=e=>c(s({},\"__esModule\",{value:!0}),e);var u=x((E,i)=>{i.exports=_jsx_runtime});var v={};_(v,{default:()=>p,frontmatter:()=>b});var o=g(u()),b=void 0;function d(e){let t={h1:\"h1\",p:\"p\",...e.components},{EpicVideo:n}=t;return n||k(\"EpicVideo\",!0),(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(t.h1,{children:\"Advanced Tools\"}),`\n`,(0,o.jsx)(n,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/break~70afq\"}),`\n`,(0,o.jsx)(t.p,{children:\"Awesome work. You now understand about annotations, structured output, and output schemas. Hopefully this enables you to take advantage of great client features when clients support these features.\"})]})}function p(e={}){let{wrapper:t}=e.components||{};return t?(0,o.jsx)(t,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}function k(e,t){throw new Error(\"Expected \"+(t?\"component\":\"object\")+\" `\"+e+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return j(v);})();\n;return Component;","instructionsEpicVideoEmbeds",[413],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/intro~2nnka","finishedEpicVideoEmbeds",[416],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/break~70afq",[418,446],{"_244":245,"_320":419,"_241":436},{"_20":21,"_112":310,"_405":420,"_22":23,"_24":25,"_407":421,"_422":423,"_425":426,"_429":430,"_433":434,"_242":245,"_244":245,"_9":320,"_435":27},"01.problem.annotations","var Component=(()=>{var p=Object.create;var s=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var u=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var y=(a,e)=>()=>(e||a((e={exports:{}}).exports,e),e.exports),f=(a,e)=>{for(var l in e)s(a,l,{get:e[l],enumerable:!0})},c=(a,e,l,r)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let o of m(e))!v.call(a,o)&&o!==l&&s(a,o,{get:()=>e[o],enumerable:!(r=b(e,o))||r.enumerable});return a};var k=(a,e,l)=>(l=a!=null?p(u(a)):{},c(e||!a||!a.__esModule?s(l,\"default\",{value:a,enumerable:!0}):l,a)),N=a=>c(s({},\"__esModule\",{value:!0}),a);var i=y((C,t)=>{t.exports=_jsx_runtime});var A={};f(A,{default:()=>h,frontmatter:()=>g});var n=k(i()),g=void 0;function d(a){let e={a:\"a\",code:\"code\",h1:\"h1\",p:\"p\",pre:\"pre\",span:\"span\",...a.components},{EpicVideo:l}=e;return l||w(\"EpicVideo\",!0),(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(e.h1,{children:\"Annotations\"}),`\n`,(0,n.jsx)(l,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/annotations~n6qo2\"}),`\n`,(0,n.jsx)(e.p,{children:\"\\u{1F468}\\u200D\\u{1F4BC} Users want to feel confident about what each tool in the system does before they use it. They want to know if a tool is safe, if it will change their data, or if it might reach out to the outside world. When tools are clearly labeled for their behavior, the app feels more transparent and trustworthy.\"}),`\n`,(0,n.jsx)(e.p,{children:\"For example, if a tool is read-only, the UI can show a reassuring message. If a tool might delete data, the user should get a warning. If a tool is safe to run multiple times, that's useful to know too. These labels help users make informed decisions and reduce anxiety about using advanced features.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"To support this, each tool should include an \",(0,n.jsx)(e.code,{children:\"annotations\"}),\" property that describes its behavior. Here are some fun examples:\"]}),`\n`,(0,n.jsx)(e.pre,{\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"title\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Summon Dragon\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Summon a friendly dragon to your location\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"annotations\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"destructiveHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"false\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"openWorldHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"summonInputSchema\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsx)(e.pre,{\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"title\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Cast Invisibility\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Make the user invisible for 5 minutes\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"annotations\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"idempotentHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"openWorldHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"false\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": {},\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsx)(e.pre,{\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"title\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Delete Goblin\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"'\",(0,n.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Remove a goblin from the dungeon\"}),\"'\",\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"annotations\"}),\": {\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"destructiveHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"idempotentHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"true\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"openWorldHint\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"false\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\" },\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\" \",(0,n.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": \",(0,n.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"goblinIdSchema\"}),\",\",`\n`]}),(0,n.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"}\",`\n`]})]})}),`\n`,(0,n.jsxs)(e.p,{children:[\"\\u{1F4DC} Please check \",(0,n.jsx)(e.a,{href:\"https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations\",children:\"the MCP docs\"}),\" for the default values and when each annotation is useful.\"]}),`\n`,(0,n.jsx)(e.p,{children:\"The goal is to make tool behavior obvious to both users and the UI. The more clearly this is communicated, the more empowered and comfortable users will feel using the mcp server's advanced features.\"}),`\n`,(0,n.jsx)(\"callout-info\",{children:(0,n.jsx)(e.p,{children:`\\u{1F428} Note: I have you add annotations to every tool, but feel free to stop and\nmove on to the next step once you feel comfortable.`})}),`\n`,(0,n.jsx)(e.p,{children:'To test this in the MCP inspector, simply connect and click \"Tools\" and \"List Tools,\" then check the annotations in the response.'})]})}function h(a={}){let{wrapper:e}=a.components||{};return e?(0,n.jsx)(e,{...a,children:(0,n.jsx)(d,{...a})}):d(a)}function w(a,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+a+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return N(A);})();\n;return Component;","epicVideoEmbeds",[424],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/annotations~n6qo2","test",{"_9":427,"_427":428},"script","vitest","dev",{"_9":427,"_431":432,"_164":165},"portNumber",6001,"stackBlitzUrl","https://stackblitz.com/github/epicweb-dev/advanced-mcp-features/tree/main/exercises/01.advanced-tools/01.problem.annotations?view=editor&hidedevtools=1&terminalHeight=0&hideNavigation=1&title=Annotations+%28problem%29","solutionName",{"_20":27,"_112":310,"_405":437,"_22":28,"_24":29,"_407":438,"_422":439,"_425":441,"_429":442,"_433":444,"_242":245,"_244":245,"_9":241,"_445":-5},"01.solution.annotations","var Component=(()=>{var u=Object.create;var a=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var w=(n,e)=>()=>(e||n((e={exports:{}}).exports,e),e.exports),x=(n,e)=>{for(var t in e)a(n,t,{get:e[t],enumerable:!0})},s=(n,e,t,i)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let r of h(e))!g.call(n,r)&&r!==t&&a(n,r,{get:()=>e[r],enumerable:!(i=m(e,r))||i.enumerable});return n};var y=(n,e,t)=>(t=n!=null?u(f(n)):{},s(e||!n||!n.__esModule?a(t,\"default\",{value:n,enumerable:!0}):t,n)),j=n=>s(a({},\"__esModule\",{value:!0}),n);var d=w((E,c)=>{c.exports=_jsx_runtime});var k={};x(k,{default:()=>p,frontmatter:()=>_});var o=y(d()),_=void 0;function l(n){let e={h1:\"h1\",p:\"p\",...n.components},{EpicVideo:t}=e;return t||v(\"EpicVideo\",!0),(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(e.h1,{children:\"Annotations\"}),`\n`,(0,o.jsx)(t,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/annotations~n6qo2/solution\"}),`\n`,(0,o.jsx)(e.p,{children:\"\\u{1F468}\\u200D\\u{1F4BC} Fantastic progress! We've successfully introduced annotations to our journaling tools. Now, each tool clearly communicates its intent\\u2014whether it's read-only, destructive, idempotent, or open world. This means users and the system can better understand the impact of each action, leading to a safer and more predictable journaling experience. For example, deleting an entry is now marked as idempotent, while creating a tag is clearly non-destructive. These improvements help ensure that users can confidently manage their journal and tags, knowing exactly what each tool is designed to do.\"}),`\n`,(0,o.jsx)(e.p,{children:\"Let's keep up the momentum as we continue to enhance the user experience!\"})]})}function p(n={}){let{wrapper:e}=n.components||{};return e?(0,o.jsx)(e,{...n,children:(0,o.jsx)(l,{...n})}):l(n)}function v(n,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+n+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return j(k);})();\n;return Component;",[440],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/annotations~n6qo2/solution",{"_9":427,"_427":428},{"_9":427,"_431":443,"_164":165},7001,"https://stackblitz.com/github/epicweb-dev/advanced-mcp-features/tree/main/exercises/01.advanced-tools/01.solution.annotations?view=editor&hidedevtools=1&terminalHeight=0&hideNavigation=1&title=Annotations+%28solution%29","problemName",{"_244":259,"_320":447,"_241":456},{"_20":31,"_112":312,"_405":448,"_22":32,"_24":33,"_407":449,"_422":450,"_425":452,"_429":453,"_433":455,"_242":245,"_244":259,"_9":320,"_435":35},"02.problem.structured","var Component=(()=>{var p=Object.create;var s=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var m=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var v=(n,e)=>()=>(e||n((e={exports:{}}).exports,e),e.exports),k=(n,e)=>{for(var l in e)s(n,l,{get:e[l],enumerable:!0})},t=(n,e,l,c)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let r of u(e))!y.call(n,r)&&r!==l&&s(n,r,{get:()=>e[r],enumerable:!(c=b(e,r))||c.enumerable});return n};var N=(n,e,l)=>(l=n!=null?p(m(n)):{},t(e||!n||!n.__esModule?s(l,\"default\",{value:n,enumerable:!0}):l,n)),f=n=>t(s({},\"__esModule\",{value:!0}),n);var i=v((D,o)=>{o.exports=_jsx_runtime});var B={};k(B,{default:()=>h,frontmatter:()=>g});var a=N(i()),g=void 0;function d(n){let e={a:\"a\",code:\"code\",h1:\"h1\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",...n.components},{EpicVideo:l}=e;return l||C(\"EpicVideo\",!0),(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(e.h1,{children:\"Structured Output\"}),`\n`,(0,a.jsx)(l,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/structured-output~egacc\"}),`\n`,(0,a.jsx)(e.p,{children:\"\\u{1F468}\\u200D\\u{1F4BC} When users open EpicMe, they expect their memories, reflections, and daily adventures to be organized, discoverable, and (most importantly) reliable. Imagine a user writing a heartfelt entry about their day, only to have it saved as a jumbled scroll of text! That would be chaos in their personal archive.\"}),`\n`,(0,a.jsxs)(e.p,{children:[\"To ensure every tool in EpicMe returns information that is both predictable and easy for the UI (and our friendly LLM assistants) to understand, we use \",(0,a.jsx)(e.strong,{children:\"structured output\"}),\". This means every tool response follows a clear, machine-validated shape\\u2014no more wild guesses or mysterious blobs of data.\"]}),`\n`,(0,a.jsx)(e.pre,{\"data-filename\":\"src/tools.ts\",\"data-nocopy\":\"\",\"data-line-numbers\":\"true\",\"data-lang\":\"ts\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,a.jsxs)(e.code,{children:[(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"name\"}),\": \",\"'\",(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"create_magical_creature\"}),\"'\",\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"description\"}),\": \",\"`\",(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Add a new magical creature to the user's stable.\"}),\"`\",\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"inputSchema\"}),\": { \",(0,a.jsx)(e.span,{style:{color:\"var(--base03)\"},children:\"/* ... */\"}),\" },\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-highlight\":\"true\",\"data-line-number\":\"5\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"outputSchema\"}),\": { \",(0,a.jsx)(e.span,{style:{color:\"var(--base0A)\"},children:\"creature\"}),\": \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"magicalCreatureSchema\"}),\" },\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"},\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"async\"}),\" (\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"input\"}),\") \",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"=>\"}),\" {\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"const\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"creature\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"=\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"await\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"agent\"}),\".\",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"db\"}),\".\",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"createCreature\"}),\"(\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"input\"}),\")\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-highlight\":\"true\",\"data-line-number\":\"9\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"const\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"structuredContent\"}),\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"=\"}),\" { \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"creature\"}),\" }\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0E)\"},children:\"return\"}),\" {\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-highlight\":\"true\",\"data-line-number\":\"11\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"structuredContent\"}),\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"12\",children:[\" content: [\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"13\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"createText\"}),\"(\",\"`\",(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:'Creature \"'}),\"${\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"creature\"}),\".\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"name\"}),\"}\",(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:'\" added to your stable!'}),\"`\",\"),\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"14\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"createCreatureResourceLink\"}),\"(\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"creature\"}),\"),\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-highlight\":\"true\",\"data-line-number\":\"15\",children:[\" \",(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"createText\"}),\"(\",(0,a.jsx)(e.span,{style:{color:\"var(--base08)\"},children:\"structuredContent\"}),\"),\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"16\",children:[\" ],\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"17\",children:[\" }\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"18\",children:[\"}\",`\n`]})]})}),`\n`,(0,a.jsx)(e.p,{children:\"Here's what a structured output response looks like:\"}),`\n`,(0,a.jsx)(e.pre,{\"data-filename\":\"server-response.json\",\"data-nocopy\":\"\",\"data-line-numbers\":\"true\",\"data-lang\":\"json\",style:{color:\"var(--base05)\",backgroundColor:\"var(--base00)\"},children:(0,a.jsxs)(e.code,{children:[(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"1\",children:[\"{\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"2\",children:[\"\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"content\"}),'\"',\": [\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"3\",children:[\"\t\t{\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"4\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"type\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"text\"}),'\"',\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"5\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"text\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Creature \"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Twinklehoof\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\" added to your stable!\"}),'\"',`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"6\",children:[\"\t\t},\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"7\",children:[\"\t\t{\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"8\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"type\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"resource_link\"}),'\"',\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"9\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"uri\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"epicme://creatures/42\"}),'\"',\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"10\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"mimeType\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"application/json\"}),'\"',`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"11\",children:[\"\t\t},\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"12\",children:[\"\t\t{\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"13\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"type\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"text\"}),'\"',\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"14\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"text\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"{\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"creature\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\":{\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"id\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\":42,\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"name\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\":\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Twinklehoof\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\",\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"species\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\":\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Unicorn\"}),(0,a.jsx)(e.span,{style:{color:\"var(--base0C)\"},children:'\\\\\"'}),(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"}}\"}),'\"',`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"15\",children:[\"\t\t}\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"16\",children:[\"\t],\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"17\",children:[\"\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"structuredContent\"}),'\"',\": {\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"18\",children:[\"\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"creature\"}),'\"',\": {\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"19\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"id\"}),'\"',\": \",(0,a.jsx)(e.span,{style:{color:\"var(--base09)\"},children:\"42\"}),\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"20\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"name\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Twinklehoof\"}),'\"',\",\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"21\",children:[\"\t\t\t\",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0D)\"},children:\"species\"}),'\"',\": \",'\"',(0,a.jsx)(e.span,{style:{color:\"var(--base0B)\"},children:\"Unicorn\"}),'\"',`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"22\",children:[\"\t\t}\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"23\",children:[\"\t}\",`\n`]}),(0,a.jsxs)(e.span,{className:\"codeblock-line\",\"data-line-number\":\"24\",children:[\"}\",`\n`]})]})}),`\n`,(0,a.jsx)(\"callout-info\",{children:(0,a.jsxs)(e.p,{children:[\"Note that the \",(0,a.jsx)(e.code,{children:\"structuredContent\"}),` is a JSON object that matches the\n`,(0,a.jsx)(e.code,{children:\"outputSchema\"}),` of the tool and we also have a text content that is a JSON\nstring equal to the `,(0,a.jsx)(e.code,{children:\"structuredContent\"}),` object. This is a fallback for clients\nthat don't support structured output and is validated by the MCP Inspector.`]})}),`\n`,(0,a.jsx)(\"callout-muted\",{children:(0,a.jsxs)(e.p,{children:[\"\\u{1F4DC} For more details on structured output and output schemas, see the \",(0,a.jsx)(e.a,{href:\"https://modelcontextprotocol.io/specification/2025-06-18/server/tools#structured-content\",children:`official\nMCP\ndocumentation`}),\".\"]})}),`\n`,(0,a.jsx)(e.p,{children:\"The goal: make every journaling action in EpicMe feel seamless, safe, and delightful\\u2014so users can focus on capturing their stories, not on deciphering cryptic responses.\"}),`\n`,(0,a.jsx)(\"callout-info\",{children:(0,a.jsx)(e.p,{children:`\\u{1F428} Note (again): I have you add this to every tool, but feel free to stop and\nmove on.`})}),`\n`,(0,a.jsx)(e.p,{children:'To test this in the MCP inspector, simply connect and click \"Tools\" and \"List Tools,\" then check the output schema in the response. Then you can run one of the tools and verify the output includes the structured content.'})]})}function h(n={}){let{wrapper:e}=n.components||{};return e?(0,a.jsx)(e,{...n,children:(0,a.jsx)(d,{...n})}):d(n)}function C(n,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+n+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return f(B);})();\n;return Component;",[451],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/structured-output~egacc",{"_9":427,"_427":428},{"_9":427,"_431":454,"_164":165},6002,"https://stackblitz.com/github/epicweb-dev/advanced-mcp-features/tree/main/exercises/01.advanced-tools/02.problem.structured?view=editor&hidedevtools=1&terminalHeight=0&hideNavigation=1&title=Structured+Output+%28problem%29",{"_20":35,"_112":312,"_405":457,"_22":36,"_24":37,"_407":458,"_422":459,"_425":461,"_429":462,"_433":464,"_242":245,"_244":259,"_9":241,"_445":-5},"02.solution.structured","var Component=(()=>{var l=Object.create;var i=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var w=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),x=(t,e)=>{for(var n in e)i(t,n,{get:e[n],enumerable:!0})},s=(t,e,n,a)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let o of h(e))!g.call(t,o)&&o!==n&&i(t,o,{get:()=>e[o],enumerable:!(a=m(e,o))||a.enumerable});return t};var y=(t,e,n)=>(n=t!=null?l(f(t)):{},s(e||!t||!t.__esModule?i(n,\"default\",{value:t,enumerable:!0}):n,t)),v=t=>s(i({},\"__esModule\",{value:!0}),t);var c=w((E,u)=>{u.exports=_jsx_runtime});var _={};x(_,{default:()=>p,frontmatter:()=>j});var r=y(c()),j=void 0;function d(t){let e={h1:\"h1\",p:\"p\",...t.components},{EpicVideo:n}=e;return n||b(\"EpicVideo\",!0),(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(e.h1,{children:\"Structured Output\"}),`\n`,(0,r.jsx)(n,{url:\"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/structured-output~egacc/solution\"}),`\n`,(0,r.jsx)(e.p,{children:\"\\u{1F468}\\u200D\\u{1F4BC} Outstanding achievement! We've now brought structured output to our journaling tools, ensuring every action in EpicMe returns information in a clear, machine-validated format. This means users can trust that their memories, reflections, and daily adventures are always organized and reliably presented\\u2014no more cryptic or unpredictable responses. The UI can now display journal entries, tags, and magical creatures (\\u{1F609}) with confidence, knowing exactly what to expect from each tool. This upgrade not only makes the experience more seamless and delightful for our users, but also paves the way for smarter automation and safer interactions throughout the app.\"}),`\n`,(0,r.jsx)(e.p,{children:\"With structured output in place, EpicMe is even better equipped to help users capture and revisit their stories, making every journaling moment feel effortless and secure. Let's keep building on this momentum!\"})]})}function p(t={}){let{wrapper:e}=t.components||{};return e?(0,r.jsx)(e,{...t,children:(0,r.jsx)(d,{...t})}):d(t)}function b(t,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+t+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return v(_);})();\n;return Component;",[460],"https://www.epicai.pro/workshops/advanced-mcp-features-flccv/structured-output~egacc/solution",{"_9":427,"_427":428},{"_9":427,"_431":463,"_164":165},7002,"https://stackblitz.com/github/epicweb-dev/advanced-mcp-features/tree/main/exercises/01.advanced-tools/02.solution.structured?view=editor&hidedevtools=1&terminalHeight=0&hideNavigation=1&title=Structured+Output+%28solution%29",[466,470],{"_20":21,"_112":310,"_405":420,"_22":23,"_24":25,"_407":421,"_422":467,"_425":468,"_429":469,"_433":434,"_242":245,"_244":245,"_9":320,"_435":27},[424],{"_9":427,"_427":428},{"_9":427,"_431":432,"_164":165},{"_20":31,"_112":312,"_405":448,"_22":32,"_24":33,"_407":449,"_422":471,"_425":472,"_429":473,"_433":455,"_242":245,"_244":259,"_9":320,"_435":35},[451],{"_9":427,"_427":428},{"_9":427,"_431":454,"_164":165},[475,479],{"_20":27,"_112":310,"_405":437,"_22":28,"_24":29,"_407":438,"_422":476,"_425":477,"_429":478,"_433":444,"_242":245,"_244":245,"_9":241,"_445":-5},[440],{"_9":427,"_427":428},{"_9":427,"_431":443,"_164":165},{"_20":35,"_112":312,"_405":457,"_22":36,"_24":37,"_407":458,"_422":480,"_425":481,"_429":482,"_433":464,"_242":245,"_244":259,"_9":241,"_445":-5},[460],{"_9":427,"_427":428},{"_9":427,"_431":463,"_164":165},"exerciseFormEmbedUrl","https://docs.google.com/forms/d/e/1FAIpQLSf3o9xyjQepTlOTH5Z7ZwkeSTdXh6YWI_RGc9KiyD3oUN0p6w/viewform?hl=en&embedded=true&entry.1836176234=Advanced%20MCP%20Features%20%F0%9F%90%A1&entry.428900931=Advanced%20Tools","epicVideoInfosPromise",["P",486],"exerciseFinished",{"_489":490,"_24":491},"file","/myapp/workshop-content/exercises/01.advanced-tools/FINISHED.mdx","exercises/01.advanced-tools/FINISHED.mdx","prevStepLink",{"_494":495,"_496":497},"to","/exercise/01/02/solution","aria-label","Structured Output (solution)","nextStepLink",{"_494":500,"_496":327},"/exercise/02","actionData","errors"]

01. Advanced Tools/Elaboration