[{"data":1,"prerenderedAt":1289},["ShallowReactive",2],{"navigation_docs":3,"-tools-annotations":272,"-tools-annotations-surround":1284},[4,40,70,99,122,151,184,243],{"title":5,"path":6,"stem":7,"children":8,"page":39},"Getting Started","\u002Fgetting-started","1.getting-started",[9,14,19,24,29,34],{"title":10,"path":11,"stem":12,"icon":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-book-open",{"title":15,"path":16,"stem":17,"icon":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation","i-lucide-download",{"title":20,"path":21,"stem":22,"icon":23},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F3.configuration","i-lucide-settings",{"title":25,"path":26,"stem":27,"icon":28},"MCP Inspector","\u002Fgetting-started\u002Finspector","1.getting-started\u002F4.inspector","i-lucide-circuit-board",{"title":30,"path":31,"stem":32,"icon":33},"Connection","\u002Fgetting-started\u002Fconnection","1.getting-started\u002F5.connection","i-lucide-plug",{"title":35,"path":36,"stem":37,"icon":38},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","1.getting-started\u002F6.agent-skills","i-lucide-sparkles",false,{"title":41,"path":42,"stem":43,"children":44,"page":39},"Tools","\u002Ftools","2.tools",[45,50,55,60,65],{"title":46,"path":47,"stem":48,"icon":49},"Overview","\u002Ftools\u002Foverview","2.tools\u002F0.overview","i-lucide-wrench",{"title":51,"path":52,"stem":53,"icon":54},"Schema, handler & returns","\u002Ftools\u002Fschema-handler","2.tools\u002F1.schema-handler","i-lucide-braces",{"title":56,"path":57,"stem":58,"icon":59},"Annotations & input examples","\u002Ftools\u002Fannotations","2.tools\u002F2.annotations","i-lucide-badge-info",{"title":61,"path":62,"stem":63,"icon":64},"Errors & caching","\u002Ftools\u002Ferrors-caching","2.tools\u002F3.errors-caching","i-lucide-shield",{"title":66,"path":67,"stem":68,"icon":69},"Groups, files & dynamic registration","\u002Ftools\u002Fgroups-organization","2.tools\u002F4.groups-organization","i-lucide-tags",{"title":71,"path":72,"stem":73,"children":74,"page":39},"Resources","\u002Fresources","3.resources",[75,79,84,89,94],{"title":46,"path":76,"stem":77,"icon":78},"\u002Fresources\u002Foverview","3.resources\u002F0.overview","i-lucide-package",{"title":80,"path":81,"stem":82,"icon":83},"Static resources & structure","\u002Fresources\u002Fstatic-and-structure","3.resources\u002F1.static-and-structure","i-lucide-file-stack",{"title":85,"path":86,"stem":87,"icon":88},"Templates & handlers","\u002Fresources\u002Ftemplates-and-handlers","3.resources\u002F2.templates-and-handlers","i-lucide-git-branch",{"title":90,"path":91,"stem":92,"icon":93},"Metadata, content & errors","\u002Fresources\u002Fcontent-metadata-errors","3.resources\u002F3.content-metadata-errors","i-lucide-layers",{"title":95,"path":96,"stem":97,"icon":98},"Groups & organization","\u002Fresources\u002Forganization","3.resources\u002F4.organization","i-lucide-folder-tree",{"title":100,"path":101,"stem":102,"children":103,"page":39},"Prompts","\u002Fprompts","4.prompts",[104,108,113,117],{"title":46,"path":105,"stem":106,"icon":107},"\u002Fprompts\u002Foverview","4.prompts\u002F0.overview","i-lucide-message-square",{"title":109,"path":110,"stem":111,"icon":112},"Authoring & structure","\u002Fprompts\u002Fauthoring","4.prompts\u002F1.authoring","i-lucide-pen-line",{"title":114,"path":115,"stem":116,"icon":93},"Input, handler & messages","\u002Fprompts\u002Finput-handler-messages","4.prompts\u002F2.input-handler-messages",{"title":118,"path":119,"stem":120,"icon":121},"Patterns & advanced","\u002Fprompts\u002Fpatterns-advanced","4.prompts\u002F3.patterns-advanced","i-lucide-line-chart",{"title":123,"path":124,"stem":125,"children":126,"page":39},"Handlers","\u002Fhandlers","5.handlers",[127,131,136,141,146],{"title":46,"path":128,"stem":129,"icon":130},"\u002Fhandlers\u002Foverview","5.handlers\u002F0.overview","i-lucide-server",{"title":132,"path":133,"stem":134,"icon":135},"Default & custom handlers","\u002Fhandlers\u002Fdefault-and-custom","5.handlers\u002F1.default-and-custom","i-lucide-toggle-left",{"title":137,"path":138,"stem":139,"icon":140},"Structure & options","\u002Fhandlers\u002Fstructure-and-options","5.handlers\u002F2.structure-and-options","i-lucide-sliders-horizontal",{"title":142,"path":143,"stem":144,"icon":145},"Examples & routing","\u002Fhandlers\u002Fexamples-routing","5.handlers\u002F3.examples-routing","i-lucide-route",{"title":147,"path":148,"stem":149,"icon":150},"Sharing & practices","\u002Fhandlers\u002Fsharing-practices","5.handlers\u002F4.sharing-practices","i-lucide-share-2",{"title":152,"path":153,"stem":154,"children":155,"page":39},"Apps","\u002Fapps","6.apps",[156,160,165,170,174,179],{"title":46,"path":157,"stem":158,"icon":159},"\u002Fapps\u002Foverview","6.apps\u002F0.overview","i-lucide-app-window",{"title":161,"path":162,"stem":163,"icon":164},"Authoring & defineMcpApp","\u002Fapps\u002Fauthoring","6.apps\u002F1.authoring","i-lucide-code-2",{"title":166,"path":167,"stem":168,"icon":169},"useMcpApp() bridge","\u002Fapps\u002Fuse-mcp-app","6.apps\u002F2.use-mcp-app","i-lucide-message-circle",{"title":171,"path":172,"stem":173,"icon":64},"CSP & build pipeline","\u002Fapps\u002Fcsp-and-wiring","6.apps\u002F3.csp-and-wiring",{"title":175,"path":176,"stem":177,"icon":178},"Testing & publishing","\u002Fapps\u002Ftesting-publishing","6.apps\u002F4.testing-publishing","i-lucide-rocket",{"title":180,"path":181,"stem":182,"icon":183},"Patterns & limits","\u002Fapps\u002Fpatterns-reference","6.apps\u002F5.patterns-reference","i-lucide-book-marked",{"title":185,"path":186,"stem":187,"children":188,"page":39},"Advanced Topics","\u002Fadvanced","7.advanced",[189,194,199,204,208,213,218,223,228,233,238],{"title":190,"path":191,"stem":192,"icon":193},"Custom Paths","\u002Fadvanced\u002Fcustom-paths","7.advanced\u002F1.custom-paths","i-lucide-folder",{"title":195,"path":196,"stem":197,"icon":198},"Logging","\u002Fadvanced\u002Flogging","7.advanced\u002F10.logging","i-lucide-scroll-text",{"title":200,"path":201,"stem":202,"icon":203},"MCP Apps Internals","\u002Fadvanced\u002Fmcp-apps-internals","7.advanced\u002F11.mcp-apps-internals","i-lucide-cog",{"title":205,"path":206,"stem":207,"icon":64},"Middleware","\u002Fadvanced\u002Fmiddleware","7.advanced\u002F2.middleware",{"title":209,"path":210,"stem":211,"icon":212},"TypeScript","\u002Fadvanced\u002Ftypescript","7.advanced\u002F3.typescript","i-lucide-type",{"title":214,"path":215,"stem":216,"icon":217},"Hooks","\u002Fadvanced\u002Fhooks","7.advanced\u002F4.hooks","i-lucide-webhook",{"title":219,"path":220,"stem":221,"icon":222},"MCP Evals","\u002Fadvanced\u002Fevals","7.advanced\u002F5.evals","i-lucide-flask-conical",{"title":224,"path":225,"stem":226,"icon":227},"Sessions","\u002Fadvanced\u002Fsessions","7.advanced\u002F6.sessions","i-lucide-database",{"title":229,"path":230,"stem":231,"icon":232},"Dynamic Definitions","\u002Fadvanced\u002Fdynamic-definitions","7.advanced\u002F7.dynamic-definitions","i-lucide-toggle-right",{"title":234,"path":235,"stem":236,"icon":237},"Code Mode","\u002Fadvanced\u002Fcode-mode","7.advanced\u002F8.code-mode","i-lucide-code",{"title":239,"path":240,"stem":241,"icon":242},"Elicitation","\u002Fadvanced\u002Felicitation","7.advanced\u002F9.elicitation","i-lucide-message-square-quote",{"title":244,"path":245,"stem":246,"children":247,"page":39},"Examples","\u002Fexamples","8.examples",[248,253,258,263,268],{"title":249,"path":250,"stem":251,"icon":252},"Authentication","\u002Fexamples\u002Fauthentication","8.examples\u002F1.authentication","i-lucide-shield-check",{"title":254,"path":255,"stem":256,"icon":257},"API Integration","\u002Fexamples\u002Fapi-integration","8.examples\u002F2.api-integration","i-lucide-globe",{"title":259,"path":260,"stem":261,"icon":262},"Common Patterns","\u002Fexamples\u002Fcommon-patterns","8.examples\u002F3.common-patterns","i-lucide-lightbulb",{"title":264,"path":265,"stem":266,"icon":267},"File Operations","\u002Fexamples\u002Ffile-operations","8.examples\u002F4.file-operations","i-lucide-file",{"title":269,"path":270,"stem":271,"icon":107},"Prompt Examples","\u002Fexamples\u002Fprompt-examples","8.examples\u002F5.prompt-examples",{"id":273,"title":56,"body":274,"description":1275,"extension":1276,"links":1277,"meta":1278,"navigation":1279,"path":57,"seo":1280,"stem":58,"__hash__":1283},"docs\u002F2.tools\u002F2.annotations.md",{"type":275,"value":276,"toc":1269},"minimark",[277,282,286,579,584,706,709,961,972,976,990,993,1259,1265],[278,279,281],"h2",{"id":280},"tool-annotations","Tool Annotations",[283,284,285],"p",{},"Annotations are behavioral hints that tell MCP clients how a tool behaves. Clients can use them to decide when to prompt users for confirmation (human-in-the-loop).",[287,288,294],"pre",{"className":289,"code":290,"filename":291,"language":292,"meta":293,"style":293},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { z } from 'zod'\nimport { defineMcpTool } from '@nuxtjs\u002Fmcp-toolkit\u002Fserver'\n\nexport default defineMcpTool({\n  name: 'delete-user',\n  description: 'Delete a user account',\n  inputSchema: {\n    userId: z.string(),\n  },\n  annotations: {\n    readOnlyHint: false,    \u002F\u002F Tool modifies state\n    destructiveHint: true,  \u002F\u002F Tool performs destructive updates\n    idempotentHint: true,   \u002F\u002F Deleting the same user twice has no additional effect\n    openWorldHint: false,   \u002F\u002F Tool does not interact with external systems\n  },\n  handler: async ({ userId }) => {\n    \u002F\u002F ...\n  },\n})\n","server\u002Fmcp\u002Ftools\u002Fdelete-user.ts","typescript","",[295,296,297,330,351,358,376,397,414,425,446,452,462,481,497,512,527,532,559,565,570],"code",{"__ignoreMap":293},[298,299,302,306,310,314,317,320,323,327],"span",{"class":300,"line":301},"line",1,[298,303,305],{"class":304},"s7zQu","import",[298,307,309],{"class":308},"sMK4o"," {",[298,311,313],{"class":312},"sTEyZ"," z",[298,315,316],{"class":308}," }",[298,318,319],{"class":304}," from",[298,321,322],{"class":308}," '",[298,324,326],{"class":325},"sfazB","zod",[298,328,329],{"class":308},"'\n",[298,331,333,335,337,340,342,344,346,349],{"class":300,"line":332},2,[298,334,305],{"class":304},[298,336,309],{"class":308},[298,338,339],{"class":312}," defineMcpTool",[298,341,316],{"class":308},[298,343,319],{"class":304},[298,345,322],{"class":308},[298,347,348],{"class":325},"@nuxtjs\u002Fmcp-toolkit\u002Fserver",[298,350,329],{"class":308},[298,352,354],{"class":300,"line":353},3,[298,355,357],{"emptyLinePlaceholder":356},true,"\n",[298,359,361,364,367,370,373],{"class":300,"line":360},4,[298,362,363],{"class":304},"export",[298,365,366],{"class":304}," default",[298,368,339],{"class":369},"s2Zo4",[298,371,372],{"class":312},"(",[298,374,375],{"class":308},"{\n",[298,377,379,383,386,388,391,394],{"class":300,"line":378},5,[298,380,382],{"class":381},"swJcz","  name",[298,384,385],{"class":308},":",[298,387,322],{"class":308},[298,389,390],{"class":325},"delete-user",[298,392,393],{"class":308},"'",[298,395,396],{"class":308},",\n",[298,398,400,403,405,407,410,412],{"class":300,"line":399},6,[298,401,402],{"class":381},"  description",[298,404,385],{"class":308},[298,406,322],{"class":308},[298,408,409],{"class":325},"Delete a user account",[298,411,393],{"class":308},[298,413,396],{"class":308},[298,415,417,420,422],{"class":300,"line":416},7,[298,418,419],{"class":381},"  inputSchema",[298,421,385],{"class":308},[298,423,424],{"class":308}," {\n",[298,426,428,431,433,435,438,441,444],{"class":300,"line":427},8,[298,429,430],{"class":381},"    userId",[298,432,385],{"class":308},[298,434,313],{"class":312},[298,436,437],{"class":308},".",[298,439,440],{"class":369},"string",[298,442,443],{"class":312},"()",[298,445,396],{"class":308},[298,447,449],{"class":300,"line":448},9,[298,450,451],{"class":308},"  },\n",[298,453,455,458,460],{"class":300,"line":454},10,[298,456,457],{"class":381},"  annotations",[298,459,385],{"class":308},[298,461,424],{"class":308},[298,463,465,468,470,474,477],{"class":300,"line":464},11,[298,466,467],{"class":381},"    readOnlyHint",[298,469,385],{"class":308},[298,471,473],{"class":472},"sfNiH"," false",[298,475,476],{"class":308},",",[298,478,480],{"class":479},"sHwdD","    \u002F\u002F Tool modifies state\n",[298,482,484,487,489,492,494],{"class":300,"line":483},12,[298,485,486],{"class":381},"    destructiveHint",[298,488,385],{"class":308},[298,490,491],{"class":472}," true",[298,493,476],{"class":308},[298,495,496],{"class":479},"  \u002F\u002F Tool performs destructive updates\n",[298,498,500,503,505,507,509],{"class":300,"line":499},13,[298,501,502],{"class":381},"    idempotentHint",[298,504,385],{"class":308},[298,506,491],{"class":472},[298,508,476],{"class":308},[298,510,511],{"class":479},"   \u002F\u002F Deleting the same user twice has no additional effect\n",[298,513,515,518,520,522,524],{"class":300,"line":514},14,[298,516,517],{"class":381},"    openWorldHint",[298,519,385],{"class":308},[298,521,473],{"class":472},[298,523,476],{"class":308},[298,525,526],{"class":479},"   \u002F\u002F Tool does not interact with external systems\n",[298,528,530],{"class":300,"line":529},15,[298,531,451],{"class":308},[298,533,535,538,540,544,547,551,554,557],{"class":300,"line":534},16,[298,536,537],{"class":369},"  handler",[298,539,385],{"class":308},[298,541,543],{"class":542},"spNyl"," async",[298,545,546],{"class":308}," ({",[298,548,550],{"class":549},"sHdIc"," userId",[298,552,553],{"class":308}," })",[298,555,556],{"class":542}," =>",[298,558,424],{"class":308},[298,560,562],{"class":300,"line":561},17,[298,563,564],{"class":479},"    \u002F\u002F ...\n",[298,566,568],{"class":300,"line":567},18,[298,569,451],{"class":308},[298,571,573,576],{"class":300,"line":572},19,[298,574,575],{"class":308},"}",[298,577,578],{"class":312},")\n",[580,581,583],"h3",{"id":582},"annotation-reference","Annotation Reference",[585,586,587,606],"table",{},[588,589,590],"thead",{},[591,592,593,597,600,603],"tr",{},[594,595,596],"th",{},"Annotation",[594,598,599],{},"Type",[594,601,602],{},"Default",[594,604,605],{},"Description",[607,608,609,634,659,683],"tbody",{},[591,610,611,617,622,627],{},[612,613,614],"td",{},[295,615,616],{},"readOnlyHint",[612,618,619],{},[295,620,621],{},"boolean",[612,623,624],{},[295,625,626],{},"false",[612,628,629,630,633],{},"If ",[295,631,632],{},"true",", the tool only reads data without modifying any state (safe to retry).",[591,635,636,641,645,649],{},[612,637,638],{},[295,639,640],{},"destructiveHint",[612,642,643],{},[295,644,621],{},[612,646,647],{},[295,648,632],{},[612,650,629,651,653,654,656,657,437],{},[295,652,632],{},", the tool may perform destructive operations like deleting data. Only meaningful when ",[295,655,616],{}," is ",[295,658,626],{},[591,660,661,666,670,674],{},[612,662,663],{},[295,664,665],{},"idempotentHint",[612,667,668],{},[295,669,621],{},[612,671,672],{},[295,673,626],{},[612,675,629,676,678,679,656,681,437],{},[295,677,632],{},", calling the tool multiple times with the same arguments has no additional effect beyond the first call. Only meaningful when ",[295,680,616],{},[295,682,626],{},[591,684,685,690,694,698],{},[612,686,687],{},[295,688,689],{},"openWorldHint",[612,691,692],{},[295,693,621],{},[612,695,696],{},[295,697,632],{},[612,699,629,700,702,703,705],{},[295,701,632],{},", the tool may interact with the outside world (external APIs, internet). If ",[295,704,626],{},", it only operates on local\u002Finternal data.",[283,707,708],{},"Here are common annotation patterns for typical tools:",[710,711,712,771,835,898],"code-group",{},[287,713,716],{"className":289,"code":714,"filename":715,"language":292,"meta":293,"style":293},"\u002F\u002F Search, list, lookup, calculate...\nannotations: {\n  readOnlyHint: true,\n  destructiveHint: false,\n  openWorldHint: false,\n}\n","Read-only tool",[295,717,718,723,733,744,755,766],{"__ignoreMap":293},[298,719,720],{"class":300,"line":301},[298,721,722],{"class":479},"\u002F\u002F Search, list, lookup, calculate...\n",[298,724,725,729,731],{"class":300,"line":332},[298,726,728],{"class":727},"sBMFI","annotations",[298,730,385],{"class":308},[298,732,424],{"class":308},[298,734,735,738,740,742],{"class":300,"line":353},[298,736,737],{"class":727},"  readOnlyHint",[298,739,385],{"class":308},[298,741,491],{"class":472},[298,743,396],{"class":308},[298,745,746,749,751,753],{"class":300,"line":360},[298,747,748],{"class":727},"  destructiveHint",[298,750,385],{"class":308},[298,752,473],{"class":472},[298,754,396],{"class":308},[298,756,757,760,762,764],{"class":300,"line":378},[298,758,759],{"class":727},"  openWorldHint",[298,761,385],{"class":308},[298,763,473],{"class":472},[298,765,396],{"class":308},[298,767,768],{"class":300,"line":399},[298,769,770],{"class":308},"}\n",[287,772,775],{"className":289,"code":773,"filename":774,"language":292,"meta":293,"style":293},"\u002F\u002F Creates a new record each time\nannotations: {\n  readOnlyHint: false,\n  destructiveHint: false,\n  idempotentHint: false,\n  openWorldHint: false,\n}\n","Create tool",[295,776,777,782,790,800,810,821,831],{"__ignoreMap":293},[298,778,779],{"class":300,"line":301},[298,780,781],{"class":479},"\u002F\u002F Creates a new record each time\n",[298,783,784,786,788],{"class":300,"line":332},[298,785,728],{"class":727},[298,787,385],{"class":308},[298,789,424],{"class":308},[298,791,792,794,796,798],{"class":300,"line":353},[298,793,737],{"class":727},[298,795,385],{"class":308},[298,797,473],{"class":472},[298,799,396],{"class":308},[298,801,802,804,806,808],{"class":300,"line":360},[298,803,748],{"class":727},[298,805,385],{"class":308},[298,807,473],{"class":472},[298,809,396],{"class":308},[298,811,812,815,817,819],{"class":300,"line":378},[298,813,814],{"class":727},"  idempotentHint",[298,816,385],{"class":308},[298,818,473],{"class":472},[298,820,396],{"class":308},[298,822,823,825,827,829],{"class":300,"line":399},[298,824,759],{"class":727},[298,826,385],{"class":308},[298,828,473],{"class":472},[298,830,396],{"class":308},[298,832,833],{"class":300,"line":416},[298,834,770],{"class":308},[287,836,839],{"className":289,"code":837,"filename":838,"language":292,"meta":293,"style":293},"\u002F\u002F Updates are idempotent (same input → same result)\nannotations: {\n  readOnlyHint: false,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n}\n","Update tool",[295,840,841,846,854,864,874,884,894],{"__ignoreMap":293},[298,842,843],{"class":300,"line":301},[298,844,845],{"class":479},"\u002F\u002F Updates are idempotent (same input → same result)\n",[298,847,848,850,852],{"class":300,"line":332},[298,849,728],{"class":727},[298,851,385],{"class":308},[298,853,424],{"class":308},[298,855,856,858,860,862],{"class":300,"line":353},[298,857,737],{"class":727},[298,859,385],{"class":308},[298,861,473],{"class":472},[298,863,396],{"class":308},[298,865,866,868,870,872],{"class":300,"line":360},[298,867,748],{"class":727},[298,869,385],{"class":308},[298,871,473],{"class":472},[298,873,396],{"class":308},[298,875,876,878,880,882],{"class":300,"line":378},[298,877,814],{"class":727},[298,879,385],{"class":308},[298,881,491],{"class":472},[298,883,396],{"class":308},[298,885,886,888,890,892],{"class":300,"line":399},[298,887,759],{"class":727},[298,889,385],{"class":308},[298,891,473],{"class":472},[298,893,396],{"class":308},[298,895,896],{"class":300,"line":416},[298,897,770],{"class":308},[287,899,902],{"className":289,"code":900,"filename":901,"language":292,"meta":293,"style":293},"\u002F\u002F Destructive and idempotent (deleting twice is the same)\nannotations: {\n  readOnlyHint: false,\n  destructiveHint: true,\n  idempotentHint: true,\n  openWorldHint: false,\n}\n","Delete tool",[295,903,904,909,917,927,937,947,957],{"__ignoreMap":293},[298,905,906],{"class":300,"line":301},[298,907,908],{"class":479},"\u002F\u002F Destructive and idempotent (deleting twice is the same)\n",[298,910,911,913,915],{"class":300,"line":332},[298,912,728],{"class":727},[298,914,385],{"class":308},[298,916,424],{"class":308},[298,918,919,921,923,925],{"class":300,"line":353},[298,920,737],{"class":727},[298,922,385],{"class":308},[298,924,473],{"class":472},[298,926,396],{"class":308},[298,928,929,931,933,935],{"class":300,"line":360},[298,930,748],{"class":727},[298,932,385],{"class":308},[298,934,491],{"class":472},[298,936,396],{"class":308},[298,938,939,941,943,945],{"class":300,"line":378},[298,940,814],{"class":727},[298,942,385],{"class":308},[298,944,491],{"class":472},[298,946,396],{"class":308},[298,948,949,951,953,955],{"class":300,"line":399},[298,950,759],{"class":727},[298,952,385],{"class":308},[298,954,473],{"class":472},[298,956,396],{"class":308},[298,958,959],{"class":300,"line":416},[298,960,770],{"class":308},[962,963,966,967,971],"callout",{"color":964,"icon":965},"info","i-lucide-info","All annotations are ",[968,969,970],"strong",{},"hints"," — they are not guaranteed to be respected by every MCP client. Clients should never make security-critical decisions based on annotations from untrusted servers.",[278,973,975],{"id":974},"input-examples","Input Examples",[283,977,978,979,982,983,986,987,437],{},"You can provide concrete usage examples for your tools using ",[295,980,981],{},"inputExamples",". These examples are type-safe (matching your ",[295,984,985],{},"inputSchema",") and are transmitted to clients via ",[295,988,989],{},"_meta.inputExamples",[283,991,992],{},"Input examples help AI models understand how to correctly fill in tool parameters, especially for tools with optional fields or complex inputs.",[287,994,997],{"className":289,"code":995,"filename":996,"language":292,"meta":293,"style":293},"import { z } from 'zod'\nimport { defineMcpTool } from '@nuxtjs\u002Fmcp-toolkit\u002Fserver'\n\nexport default defineMcpTool({\n  description: 'Create a new todo',\n  inputSchema: {\n    title: z.string().describe('The title of the todo'),\n    content: z.string().optional().describe('Optional description'),\n  },\n  inputExamples: [\n    { title: 'Buy groceries', content: 'Milk, eggs, bread' },\n    { title: 'Fix login bug' },  \u002F\u002F content is optional\n  ],\n  handler: async ({ title, content }) => {\n    \u002F\u002F ...\n  },\n})\n","server\u002Fmcp\u002Ftools\u002Fcreate-todo.ts",[295,998,999,1017,1035,1039,1051,1066,1074,1108,1147,1151,1161,1195,1216,1223,1245,1249,1253],{"__ignoreMap":293},[298,1000,1001,1003,1005,1007,1009,1011,1013,1015],{"class":300,"line":301},[298,1002,305],{"class":304},[298,1004,309],{"class":308},[298,1006,313],{"class":312},[298,1008,316],{"class":308},[298,1010,319],{"class":304},[298,1012,322],{"class":308},[298,1014,326],{"class":325},[298,1016,329],{"class":308},[298,1018,1019,1021,1023,1025,1027,1029,1031,1033],{"class":300,"line":332},[298,1020,305],{"class":304},[298,1022,309],{"class":308},[298,1024,339],{"class":312},[298,1026,316],{"class":308},[298,1028,319],{"class":304},[298,1030,322],{"class":308},[298,1032,348],{"class":325},[298,1034,329],{"class":308},[298,1036,1037],{"class":300,"line":353},[298,1038,357],{"emptyLinePlaceholder":356},[298,1040,1041,1043,1045,1047,1049],{"class":300,"line":360},[298,1042,363],{"class":304},[298,1044,366],{"class":304},[298,1046,339],{"class":369},[298,1048,372],{"class":312},[298,1050,375],{"class":308},[298,1052,1053,1055,1057,1059,1062,1064],{"class":300,"line":378},[298,1054,402],{"class":381},[298,1056,385],{"class":308},[298,1058,322],{"class":308},[298,1060,1061],{"class":325},"Create a new todo",[298,1063,393],{"class":308},[298,1065,396],{"class":308},[298,1067,1068,1070,1072],{"class":300,"line":399},[298,1069,419],{"class":381},[298,1071,385],{"class":308},[298,1073,424],{"class":308},[298,1075,1076,1079,1081,1083,1085,1087,1089,1091,1094,1096,1098,1101,1103,1106],{"class":300,"line":416},[298,1077,1078],{"class":381},"    title",[298,1080,385],{"class":308},[298,1082,313],{"class":312},[298,1084,437],{"class":308},[298,1086,440],{"class":369},[298,1088,443],{"class":312},[298,1090,437],{"class":308},[298,1092,1093],{"class":369},"describe",[298,1095,372],{"class":312},[298,1097,393],{"class":308},[298,1099,1100],{"class":325},"The title of the todo",[298,1102,393],{"class":308},[298,1104,1105],{"class":312},")",[298,1107,396],{"class":308},[298,1109,1110,1113,1115,1117,1119,1121,1123,1125,1128,1130,1132,1134,1136,1138,1141,1143,1145],{"class":300,"line":427},[298,1111,1112],{"class":381},"    content",[298,1114,385],{"class":308},[298,1116,313],{"class":312},[298,1118,437],{"class":308},[298,1120,440],{"class":369},[298,1122,443],{"class":312},[298,1124,437],{"class":308},[298,1126,1127],{"class":369},"optional",[298,1129,443],{"class":312},[298,1131,437],{"class":308},[298,1133,1093],{"class":369},[298,1135,372],{"class":312},[298,1137,393],{"class":308},[298,1139,1140],{"class":325},"Optional description",[298,1142,393],{"class":308},[298,1144,1105],{"class":312},[298,1146,396],{"class":308},[298,1148,1149],{"class":300,"line":448},[298,1150,451],{"class":308},[298,1152,1153,1156,1158],{"class":300,"line":454},[298,1154,1155],{"class":381},"  inputExamples",[298,1157,385],{"class":308},[298,1159,1160],{"class":312}," [\n",[298,1162,1163,1166,1169,1171,1173,1176,1178,1180,1183,1185,1187,1190,1192],{"class":300,"line":464},[298,1164,1165],{"class":308},"    {",[298,1167,1168],{"class":381}," title",[298,1170,385],{"class":308},[298,1172,322],{"class":308},[298,1174,1175],{"class":325},"Buy groceries",[298,1177,393],{"class":308},[298,1179,476],{"class":308},[298,1181,1182],{"class":381}," content",[298,1184,385],{"class":308},[298,1186,322],{"class":308},[298,1188,1189],{"class":325},"Milk, eggs, bread",[298,1191,393],{"class":308},[298,1193,1194],{"class":308}," },\n",[298,1196,1197,1199,1201,1203,1205,1208,1210,1213],{"class":300,"line":483},[298,1198,1165],{"class":308},[298,1200,1168],{"class":381},[298,1202,385],{"class":308},[298,1204,322],{"class":308},[298,1206,1207],{"class":325},"Fix login bug",[298,1209,393],{"class":308},[298,1211,1212],{"class":308}," },",[298,1214,1215],{"class":479},"  \u002F\u002F content is optional\n",[298,1217,1218,1221],{"class":300,"line":499},[298,1219,1220],{"class":312},"  ]",[298,1222,396],{"class":308},[298,1224,1225,1227,1229,1231,1233,1235,1237,1239,1241,1243],{"class":300,"line":514},[298,1226,537],{"class":369},[298,1228,385],{"class":308},[298,1230,543],{"class":542},[298,1232,546],{"class":308},[298,1234,1168],{"class":549},[298,1236,476],{"class":308},[298,1238,1182],{"class":549},[298,1240,553],{"class":308},[298,1242,556],{"class":542},[298,1244,424],{"class":308},[298,1246,1247],{"class":300,"line":529},[298,1248,564],{"class":479},[298,1250,1251],{"class":300,"line":534},[298,1252,451],{"class":308},[298,1254,1255,1257],{"class":300,"line":561},[298,1256,575],{"class":308},[298,1258,578],{"class":312},[962,1260,1262,1264],{"color":1261,"icon":262},"warning",[295,1263,981],{}," are particularly useful for tools with optional parameters, enums, or complex nested inputs where showing concrete values helps models pick the right format.",[1266,1267,1268],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":293,"searchDepth":332,"depth":332,"links":1270},[1271,1274],{"id":280,"depth":332,"text":281,"children":1272},[1273],{"id":582,"depth":353,"text":583},{"id":974,"depth":332,"text":975},"Behavioral hints for MCP clients and concrete inputExamples for complex tools.","md",null,{},{"icon":59},{"title":1281,"description":1282},"Tool annotations & input examples","readOnlyHint, destructiveHint, idempotentHint, openWorldHint, and type-safe inputExamples for MCP tools.","W-ws_eiho0zUmIhzCKQdlZKhjXeogpf_cIuqLxn0Gek",[1285,1287],{"title":51,"path":52,"stem":53,"description":1286,"icon":54,"children":-1},"Define tool inputs and outputs with Zod, and return text, structured data, or media from handlers.",{"title":61,"path":62,"stem":63,"description":1288,"icon":64,"children":-1},"H3 and plain errors in tool handlers, and Nitro-backed response caching.",1777306544069]