[{"data":1,"prerenderedAt":518},["ShallowReactive",2],{"navigation_docs":3,"-prompts-overview":287,"-prompts-overview-surround":513},[4,40,70,99,122,156,189,258],{"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},"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,151],{"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,"icon":155},"Multi-handler organization","\u002Fhandlers\u002Forganization","5.handlers\u002F5.organization","i-lucide-network",{"title":157,"path":158,"stem":159,"children":160,"page":39},"Apps","\u002Fapps","6.apps",[161,165,170,175,179,184],{"title":46,"path":162,"stem":163,"icon":164},"\u002Fapps\u002Foverview","6.apps\u002F0.overview","i-lucide-app-window",{"title":166,"path":167,"stem":168,"icon":169},"Authoring & defineMcpApp","\u002Fapps\u002Fauthoring","6.apps\u002F1.authoring","i-lucide-code-2",{"title":171,"path":172,"stem":173,"icon":174},"useMcpApp() bridge","\u002Fapps\u002Fuse-mcp-app","6.apps\u002F2.use-mcp-app","i-lucide-message-circle",{"title":176,"path":177,"stem":178,"icon":64},"CSP & build pipeline","\u002Fapps\u002Fcsp-and-wiring","6.apps\u002F3.csp-and-wiring",{"title":180,"path":181,"stem":182,"icon":183},"Testing & publishing","\u002Fapps\u002Ftesting-publishing","6.apps\u002F4.testing-publishing","i-lucide-rocket",{"title":185,"path":186,"stem":187,"icon":188},"Patterns & limits","\u002Fapps\u002Fpatterns-reference","6.apps\u002F5.patterns-reference","i-lucide-book-marked",{"title":190,"path":191,"stem":192,"children":193,"page":39},"Advanced Topics","\u002Fadvanced","7.advanced",[194,199,204,209,214,219,223,228,233,238,243,248,253],{"title":195,"path":196,"stem":197,"icon":198},"Custom Paths","\u002Fadvanced\u002Fcustom-paths","7.advanced\u002F1.custom-paths","i-lucide-folder",{"title":200,"path":201,"stem":202,"icon":203},"Logging","\u002Fadvanced\u002Flogging","7.advanced\u002F10.logging","i-lucide-scroll-text",{"title":205,"path":206,"stem":207,"icon":208},"MCP Apps Internals","\u002Fadvanced\u002Fmcp-apps-internals","7.advanced\u002F11.mcp-apps-internals","i-lucide-cog",{"title":210,"path":211,"stem":212,"icon":213},"Listing Definitions","\u002Fadvanced\u002Flisting-definitions","7.advanced\u002F12.listing-definitions","i-lucide-list",{"title":215,"path":216,"stem":217,"icon":218},"llms.txt discovery","\u002Fadvanced\u002Fllms-txt","7.advanced\u002F13.llms-txt","i-lucide-file-text",{"title":220,"path":221,"stem":222,"icon":64},"Middleware","\u002Fadvanced\u002Fmiddleware","7.advanced\u002F2.middleware",{"title":224,"path":225,"stem":226,"icon":227},"TypeScript","\u002Fadvanced\u002Ftypescript","7.advanced\u002F3.typescript","i-lucide-type",{"title":229,"path":230,"stem":231,"icon":232},"Hooks","\u002Fadvanced\u002Fhooks","7.advanced\u002F4.hooks","i-lucide-webhook",{"title":234,"path":235,"stem":236,"icon":237},"MCP Evals","\u002Fadvanced\u002Fevals","7.advanced\u002F5.evals","i-lucide-flask-conical",{"title":239,"path":240,"stem":241,"icon":242},"Sessions","\u002Fadvanced\u002Fsessions","7.advanced\u002F6.sessions","i-lucide-database",{"title":244,"path":245,"stem":246,"icon":247},"Dynamic Definitions","\u002Fadvanced\u002Fdynamic-definitions","7.advanced\u002F7.dynamic-definitions","i-lucide-toggle-right",{"title":249,"path":250,"stem":251,"icon":252},"Code Mode","\u002Fadvanced\u002Fcode-mode","7.advanced\u002F8.code-mode","i-lucide-code",{"title":254,"path":255,"stem":256,"icon":257},"Elicitation","\u002Fadvanced\u002Felicitation","7.advanced\u002F9.elicitation","i-lucide-message-square-quote",{"title":259,"path":260,"stem":261,"children":262,"page":39},"Examples","\u002Fexamples","8.examples",[263,268,273,278,283],{"title":264,"path":265,"stem":266,"icon":267},"Authentication","\u002Fexamples\u002Fauthentication","8.examples\u002F1.authentication","i-lucide-shield-check",{"title":269,"path":270,"stem":271,"icon":272},"API Integration","\u002Fexamples\u002Fapi-integration","8.examples\u002F2.api-integration","i-lucide-globe",{"title":274,"path":275,"stem":276,"icon":277},"Common Patterns","\u002Fexamples\u002Fcommon-patterns","8.examples\u002F3.common-patterns","i-lucide-lightbulb",{"title":279,"path":280,"stem":281,"icon":282},"File Operations","\u002Fexamples\u002Ffile-operations","8.examples\u002F4.file-operations","i-lucide-file",{"title":284,"path":285,"stem":286,"icon":107},"Prompt Examples","\u002Fexamples\u002Fprompt-examples","8.examples\u002F5.prompt-examples",{"id":288,"title":100,"body":289,"description":501,"extension":502,"links":503,"meta":508,"navigation":509,"path":105,"seo":510,"stem":106,"__hash__":512},"docs\u002F4.prompts\u002F0.overview.md",{"type":290,"value":291,"toc":489},"minimark",[292,297,301,354,358,361,384,387,390,395,437,448,452,468,472],[293,294,296],"h2",{"id":295},"what-are-prompts","What are Prompts?",[298,299,300],"p",{},"Prompts are reusable message templates that can be used by AI assistants. They can include dynamic arguments and return pre-formatted messages.",[302,303,306,309,345],"prompt",{":actions":304,"description":305,"icon":107},"[\"copy\",\"cursor\",\"windsurf\"]","Scaffold a new MCP prompt",[298,307,308],{},"Create a new MCP prompt in my Nuxt app using @nuxtjs\u002Fmcp-toolkit.",[310,311,312,316,319,322,330,333,336,339,342],"ul",{},[313,314,315],"li",{},"Create a file in server\u002Fmcp\u002Fprompts\u002F (e.g. server\u002Fmcp\u002Fprompts\u002Freview-code.ts)",[313,317,318],{},"Use defineMcpPrompt (auto-imported) with a description and handler",[313,320,321],{},"The handler can return a string (auto-wrapped as a user message) or a full GetPromptResult with messages array",[313,323,324,325,329],{},"Define arguments with ",[326,327,328],"code",{},"import { z } from 'zod'"," in inputSchema (prompt arguments must be strings)",[313,331,332],{},"Use the role option ('user' or 'assistant') to control the default role for string returns",[313,334,335],{},"Use completable() to provide autocompletion suggestions for arguments",[313,337,338],{},"Return multiple messages to create a conversation flow",[313,340,341],{},"Name and title are auto-generated from the filename",[313,343,344],{},"Prompts appear in Cursor and VS Code when typing \u002F in the chat",[298,346,347,348],{},"Docs: ",[349,350,351],"a",{"href":351,"rel":352},"https:\u002F\u002Fmcp-toolkit.nuxt.dev\u002Fprompts\u002Foverview",[353],"nofollow",[293,355,357],{"id":356},"why-use-prompts","Why Use Prompts?",[298,359,360],{},"MCP prompts offer several advantages over ad-hoc instructions:",[362,363,364,370,375,380],"card-group",{},[365,366,369],"card",{"icon":367,"title":368},"i-lucide-repeat","Reusability","Define once, use everywhere. Share prompts across your team for consistent AI interactions.",[365,371,374],{"icon":372,"title":373},"i-lucide-check-square","Standardization","Ensure consistent formatting and context for specific tasks like code reviews or documentation.",[365,376,379],{"icon":377,"title":378},"i-lucide-settings-2","Customization","Use arguments to adapt prompts to different contexts while maintaining structure.",[365,381,383],{"icon":33,"title":382},"IDE Integration","Prompts appear in Cursor, VS Code, and Visual Studio for easy access during development.",[293,385,382],{"id":386},"ide-integration",[298,388,389],{},"MCP prompts integrate seamlessly with modern development environments. When your MCP server is connected, prompts become available directly in your IDE.",[391,392,394],"h3",{"id":393},"using-prompts-in-cursor-vs-code","Using Prompts in Cursor \u002F VS Code",[396,397,398,411,421,431],"ol",{},[313,399,400,407,408,410],{},[401,402,403,404],"strong",{},"Type ",[326,405,406],{},"\u002F"," — in the chat, type ",[326,409,406],{}," to see all available MCP prompts.",[313,412,413,416,417,420],{},[401,414,415],{},"Select a prompt"," — choose from the list (e.g. ",[326,418,419],{},"local-mcp\u002Fsetup-mcp-server",").",[313,422,423,426,427,430],{},[401,424,425],{},"Fill arguments"," — for parameterized prompts, a dialog appears to collect the values defined in your ",[326,428,429],{},"inputSchema",".",[313,432,433,436],{},[401,434,435],{},"Send"," — the prompt's messages are inserted into the conversation as if you had typed them.",[298,438,439,440,443,444,447],{},"Prompts surface with the prefix ",[326,441,442],{},"\u003Cserver-name>\u002F\u003Cprompt-name>",", so renaming your handler in ",[326,445,446],{},"defineMcpHandler({ name })"," changes how they appear in clients.",[293,449,451],{"id":450},"going-further","Going further",[362,453,454,458,461,464],{},[365,455,457],{"icon":112,"title":109,"color":456,"to":110},"neutral","Auto-generated names, simple prompts, default roles, and prompt structure.",[365,459,460],{"icon":93,"title":114,"color":456,"to":115},"Zod arguments, completable autocomplete, return types, and multi-message conversations.",[365,462,463],{"icon":121,"title":118,"color":456,"to":119},"Real-world examples, groups, type safety, best practices, and conditional registration.",[365,465,467],{"icon":107,"title":466,"color":456,"to":285},"Prompt examples","Code review, documentation, email, and commit-message prompts you can copy.",[293,469,471],{"id":470},"next-steps","Next Steps",[310,473,474,479,484],{},[313,475,476,478],{},[349,477,109],{"href":110}," — write your first prompt.",[313,480,481,483],{},[349,482,41],{"href":47}," — pair prompts with actions the AI can take.",[313,485,486,488],{},[349,487,71],{"href":76}," — feed context alongside your prompts.",{"title":490,"searchDepth":491,"depth":491,"links":492},"",2,[493,494,495,499,500],{"id":295,"depth":491,"text":296},{"id":356,"depth":491,"text":357},{"id":386,"depth":491,"text":382,"children":496},[497],{"id":393,"depth":498,"text":394},3,{"id":450,"depth":491,"text":451},{"id":470,"depth":491,"text":471},"Create reusable prompts for AI assistants with optional arguments.","md",[504,506,507],{"label":109,"icon":112,"to":110,"color":456,"variant":505},"subtle",{"label":114,"icon":93,"to":115,"color":456,"variant":505},{"label":118,"icon":121,"to":119,"color":456,"variant":505},{},{"title":46,"icon":107},{"title":100,"description":511},"Create reusable MCP prompts with optional arguments and full type safety.","K9w4UPtm1mD6BuNsNEoTLuXuaKSsjUoePqiIAItpq3A",[514,516],{"title":95,"path":96,"stem":97,"description":515,"icon":98,"children":-1},"group and tags, on-disk layout, URI schemes, and conditional registration.",{"title":109,"path":110,"stem":111,"description":517,"icon":112,"children":-1},"Names, roles, arguments, and the shape of a prompt definition.",1787670841682]