[{"data":1,"prerenderedAt":719},["ShallowReactive",2],{"page:\u002Fextensions\u002Fkubb-labs\u002Fplugin-mcp\u002Foptions":3},{"id":4,"title":5,"body":6,"description":697,"extension":708,"frontmatter":709,"heading":5,"meta":710,"navigation":711,"order":712,"path":713,"seo":714,"sitemap":715,"source":4,"stem":716,"__hash__":717,"hasPopups":718},"extensions\u002Fextensions\u002Fkubb-labs\u002Fplugin-mcp\u002Foptions.md","Options",{"type":7,"value":8,"toc":696},"minimark",[9,24,29,209,213,216,251,291,293,299,328,360,371,400,413,415,439,468],[10,11,12,13,17,18,23],"p",{},"Pass these options to ",[14,15,16],"code",{},"pluginMcp()",". Shared options link to ",[19,20,22],"a",{"href":21},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options","Shared plugin options",".",[25,26,28],"h2",{"id":27},"options-overview","Options overview",[30,31,32,48],"table",{},[33,34,35],"thead",{},[36,37,38,42,45],"tr",{},[39,40,41],"th",{},"Option",[39,43,44],{},"Purpose",[39,46,47],{},"Default",[49,50,51,86,108,124,139,157,174,192],"tbody",{},[36,52,53,62,81],{},[54,55,56],"td",{},[19,57,59],{"href":58},"#output",[14,60,61],{},"output",[54,63,64,65,68,69,68,72,68,75,68,78,23],{},"Where handlers are written: ",[14,66,67],{},"path",", ",[14,70,71],{},"mode",[14,73,74],{},"barrel",[14,76,77],{},"banner",[14,79,80],{},"footer",[54,82,83],{},[14,84,85],{},"{ path: 'mcp', barrel: { type: 'named' } }",[36,87,88,96,105],{},[54,89,90],{},[19,91,93],{"href":92},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#group",[14,94,95],{},"group",[54,97,98,99,68,102,23],{},"Split output by tag or path: ",[14,100,101],{},"type",[14,103,104],{},"name",[54,106,107],{},"None",[36,109,110,118,121],{},[54,111,112],{},[19,113,115],{"href":114},"#client",[14,116,117],{},"client",[54,119,120],{},"Which registered client plugin the handlers call.",[54,122,123],{},"Auto-detected",[36,125,126,134,137],{},[54,127,128],{},[19,129,131],{"href":130},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#include",[14,132,133],{},"include",[54,135,136],{},"Keep only operations that match.",[54,138,107],{},[36,140,141,149,152],{},[54,142,143],{},[19,144,146],{"href":145},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#exclude",[14,147,148],{},"exclude",[54,150,151],{},"Skip operations that match.",[54,153,154],{},[14,155,156],{},"[]",[36,158,159,167,170],{},[54,160,161],{},[19,162,164],{"href":163},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#override",[14,165,166],{},"override",[54,168,169],{},"Apply different options per pattern.",[54,171,172],{},[14,173,156],{},[36,175,176,184,187],{},[54,177,178],{},[19,179,181],{"href":180},"#resolver",[14,182,183],{},"resolver",[54,185,186],{},"Customize generated names and file paths.",[54,188,189],{},[14,190,191],{},"resolverMcp",[36,193,194,202,205],{},[54,195,196],{},[19,197,199],{"href":198},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#macros",[14,200,201],{},"macros",[54,203,204],{},"Rewrite AST nodes before printing.",[54,206,207],{},[14,208,156],{},[25,210,212],{"id":211},"option-details","Option details",[214,215,61],"h3",{"id":61},[10,217,218,219,68,222,225,226,229,230,233,234,236,237,240,241,244,245,247,248,250],{},"Where the generated MCP handler files are written. The plugin writes ",[14,220,221],{},"server.ts",[14,223,224],{},"start.ts",", and ",[14,227,228],{},".mcp.json"," at the root of ",[14,231,232],{},"output.path",", next to the handlers. Keep ",[14,235,232],{}," a folder name such as the default ",[14,238,239],{},"'mcp'",". Single-file output (",[14,242,243],{},"output.mode: 'file'",", or a ",[14,246,67],{}," with an extension) has no room for those files. With ",[14,249,95],{},", handlers move into subfolders and those files stay at the root.",[30,252,253,261],{},[33,254,255],{},[36,256,257,259],{},[39,258],{},[39,260],{},[49,262,263,273,283],{},[36,264,265,268],{},[54,266,267],{},"Type",[54,269,270],{},[14,271,272],{},"Output",[36,274,275,278],{},[54,276,277],{},"Required",[54,279,280],{},[14,281,282],{},"false",[36,284,285,287],{},[54,286,47],{},[54,288,289],{},[14,290,85],{},[214,292,117],{"id":117},[10,294,295,296,298],{},"Selects which registered client plugin the handlers call. A single registered client is auto-detected. Set ",[14,297,117],{}," when several are registered.",[30,300,301,309],{},[33,302,303],{},[36,304,305,307],{},[39,306],{},[39,308],{},[49,310,311,320],{},[36,312,313,315],{},[54,314,267],{},[54,316,317],{},[14,318,319],{},"'fetch' | 'axios' | 'client'",[36,321,322,324],{},[54,323,277],{},[54,325,326],{},[14,327,282],{},[329,330,331,342,351],"field-group",{},[332,333,335,336,23],"field",{"name":334},"'fetch'","Calls the operations generated by ",[19,337,339],{"href":338},"https:\u002F\u002Fkubb.dev\u002Fextensions\u002Fkubb-labs\u002Fplugin-fetch",[14,340,341],{},"@kubb\u002Fplugin-fetch",[332,343,335,345,23],{"name":344},"'axios'",[19,346,348],{"href":347},"https:\u002F\u002Fkubb.dev\u002Fextensions\u002Fkubb-labs\u002Fplugin-axios",[14,349,350],{},"@kubb\u002Fplugin-axios",[332,352,335,354,23],{"name":353},"'client'",[19,355,357],{"href":356},"https:\u002F\u002Fkubb.dev\u002Fextensions\u002Fkubb-labs\u002Fplugin-client",[14,358,359],{},"@kubb\u002Fplugin-client",[10,361,362,363,366,367,370],{},"Each handler passes grouped ",[14,364,365],{},"{ path, query, headers, body }"," options. Configure transport settings such as ",[14,368,369],{},"baseURL"," on the client plugin.",[10,372,373,374,377,378,381,382,384,385,388,389,392,393,396,397,23],{},"Generated handlers follow the client plugin's ",[14,375,376],{},"returnType"," option. With ",[14,379,380],{},"'full'"," (the client default) or ",[14,383,359],{},"'s plain result, handlers read the success body from ",[14,386,387],{},"res.data",", and with ",[14,390,391],{},"'data'"," they use the resolved call result directly as the tool response body. Handlers always pass ",[14,394,395],{},"throwOnError: true"," so non-2xx responses throw and surface as tool errors, regardless of the client's ",[14,398,399],{},"throwOnErrorDefault",[401,402,404,405,68,407,409,410,412],"blockquote",{"as":403},"note","The handlers call a client plugin's functions, so register ",[14,406,341],{},[14,408,350],{},", or ",[14,411,359],{}," alongside this one.",[214,414,183],{"id":183},[10,416,417,418,420,421,68,423,68,426,429,430,433,434,23],{},"Overrides generated file and symbol names. Omitted members keep ",[14,419,191],{},". The shared members (",[14,422,104],{},[14,424,425],{},"file",[14,427,428],{},"imports",") and the ",[14,431,432],{},"this"," context are described under ",[19,435,437],{"href":436},"https:\u002F\u002Fkubb.dev\u002Fdocs\u002F5.x\u002Freference\u002Fplugin-options#resolver",[14,438,183],{},[30,440,441,449],{},[33,442,443],{},[36,444,445,447],{},[39,446],{},[39,448],{},[49,450,451,460],{},[36,452,453,455],{},[54,454,267],{},[54,456,457],{},[14,458,459],{},"ResolverPatch\u003CResolverMcp>",[36,461,462,464],{},[54,463,277],{},[54,465,466],{},[14,467,282],{},[469,470,475],"pre",{"language":471,"filename":472,"code":473,"class":474},"typescript","Partial override","type ResolverMcpPatch = {\n  name?(name: string): string\n  file?: {\n    baseName?(params: { name: string; extname: string }): string\n    path?(params: { baseName: string; output: Output }): string\n  }\n  imports?(options: ResolveImportsOptions): Array\u003CImportNode>\n  handler?: {\n    name?(node: OperationNode): string  \u002F\u002F → 'showPetByIdHandler'\n  }\n}","shiki shiki-themes github-light github-dark dark:github-dark",[14,476,478,497,498,497,526,497,536,497,576,497,613,497,618,497,651,497,660,497,687,497,691],{"class":477},"language-typescript",[479,480,483,486,490,493],"span",{"class":481,"style":482},"line","display: inline",[479,484,101],{"style":485},"color:#D73A49;--shiki-dark:#F97583",[479,487,489],{"style":488},"color:#6F42C1;--shiki-dark:#B392F0"," ResolverMcpPatch",[479,491,492],{"style":485}," =",[479,494,496],{"style":495},"color:#24292E;--shiki-dark:#E1E4E8"," {","\n",[479,499,500,503,506,509,512,515,519,522,524],{"class":481,"style":482},[479,501,502],{"style":488},"  name",[479,504,505],{"style":485},"?",[479,507,508],{"style":495},"(",[479,510,104],{"style":511},"color:#E36209;--shiki-dark:#FFAB70",[479,513,514],{"style":485},":",[479,516,518],{"style":517},"color:#005CC5;--shiki-dark:#79B8FF"," string",[479,520,521],{"style":495},")",[479,523,514],{"style":485},[479,525,518],{"style":517},[479,527,528,531,534],{"class":481,"style":482},[479,529,530],{"style":511},"  file",[479,532,533],{"style":485},"?:",[479,535,496],{"style":495},[479,537,538,541,543,545,548,550,553,555,557,559,562,565,567,569,572,574],{"class":481,"style":482},[479,539,540],{"style":488},"    baseName",[479,542,505],{"style":485},[479,544,508],{"style":495},[479,546,547],{"style":511},"params",[479,549,514],{"style":485},[479,551,552],{"style":495}," { ",[479,554,104],{"style":511},[479,556,514],{"style":485},[479,558,518],{"style":517},[479,560,561],{"style":495},"; ",[479,563,564],{"style":511},"extname",[479,566,514],{"style":485},[479,568,518],{"style":517},[479,570,571],{"style":495}," })",[479,573,514],{"style":485},[479,575,518],{"style":517},[479,577,578,581,583,585,587,589,591,594,596,598,600,602,604,607,609,611],{"class":481,"style":482},[479,579,580],{"style":488},"    path",[479,582,505],{"style":485},[479,584,508],{"style":495},[479,586,547],{"style":511},[479,588,514],{"style":485},[479,590,552],{"style":495},[479,592,593],{"style":511},"baseName",[479,595,514],{"style":485},[479,597,518],{"style":517},[479,599,561],{"style":495},[479,601,61],{"style":511},[479,603,514],{"style":485},[479,605,606],{"style":488}," Output",[479,608,571],{"style":495},[479,610,514],{"style":485},[479,612,518],{"style":517},[479,614,615],{"class":481,"style":482},[479,616,617],{"style":495},"  }",[479,619,620,623,625,627,630,632,635,637,639,642,645,648],{"class":481,"style":482},[479,621,622],{"style":488},"  imports",[479,624,505],{"style":485},[479,626,508],{"style":495},[479,628,629],{"style":511},"options",[479,631,514],{"style":485},[479,633,634],{"style":488}," ResolveImportsOptions",[479,636,521],{"style":495},[479,638,514],{"style":485},[479,640,641],{"style":488}," Array",[479,643,644],{"style":495},"\u003C",[479,646,647],{"style":488},"ImportNode",[479,649,650],{"style":495},">",[479,652,653,656,658],{"class":481,"style":482},[479,654,655],{"style":511},"  handler",[479,657,533],{"style":485},[479,659,496],{"style":495},[479,661,662,665,667,669,672,674,677,679,681,683],{"class":481,"style":482},[479,663,664],{"style":488},"    name",[479,666,505],{"style":485},[479,668,508],{"style":495},[479,670,671],{"style":511},"node",[479,673,514],{"style":485},[479,675,676],{"style":488}," OperationNode",[479,678,521],{"style":495},[479,680,514],{"style":485},[479,682,518],{"style":517},[479,684,686],{"style":685},"color:#6A737D;--shiki-dark:#6A737D","  \u002F\u002F → 'showPetByIdHandler'",[479,688,689],{"class":481,"style":482},[479,690,617],{"style":495},[479,692,693],{"class":481,"style":482},[479,694,695],{"style":495},"}",{"title":697,"searchDepth":698,"depth":698,"links":699},"",5,[700,702],{"id":27,"depth":701,"text":28},2,{"id":211,"depth":701,"text":212,"children":703},[704,706,707],{"id":61,"depth":705,"text":61},3,{"id":117,"depth":705,"text":117},{"id":183,"depth":705,"text":183},"md",{},{},true,null,"\u002Fextensions\u002Fkubb-labs\u002Fplugin-mcp\u002Foptions",{"title":5},{"loc":713},"extensions\u002Fkubb-labs\u002Fplugin-mcp\u002Foptions","djzGId2NrVGrezAVfNdQxtRyvDyJkVwL-Z9d-L_z7uA",false,1792750770289]