@payloadcms/plugin-mcp 4.0.0-canary.2 → 4.0.0-canary.20261117

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/LICENSE.md +1 -1
  2. package/dist/defaultAccess.d.ts +3 -0
  3. package/dist/defaultAccess.d.ts.map +1 -0
  4. package/dist/defaultAccess.js +3 -0
  5. package/dist/defaultAccess.js.map +1 -0
  6. package/dist/defineTool.d.ts +8 -8
  7. package/dist/defineTool.d.ts.map +1 -1
  8. package/dist/endpoint/access.d.ts +29 -6
  9. package/dist/endpoint/access.d.ts.map +1 -1
  10. package/dist/endpoint/access.js +133 -100
  11. package/dist/endpoint/access.js.map +1 -1
  12. package/dist/endpoint/index.d.ts +1 -1
  13. package/dist/endpoint/index.d.ts.map +1 -1
  14. package/dist/endpoint/index.js +121 -16
  15. package/dist/endpoint/index.js.map +1 -1
  16. package/dist/endpoint/oauth.d.ts +37 -0
  17. package/dist/endpoint/oauth.d.ts.map +1 -0
  18. package/dist/endpoint/oauth.js +105 -0
  19. package/dist/endpoint/oauth.js.map +1 -0
  20. package/dist/endpoint/oauthLoginToken.d.ts +27 -0
  21. package/dist/endpoint/oauthLoginToken.d.ts.map +1 -0
  22. package/dist/endpoint/oauthLoginToken.js +86 -0
  23. package/dist/endpoint/oauthLoginToken.js.map +1 -0
  24. package/dist/endpoint/oauthServer.d.ts +28 -0
  25. package/dist/endpoint/oauthServer.d.ts.map +1 -0
  26. package/dist/endpoint/oauthServer.js +455 -0
  27. package/dist/endpoint/oauthServer.js.map +1 -0
  28. package/dist/exports/client.d.ts +1 -4
  29. package/dist/exports/client.d.ts.map +1 -1
  30. package/dist/exports/client.js +1 -4
  31. package/dist/exports/client.js.map +1 -1
  32. package/dist/exports/internal.d.ts +2 -0
  33. package/dist/exports/internal.d.ts.map +1 -0
  34. package/dist/exports/internal.js +3 -0
  35. package/dist/exports/internal.js.map +1 -0
  36. package/dist/exports/rsc.d.ts +2 -0
  37. package/dist/exports/rsc.d.ts.map +1 -0
  38. package/dist/exports/rsc.js +3 -0
  39. package/dist/exports/rsc.js.map +1 -0
  40. package/dist/index.d.ts +12 -4
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +31 -55
  43. package/dist/index.js.map +1 -1
  44. package/dist/mcp/buildMcpServer.d.ts +6 -6
  45. package/dist/mcp/buildMcpServer.d.ts.map +1 -1
  46. package/dist/mcp/buildMcpServer.js +70 -34
  47. package/dist/mcp/buildMcpServer.js.map +1 -1
  48. package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -1
  49. package/dist/mcp/builtin/collections/authTools.js +123 -61
  50. package/dist/mcp/builtin/collections/authTools.js.map +1 -1
  51. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  52. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  53. package/dist/mcp/builtin/collections/countTool.js +63 -0
  54. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  55. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  56. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  57. package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
  58. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  59. package/dist/mcp/builtin/collections/createTool.d.ts +1 -1
  60. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -1
  61. package/dist/mcp/builtin/collections/createTool.js +109 -66
  62. package/dist/mcp/builtin/collections/createTool.js.map +1 -1
  63. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -1
  64. package/dist/mcp/builtin/collections/deleteTool.js +56 -45
  65. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -1
  66. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  67. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  68. package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
  69. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  70. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  71. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  72. package/dist/mcp/builtin/collections/fileInput.js +88 -0
  73. package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
  74. package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
  75. package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
  76. package/dist/mcp/builtin/collections/findDistinctTool.js +77 -0
  77. package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
  78. package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -1
  79. package/dist/mcp/builtin/collections/findTool.js +58 -56
  80. package/dist/mcp/builtin/collections/findTool.js.map +1 -1
  81. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
  82. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
  83. package/dist/mcp/builtin/collections/findVersionByIDTool.js +74 -0
  84. package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
  85. package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
  86. package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
  87. package/dist/mcp/builtin/collections/findVersionsTool.js +84 -0
  88. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  89. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -1
  90. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +78 -10
  91. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -1
  92. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  93. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  94. package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
  95. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  96. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -1
  97. package/dist/mcp/builtin/collections/updateTool.js +75 -102
  98. package/dist/mcp/builtin/collections/updateTool.js.map +1 -1
  99. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  100. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  101. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  102. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  103. package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
  104. package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
  105. package/dist/mcp/builtin/formatEntityError.js +55 -0
  106. package/dist/mcp/builtin/formatEntityError.js.map +1 -0
  107. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -1
  108. package/dist/mcp/builtin/getConfigInfoTool.js +30 -10
  109. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -1
  110. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  111. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  112. package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
  113. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  114. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -1
  115. package/dist/mcp/builtin/globals/findTool.js +26 -35
  116. package/dist/mcp/builtin/globals/findTool.js.map +1 -1
  117. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  118. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  119. package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
  120. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  121. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  122. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  123. package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
  124. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  125. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -1
  126. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +56 -10
  127. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -1
  128. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  129. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  130. package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
  131. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  132. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -1
  133. package/dist/mcp/builtin/globals/updateTool.js +38 -54
  134. package/dist/mcp/builtin/globals/updateTool.js.map +1 -1
  135. package/dist/mcp/builtinTools.d.ts +75 -12
  136. package/dist/mcp/builtinTools.d.ts.map +1 -1
  137. package/dist/mcp/builtinTools.js +75 -13
  138. package/dist/mcp/builtinTools.js.map +1 -1
  139. package/dist/mcp/sanitizeMCPConfig.d.ts +0 -1
  140. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -1
  141. package/dist/mcp/sanitizeMCPConfig.js +76 -27
  142. package/dist/mcp/sanitizeMCPConfig.js.map +1 -1
  143. package/dist/stdio.d.ts +3 -3
  144. package/dist/stdio.d.ts.map +1 -1
  145. package/dist/stdio.js +86 -47
  146. package/dist/stdio.js.map +1 -1
  147. package/dist/types.d.ts +224 -95
  148. package/dist/types.d.ts.map +1 -1
  149. package/dist/types.js +2 -4
  150. package/dist/types.js.map +1 -1
  151. package/dist/utils/camelCase.d.ts.map +1 -1
  152. package/dist/utils/getPluginConfig.d.ts +1 -1
  153. package/dist/utils/getPluginConfig.js +1 -1
  154. package/dist/utils/getPluginConfig.js.map +1 -1
  155. package/dist/utils/resolveProjectRoot.d.ts.map +1 -1
  156. package/dist/utils/seal.d.ts +17 -0
  157. package/dist/utils/seal.d.ts.map +1 -0
  158. package/dist/utils/seal.js +24 -0
  159. package/dist/utils/seal.js.map +1 -0
  160. package/dist/utils/toStandardSchema.d.ts.map +1 -1
  161. package/dist/utils/toStandardSchema.js.map +1 -1
  162. package/dist/views/Authorize/AllowButtons/index.d.ts +18 -0
  163. package/dist/views/Authorize/AllowButtons/index.d.ts.map +1 -0
  164. package/dist/views/Authorize/AllowButtons/index.js +88 -0
  165. package/dist/views/Authorize/AllowButtons/index.js.map +1 -0
  166. package/dist/views/Authorize/index.css +19 -0
  167. package/dist/views/Authorize/index.d.ts +9 -0
  168. package/dist/views/Authorize/index.d.ts.map +1 -0
  169. package/dist/views/Authorize/index.js +98 -0
  170. package/dist/views/Authorize/index.js.map +1 -0
  171. package/package.json +34 -38
  172. package/src/defaultAccess.ts +3 -0
  173. package/src/endpoint/access.ts +149 -109
  174. package/src/endpoint/index.ts +103 -15
  175. package/src/endpoint/oauth.ts +108 -0
  176. package/src/endpoint/oauthLoginToken.ts +100 -0
  177. package/src/endpoint/oauthServer.ts +472 -0
  178. package/src/exports/client.ts +2 -4
  179. package/src/exports/internal.ts +1 -0
  180. package/src/exports/rsc.ts +1 -0
  181. package/src/index.ts +53 -63
  182. package/src/mcp/buildMcpServer.ts +88 -51
  183. package/src/mcp/builtin/collections/authTools.ts +124 -77
  184. package/src/mcp/builtin/collections/countTool.ts +61 -0
  185. package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
  186. package/src/mcp/builtin/collections/createTool.ts +113 -82
  187. package/src/mcp/builtin/collections/deleteTool.ts +49 -66
  188. package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
  189. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  190. package/src/mcp/builtin/collections/fileInput.ts +127 -0
  191. package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
  192. package/src/mcp/builtin/collections/findTool.ts +54 -97
  193. package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
  194. package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
  195. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +70 -7
  196. package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
  197. package/src/mcp/builtin/collections/updateTool.ts +72 -110
  198. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  199. package/src/mcp/builtin/formatEntityError.ts +77 -0
  200. package/src/mcp/builtin/getConfigInfoTool.ts +29 -5
  201. package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
  202. package/src/mcp/builtin/globals/findTool.ts +27 -57
  203. package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
  204. package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
  205. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +52 -7
  206. package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
  207. package/src/mcp/builtin/globals/updateTool.ts +49 -72
  208. package/src/mcp/builtinTools.ts +81 -18
  209. package/src/mcp/sanitizeMCPConfig.ts +53 -30
  210. package/src/stdio.ts +80 -47
  211. package/src/types.ts +232 -99
  212. package/src/utils/getPluginConfig.ts +1 -1
  213. package/src/utils/seal.ts +46 -0
  214. package/src/utils/toStandardSchema.ts +1 -1
  215. package/src/views/Authorize/AllowButtons/index.tsx +97 -0
  216. package/src/views/Authorize/index.css +19 -0
  217. package/src/views/Authorize/index.tsx +100 -0
  218. package/dist/collection/getAccessField.d.ts +0 -12
  219. package/dist/collection/getAccessField.d.ts.map +0 -1
  220. package/dist/collection/getAccessField.js +0 -72
  221. package/dist/collection/getAccessField.js.map +0 -1
  222. package/dist/collection/index.d.ts +0 -6
  223. package/dist/collection/index.d.ts.map +0 -1
  224. package/dist/collection/index.js +0 -105
  225. package/dist/collection/index.js.map +0 -1
  226. package/dist/components/APIKeyField/index.client.d.ts +0 -9
  227. package/dist/components/APIKeyField/index.client.d.ts.map +0 -1
  228. package/dist/components/APIKeyField/index.client.js +0 -85
  229. package/dist/components/APIKeyField/index.client.js.map +0 -1
  230. package/dist/components/APIKeyField/index.css +0 -105
  231. package/dist/components/APIKeysEmptyState/index.client.d.ts +0 -4
  232. package/dist/components/APIKeysEmptyState/index.client.d.ts.map +0 -1
  233. package/dist/components/APIKeysEmptyState/index.client.js +0 -21
  234. package/dist/components/APIKeysEmptyState/index.client.js.map +0 -1
  235. package/dist/components/AccessField/index.client.d.ts +0 -10
  236. package/dist/components/AccessField/index.client.d.ts.map +0 -1
  237. package/dist/components/AccessField/index.client.js +0 -247
  238. package/dist/components/AccessField/index.client.js.map +0 -1
  239. package/dist/components/AccessField/index.css +0 -99
  240. package/dist/components/SettingsMenu/index.client.d.ts +0 -8
  241. package/dist/components/SettingsMenu/index.client.d.ts.map +0 -1
  242. package/dist/components/SettingsMenu/index.client.js +0 -29
  243. package/dist/components/SettingsMenu/index.client.js.map +0 -1
  244. package/dist/mcp/builtin/collections/formatCollectionError.d.ts +0 -9
  245. package/dist/mcp/builtin/collections/formatCollectionError.d.ts.map +0 -1
  246. package/dist/mcp/builtin/collections/formatCollectionError.js +0 -60
  247. package/dist/mcp/builtin/collections/formatCollectionError.js.map +0 -1
  248. package/dist/mcp/builtin/validateEntityData.d.ts +0 -14
  249. package/dist/mcp/builtin/validateEntityData.d.ts.map +0 -1
  250. package/dist/mcp/builtin/validateEntityData.js +0 -82
  251. package/dist/mcp/builtin/validateEntityData.js.map +0 -1
  252. package/dist/translations/index.d.ts +0 -11
  253. package/dist/translations/index.d.ts.map +0 -1
  254. package/dist/translations/index.js +0 -92
  255. package/dist/translations/index.js.map +0 -1
  256. package/dist/translations/languages/ar.d.ts +0 -31
  257. package/dist/translations/languages/ar.d.ts.map +0 -1
  258. package/dist/translations/languages/ar.js +0 -34
  259. package/dist/translations/languages/ar.js.map +0 -1
  260. package/dist/translations/languages/az.d.ts +0 -31
  261. package/dist/translations/languages/az.d.ts.map +0 -1
  262. package/dist/translations/languages/az.js +0 -34
  263. package/dist/translations/languages/az.js.map +0 -1
  264. package/dist/translations/languages/bg.d.ts +0 -31
  265. package/dist/translations/languages/bg.d.ts.map +0 -1
  266. package/dist/translations/languages/bg.js +0 -34
  267. package/dist/translations/languages/bg.js.map +0 -1
  268. package/dist/translations/languages/bnBd.d.ts +0 -31
  269. package/dist/translations/languages/bnBd.d.ts.map +0 -1
  270. package/dist/translations/languages/bnBd.js +0 -34
  271. package/dist/translations/languages/bnBd.js.map +0 -1
  272. package/dist/translations/languages/bnIn.d.ts +0 -31
  273. package/dist/translations/languages/bnIn.d.ts.map +0 -1
  274. package/dist/translations/languages/bnIn.js +0 -34
  275. package/dist/translations/languages/bnIn.js.map +0 -1
  276. package/dist/translations/languages/ca.d.ts +0 -31
  277. package/dist/translations/languages/ca.d.ts.map +0 -1
  278. package/dist/translations/languages/ca.js +0 -34
  279. package/dist/translations/languages/ca.js.map +0 -1
  280. package/dist/translations/languages/cs.d.ts +0 -31
  281. package/dist/translations/languages/cs.d.ts.map +0 -1
  282. package/dist/translations/languages/cs.js +0 -34
  283. package/dist/translations/languages/cs.js.map +0 -1
  284. package/dist/translations/languages/da.d.ts +0 -31
  285. package/dist/translations/languages/da.d.ts.map +0 -1
  286. package/dist/translations/languages/da.js +0 -34
  287. package/dist/translations/languages/da.js.map +0 -1
  288. package/dist/translations/languages/de.d.ts +0 -31
  289. package/dist/translations/languages/de.d.ts.map +0 -1
  290. package/dist/translations/languages/de.js +0 -34
  291. package/dist/translations/languages/de.js.map +0 -1
  292. package/dist/translations/languages/en.d.ts +0 -31
  293. package/dist/translations/languages/en.d.ts.map +0 -1
  294. package/dist/translations/languages/en.js +0 -34
  295. package/dist/translations/languages/en.js.map +0 -1
  296. package/dist/translations/languages/es.d.ts +0 -31
  297. package/dist/translations/languages/es.d.ts.map +0 -1
  298. package/dist/translations/languages/es.js +0 -34
  299. package/dist/translations/languages/es.js.map +0 -1
  300. package/dist/translations/languages/et.d.ts +0 -31
  301. package/dist/translations/languages/et.d.ts.map +0 -1
  302. package/dist/translations/languages/et.js +0 -34
  303. package/dist/translations/languages/et.js.map +0 -1
  304. package/dist/translations/languages/fa.d.ts +0 -31
  305. package/dist/translations/languages/fa.d.ts.map +0 -1
  306. package/dist/translations/languages/fa.js +0 -34
  307. package/dist/translations/languages/fa.js.map +0 -1
  308. package/dist/translations/languages/fr.d.ts +0 -31
  309. package/dist/translations/languages/fr.d.ts.map +0 -1
  310. package/dist/translations/languages/fr.js +0 -34
  311. package/dist/translations/languages/fr.js.map +0 -1
  312. package/dist/translations/languages/he.d.ts +0 -31
  313. package/dist/translations/languages/he.d.ts.map +0 -1
  314. package/dist/translations/languages/he.js +0 -34
  315. package/dist/translations/languages/he.js.map +0 -1
  316. package/dist/translations/languages/hr.d.ts +0 -31
  317. package/dist/translations/languages/hr.d.ts.map +0 -1
  318. package/dist/translations/languages/hr.js +0 -34
  319. package/dist/translations/languages/hr.js.map +0 -1
  320. package/dist/translations/languages/hu.d.ts +0 -31
  321. package/dist/translations/languages/hu.d.ts.map +0 -1
  322. package/dist/translations/languages/hu.js +0 -34
  323. package/dist/translations/languages/hu.js.map +0 -1
  324. package/dist/translations/languages/hy.d.ts +0 -31
  325. package/dist/translations/languages/hy.d.ts.map +0 -1
  326. package/dist/translations/languages/hy.js +0 -34
  327. package/dist/translations/languages/hy.js.map +0 -1
  328. package/dist/translations/languages/id.d.ts +0 -31
  329. package/dist/translations/languages/id.d.ts.map +0 -1
  330. package/dist/translations/languages/id.js +0 -34
  331. package/dist/translations/languages/id.js.map +0 -1
  332. package/dist/translations/languages/is.d.ts +0 -31
  333. package/dist/translations/languages/is.d.ts.map +0 -1
  334. package/dist/translations/languages/is.js +0 -34
  335. package/dist/translations/languages/is.js.map +0 -1
  336. package/dist/translations/languages/it.d.ts +0 -31
  337. package/dist/translations/languages/it.d.ts.map +0 -1
  338. package/dist/translations/languages/it.js +0 -34
  339. package/dist/translations/languages/it.js.map +0 -1
  340. package/dist/translations/languages/ja.d.ts +0 -31
  341. package/dist/translations/languages/ja.d.ts.map +0 -1
  342. package/dist/translations/languages/ja.js +0 -34
  343. package/dist/translations/languages/ja.js.map +0 -1
  344. package/dist/translations/languages/ko.d.ts +0 -31
  345. package/dist/translations/languages/ko.d.ts.map +0 -1
  346. package/dist/translations/languages/ko.js +0 -34
  347. package/dist/translations/languages/ko.js.map +0 -1
  348. package/dist/translations/languages/lt.d.ts +0 -31
  349. package/dist/translations/languages/lt.d.ts.map +0 -1
  350. package/dist/translations/languages/lt.js +0 -34
  351. package/dist/translations/languages/lt.js.map +0 -1
  352. package/dist/translations/languages/lv.d.ts +0 -31
  353. package/dist/translations/languages/lv.d.ts.map +0 -1
  354. package/dist/translations/languages/lv.js +0 -34
  355. package/dist/translations/languages/lv.js.map +0 -1
  356. package/dist/translations/languages/my.d.ts +0 -31
  357. package/dist/translations/languages/my.d.ts.map +0 -1
  358. package/dist/translations/languages/my.js +0 -34
  359. package/dist/translations/languages/my.js.map +0 -1
  360. package/dist/translations/languages/nb.d.ts +0 -31
  361. package/dist/translations/languages/nb.d.ts.map +0 -1
  362. package/dist/translations/languages/nb.js +0 -34
  363. package/dist/translations/languages/nb.js.map +0 -1
  364. package/dist/translations/languages/nl.d.ts +0 -31
  365. package/dist/translations/languages/nl.d.ts.map +0 -1
  366. package/dist/translations/languages/nl.js +0 -34
  367. package/dist/translations/languages/nl.js.map +0 -1
  368. package/dist/translations/languages/pl.d.ts +0 -31
  369. package/dist/translations/languages/pl.d.ts.map +0 -1
  370. package/dist/translations/languages/pl.js +0 -34
  371. package/dist/translations/languages/pl.js.map +0 -1
  372. package/dist/translations/languages/pt.d.ts +0 -31
  373. package/dist/translations/languages/pt.d.ts.map +0 -1
  374. package/dist/translations/languages/pt.js +0 -34
  375. package/dist/translations/languages/pt.js.map +0 -1
  376. package/dist/translations/languages/ro.d.ts +0 -31
  377. package/dist/translations/languages/ro.d.ts.map +0 -1
  378. package/dist/translations/languages/ro.js +0 -34
  379. package/dist/translations/languages/ro.js.map +0 -1
  380. package/dist/translations/languages/rs.d.ts +0 -31
  381. package/dist/translations/languages/rs.d.ts.map +0 -1
  382. package/dist/translations/languages/rs.js +0 -34
  383. package/dist/translations/languages/rs.js.map +0 -1
  384. package/dist/translations/languages/rsLatin.d.ts +0 -31
  385. package/dist/translations/languages/rsLatin.d.ts.map +0 -1
  386. package/dist/translations/languages/rsLatin.js +0 -34
  387. package/dist/translations/languages/rsLatin.js.map +0 -1
  388. package/dist/translations/languages/ru.d.ts +0 -31
  389. package/dist/translations/languages/ru.d.ts.map +0 -1
  390. package/dist/translations/languages/ru.js +0 -34
  391. package/dist/translations/languages/ru.js.map +0 -1
  392. package/dist/translations/languages/sk.d.ts +0 -31
  393. package/dist/translations/languages/sk.d.ts.map +0 -1
  394. package/dist/translations/languages/sk.js +0 -34
  395. package/dist/translations/languages/sk.js.map +0 -1
  396. package/dist/translations/languages/sl.d.ts +0 -31
  397. package/dist/translations/languages/sl.d.ts.map +0 -1
  398. package/dist/translations/languages/sl.js +0 -34
  399. package/dist/translations/languages/sl.js.map +0 -1
  400. package/dist/translations/languages/sv.d.ts +0 -31
  401. package/dist/translations/languages/sv.d.ts.map +0 -1
  402. package/dist/translations/languages/sv.js +0 -34
  403. package/dist/translations/languages/sv.js.map +0 -1
  404. package/dist/translations/languages/ta.d.ts +0 -31
  405. package/dist/translations/languages/ta.d.ts.map +0 -1
  406. package/dist/translations/languages/ta.js +0 -34
  407. package/dist/translations/languages/ta.js.map +0 -1
  408. package/dist/translations/languages/th.d.ts +0 -31
  409. package/dist/translations/languages/th.d.ts.map +0 -1
  410. package/dist/translations/languages/th.js +0 -34
  411. package/dist/translations/languages/th.js.map +0 -1
  412. package/dist/translations/languages/tr.d.ts +0 -31
  413. package/dist/translations/languages/tr.d.ts.map +0 -1
  414. package/dist/translations/languages/tr.js +0 -34
  415. package/dist/translations/languages/tr.js.map +0 -1
  416. package/dist/translations/languages/uk.d.ts +0 -31
  417. package/dist/translations/languages/uk.d.ts.map +0 -1
  418. package/dist/translations/languages/uk.js +0 -34
  419. package/dist/translations/languages/uk.js.map +0 -1
  420. package/dist/translations/languages/vi.d.ts +0 -31
  421. package/dist/translations/languages/vi.d.ts.map +0 -1
  422. package/dist/translations/languages/vi.js +0 -34
  423. package/dist/translations/languages/vi.js.map +0 -1
  424. package/dist/translations/languages/zh.d.ts +0 -31
  425. package/dist/translations/languages/zh.d.ts.map +0 -1
  426. package/dist/translations/languages/zh.js +0 -34
  427. package/dist/translations/languages/zh.js.map +0 -1
  428. package/dist/translations/languages/zhTw.d.ts +0 -31
  429. package/dist/translations/languages/zhTw.d.ts.map +0 -1
  430. package/dist/translations/languages/zhTw.js +0 -34
  431. package/dist/translations/languages/zhTw.js.map +0 -1
  432. package/dist/translations/types.d.ts +0 -32
  433. package/dist/translations/types.d.ts.map +0 -1
  434. package/dist/translations/types.js +0 -3
  435. package/dist/translations/types.js.map +0 -1
  436. package/dist/utils/getVirtualFieldNames.d.ts +0 -14
  437. package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
  438. package/dist/utils/getVirtualFieldNames.js +0 -35
  439. package/dist/utils/getVirtualFieldNames.js.map +0 -1
  440. package/dist/utils/localAPIDefaults.d.ts +0 -20
  441. package/dist/utils/localAPIDefaults.d.ts.map +0 -1
  442. package/dist/utils/localAPIDefaults.js +0 -19
  443. package/dist/utils/localAPIDefaults.js.map +0 -1
  444. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts +0 -11
  445. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts.map +0 -1
  446. package/dist/utils/schemaConversion/getEntityInputSchema.js +0 -34
  447. package/dist/utils/schemaConversion/getEntityInputSchema.js.map +0 -1
  448. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
  449. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
  450. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
  451. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
  452. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts +0 -15
  453. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts.map +0 -1
  454. package/dist/utils/schemaConversion/sanitizeEntitySchema.js +0 -464
  455. package/dist/utils/schemaConversion/sanitizeEntitySchema.js.map +0 -1
  456. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js +0 -158
  457. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js.map +0 -1
  458. package/dist/utils/transformPointDataToPayload.d.ts +0 -7
  459. package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
  460. package/dist/utils/transformPointDataToPayload.js +0 -28
  461. package/dist/utils/transformPointDataToPayload.js.map +0 -1
  462. package/dist/utils/whereSchema.d.ts +0 -9
  463. package/dist/utils/whereSchema.d.ts.map +0 -1
  464. package/dist/utils/whereSchema.js +0 -13
  465. package/dist/utils/whereSchema.js.map +0 -1
  466. package/src/collection/getAccessField.ts +0 -84
  467. package/src/collection/index.ts +0 -105
  468. package/src/components/APIKeyField/index.client.tsx +0 -73
  469. package/src/components/APIKeyField/index.css +0 -105
  470. package/src/components/APIKeysEmptyState/index.client.tsx +0 -36
  471. package/src/components/AccessField/index.client.tsx +0 -299
  472. package/src/components/AccessField/index.css +0 -99
  473. package/src/components/SettingsMenu/index.client.tsx +0 -34
  474. package/src/mcp/builtin/collections/formatCollectionError.ts +0 -84
  475. package/src/mcp/builtin/validateEntityData.ts +0 -132
  476. package/src/translations/index.ts +0 -108
  477. package/src/translations/languages/ar.ts +0 -35
  478. package/src/translations/languages/az.ts +0 -35
  479. package/src/translations/languages/bg.ts +0 -35
  480. package/src/translations/languages/bnBd.ts +0 -35
  481. package/src/translations/languages/bnIn.ts +0 -35
  482. package/src/translations/languages/ca.ts +0 -35
  483. package/src/translations/languages/cs.ts +0 -35
  484. package/src/translations/languages/da.ts +0 -35
  485. package/src/translations/languages/de.ts +0 -35
  486. package/src/translations/languages/en.ts +0 -35
  487. package/src/translations/languages/es.ts +0 -35
  488. package/src/translations/languages/et.ts +0 -35
  489. package/src/translations/languages/fa.ts +0 -35
  490. package/src/translations/languages/fr.ts +0 -35
  491. package/src/translations/languages/he.ts +0 -35
  492. package/src/translations/languages/hr.ts +0 -35
  493. package/src/translations/languages/hu.ts +0 -35
  494. package/src/translations/languages/hy.ts +0 -35
  495. package/src/translations/languages/id.ts +0 -35
  496. package/src/translations/languages/is.ts +0 -35
  497. package/src/translations/languages/it.ts +0 -35
  498. package/src/translations/languages/ja.ts +0 -35
  499. package/src/translations/languages/ko.ts +0 -35
  500. package/src/translations/languages/lt.ts +0 -35
  501. package/src/translations/languages/lv.ts +0 -35
  502. package/src/translations/languages/my.ts +0 -35
  503. package/src/translations/languages/nb.ts +0 -35
  504. package/src/translations/languages/nl.ts +0 -35
  505. package/src/translations/languages/pl.ts +0 -35
  506. package/src/translations/languages/pt.ts +0 -35
  507. package/src/translations/languages/ro.ts +0 -35
  508. package/src/translations/languages/rs.ts +0 -35
  509. package/src/translations/languages/rsLatin.ts +0 -35
  510. package/src/translations/languages/ru.ts +0 -35
  511. package/src/translations/languages/sk.ts +0 -35
  512. package/src/translations/languages/sl.ts +0 -35
  513. package/src/translations/languages/sv.ts +0 -35
  514. package/src/translations/languages/ta.ts +0 -35
  515. package/src/translations/languages/th.ts +0 -35
  516. package/src/translations/languages/tr.ts +0 -35
  517. package/src/translations/languages/uk.ts +0 -35
  518. package/src/translations/languages/vi.ts +0 -35
  519. package/src/translations/languages/zh.ts +0 -35
  520. package/src/translations/languages/zhTw.ts +0 -35
  521. package/src/translations/types.ts +0 -34
  522. package/src/utils/getVirtualFieldNames.ts +0 -53
  523. package/src/utils/localAPIDefaults.ts +0 -22
  524. package/src/utils/schemaConversion/getEntityInputSchema.ts +0 -78
  525. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
  526. package/src/utils/schemaConversion/sanitizeEntitySchema.spec.ts +0 -103
  527. package/src/utils/schemaConversion/sanitizeEntitySchema.ts +0 -529
  528. package/src/utils/transformPointDataToPayload.ts +0 -40
  529. package/src/utils/whereSchema.ts +0 -24
@@ -8,19 +8,45 @@ import {
8
8
  unlockCollectionTool,
9
9
  verifyCollectionTool,
10
10
  } from './builtin/collections/authTools.js'
11
- import { createDocumentTool } from './builtin/collections/createTool.js'
11
+ import { countDocumentsTool } from './builtin/collections/countTool.js'
12
+ import { countVersionsTool } from './builtin/collections/countVersionsTool.js'
13
+ import { createDocumentsTool } from './builtin/collections/createTool.js'
12
14
  import { deleteDocumentsTool } from './builtin/collections/deleteTool.js'
15
+ import { duplicateDocumentTool } from './builtin/collections/duplicateTool.js'
16
+ import { findDistinctTool } from './builtin/collections/findDistinctTool.js'
13
17
  import { findDocumentsTool } from './builtin/collections/findTool.js'
18
+ import { findVersionByIDTool } from './builtin/collections/findVersionByIDTool.js'
19
+ import { findVersionsTool } from './builtin/collections/findVersionsTool.js'
14
20
  import { getCollectionSchemaTool } from './builtin/collections/getCollectionSchemaTool.js'
21
+ import { restoreVersionTool } from './builtin/collections/restoreVersionTool.js'
15
22
  import { updateDocumentTool } from './builtin/collections/updateTool.js'
23
+ import { getUploadInstructionsTool } from './builtin/collections/uploadInstructionsTool.js'
16
24
  import { getConfigInfoTool } from './builtin/getConfigInfoTool.js'
25
+ import { countGlobalVersionsTool } from './builtin/globals/countVersionsTool.js'
17
26
  import { findGlobalTool } from './builtin/globals/findTool.js'
27
+ import { findGlobalVersionByIDTool } from './builtin/globals/findVersionByIDTool.js'
28
+ import { findGlobalVersionsTool } from './builtin/globals/findVersionsTool.js'
18
29
  import { getGlobalSchemaTool } from './builtin/globals/getGlobalSchemaTool.js'
30
+ import { restoreGlobalVersionTool } from './builtin/globals/restoreVersionTool.js'
19
31
  import { updateGlobalTool } from './builtin/globals/updateTool.js'
20
32
 
33
+ type CollectionBuiltin = {
34
+ mcpName: string
35
+ requiresDuplicateEnabled?: boolean
36
+ requiresUpload?: boolean
37
+ requiresVersions?: boolean
38
+ tool: CollectionTool
39
+ }
40
+
41
+ type GlobalBuiltin = {
42
+ mcpName: string
43
+ requiresVersions?: boolean
44
+ tool: GlobalTool
45
+ }
46
+
21
47
  export const TOOL_BUILTINS = {
22
- getConfigInfo: { label: 'Config Info', mcpName: 'getConfigInfo', tool: getConfigInfoTool },
23
- } satisfies Record<string, { label: string; mcpName: string; tool: Tool }>
48
+ getConfigInfo: { mcpName: 'getConfigInfo', tool: getConfigInfoTool },
49
+ } satisfies Record<string, { mcpName: string; tool: Tool }>
24
50
 
25
51
  /**
26
52
  * The static built-in collection CRUD tools. Keys here are the source of truth
@@ -28,44 +54,81 @@ export const TOOL_BUILTINS = {
28
54
  * automatically.
29
55
  */
30
56
  export const COLLECTION_BUILTINS = {
31
- create: { mcpName: 'createDocument', tool: createDocumentTool },
57
+ count: { mcpName: 'countDocuments', tool: countDocumentsTool },
58
+ countVersions: { mcpName: 'countVersions', requiresVersions: true, tool: countVersionsTool },
59
+ create: { mcpName: 'createDocuments', tool: createDocumentsTool },
32
60
  delete: { mcpName: 'deleteDocuments', tool: deleteDocumentsTool },
61
+ duplicate: {
62
+ mcpName: 'duplicateDocument',
63
+ requiresDuplicateEnabled: true,
64
+ tool: duplicateDocumentTool,
65
+ },
33
66
  find: { mcpName: 'findDocuments', tool: findDocumentsTool },
67
+ findDistinct: { mcpName: 'findDistinct', tool: findDistinctTool },
68
+ findVersionByID: {
69
+ mcpName: 'findVersionByID',
70
+ requiresVersions: true,
71
+ tool: findVersionByIDTool,
72
+ },
73
+ findVersions: { mcpName: 'findVersions', requiresVersions: true, tool: findVersionsTool },
34
74
  getCollectionSchema: { mcpName: 'getCollectionSchema', tool: getCollectionSchemaTool },
75
+ getUploadInstructions: {
76
+ mcpName: 'getUploadInstructions',
77
+ requiresUpload: true,
78
+ tool: getUploadInstructionsTool,
79
+ },
80
+ restoreVersion: { mcpName: 'restoreVersion', requiresVersions: true, tool: restoreVersionTool },
35
81
  update: { mcpName: 'updateDocument', tool: updateDocumentTool },
36
- } satisfies Record<string, { mcpName: string; tool: CollectionTool }>
82
+ } satisfies Record<string, CollectionBuiltin>
37
83
 
38
84
  /**
39
- * The static auth tools surfaced under auth-enabled collections. Each entry
40
- * carries the admin-UI label alongside the tool. Keys are the source of truth
41
- * for `MCPCollectionAuthToolName`.
85
+ * The static auth tools surfaced under auth-enabled collections. Keys are the
86
+ * source of truth for `MCPCollectionAuthToolName`.
42
87
  */
43
88
  export const COLLECTION_AUTH_BUILTINS = {
44
- auth: { label: 'Check Auth Status', mcpName: 'auth', tool: authCollectionTool },
89
+ auth: { mcpName: 'auth', tool: authCollectionTool },
45
90
  forgotPassword: {
46
- label: 'Forgot Password',
47
91
  mcpName: 'forgotPassword',
48
92
  tool: forgotPasswordCollectionTool,
49
93
  },
50
- login: { label: 'User Login', mcpName: 'login', tool: loginCollectionTool },
94
+ login: { mcpName: 'login', tool: loginCollectionTool },
51
95
  resetPassword: {
52
- label: 'Reset Password',
53
96
  mcpName: 'resetPassword',
54
97
  tool: resetPasswordCollectionTool,
55
98
  },
56
- unlock: { label: 'Unlock Account', mcpName: 'unlock', tool: unlockCollectionTool },
57
- verify: { label: 'Email Verification', mcpName: 'verify', tool: verifyCollectionTool },
58
- } satisfies Record<string, { label: string; mcpName: string; tool: CollectionTool }>
99
+ unlock: { mcpName: 'unlock', tool: unlockCollectionTool },
100
+ verify: { mcpName: 'verify', tool: verifyCollectionTool },
101
+ } satisfies Record<string, { mcpName: string; tool: CollectionTool }>
59
102
 
60
103
  /**
61
104
  * The static built-in global tools. Keys are the source of truth for
62
105
  * `MCPGlobalBuiltinName`.
63
106
  */
64
107
  export const GLOBAL_BUILTINS = {
108
+ countGlobalVersions: {
109
+ mcpName: 'countGlobalVersions',
110
+ requiresVersions: true,
111
+ tool: countGlobalVersionsTool,
112
+ },
65
113
  find: { mcpName: 'findGlobal', tool: findGlobalTool },
114
+ findGlobalVersionByID: {
115
+ mcpName: 'findGlobalVersionByID',
116
+ requiresVersions: true,
117
+ tool: findGlobalVersionByIDTool,
118
+ },
119
+ findGlobalVersions: {
120
+ mcpName: 'findGlobalVersions',
121
+ requiresVersions: true,
122
+ tool: findGlobalVersionsTool,
123
+ },
66
124
  getGlobalSchema: { mcpName: 'getGlobalSchema', tool: getGlobalSchemaTool },
125
+ restoreGlobalVersion: {
126
+ mcpName: 'restoreGlobalVersion',
127
+ requiresVersions: true,
128
+ tool: restoreGlobalVersionTool,
129
+ },
67
130
  update: { mcpName: 'updateGlobal', tool: updateGlobalTool },
68
- } satisfies Record<string, { mcpName: string; tool: GlobalTool }>
131
+ } satisfies Record<string, GlobalBuiltin>
69
132
 
70
133
  export type MCPCollectionBuiltinName = keyof typeof COLLECTION_BUILTINS
71
134
 
@@ -86,7 +149,7 @@ export const TOOL_BUILTIN_ENTRIES = Object.entries(TOOL_BUILTINS) as Array<
86
149
  >
87
150
 
88
151
  export const COLLECTION_BUILTIN_ENTRIES = Object.entries(COLLECTION_BUILTINS) as Array<
89
- [MCPCollectionBuiltinName, (typeof COLLECTION_BUILTINS)[MCPCollectionBuiltinName]]
152
+ [MCPCollectionBuiltinName, CollectionBuiltin]
90
153
  >
91
154
 
92
155
  export const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BUILTINS) as Array<
@@ -94,5 +157,5 @@ export const COLLECTION_AUTH_BUILTIN_ENTRIES = Object.entries(COLLECTION_AUTH_BU
94
157
  >
95
158
 
96
159
  export const GLOBAL_BUILTIN_ENTRIES = Object.entries(GLOBAL_BUILTINS) as Array<
97
- [MCPGlobalBuiltinName, (typeof GLOBAL_BUILTINS)[MCPGlobalBuiltinName]]
160
+ [MCPGlobalBuiltinName, GlobalBuiltin]
98
161
  >
@@ -17,6 +17,7 @@ import type {
17
17
  SanitizedMCPPluginConfig,
18
18
  } from '../types.js'
19
19
 
20
+ import { defaultAccess } from '../defaultAccess.js'
20
21
  import {
21
22
  COLLECTION_AUTH_BUILTIN_ENTRIES,
22
23
  COLLECTION_AUTH_BUILTINS,
@@ -33,7 +34,6 @@ import {
33
34
  * - Flattens `tools` / `prompts` / `resources` / per-collection / per-global
34
35
  * tool maps into a single `items` array.
35
36
  * - Applies built-in tools for collections and globals, respecting opt-out user overrides.
36
- * - Applies the `userCollection` default
37
37
  *
38
38
  * Called once during plugin init. After that, `plugins['@payloadcms/plugin-mcp']
39
39
  * ?.options` holds the sanitized result
@@ -55,13 +55,13 @@ export const sanitizeMCPConfig = ({
55
55
  items.push(...sanitizeGlobalConfig({ global, pluginConfig }))
56
56
  }
57
57
 
58
- for (const [configKey, { label, mcpName, tool }] of TOOL_BUILTIN_ENTRIES) {
58
+ for (const [configKey, { mcpName, tool }] of TOOL_BUILTIN_ENTRIES) {
59
59
  items.push({
60
60
  type: 'tool',
61
61
  configKey,
62
- label,
62
+ label: tool.annotations?.title ?? configKey,
63
63
  mcpName,
64
- tool,
64
+ tool: { ...tool, access: tool.access ?? defaultAccess },
65
65
  })
66
66
  }
67
67
 
@@ -72,9 +72,9 @@ export const sanitizeMCPConfig = ({
72
72
  items.push({
73
73
  type: 'tool',
74
74
  configKey,
75
- label: configKey,
75
+ label: tool.annotations?.title ?? configKey,
76
76
  mcpName: configKey,
77
- tool,
77
+ tool: { ...tool, access: tool.access ?? defaultAccess },
78
78
  })
79
79
  }
80
80
 
@@ -84,7 +84,7 @@ export const sanitizeMCPConfig = ({
84
84
  configKey,
85
85
  label: prompt.title ?? configKey,
86
86
  mcpName: configKey,
87
- prompt,
87
+ prompt: { ...prompt, access: prompt.access ?? defaultAccess },
88
88
  })
89
89
  }
90
90
 
@@ -94,21 +94,18 @@ export const sanitizeMCPConfig = ({
94
94
  configKey,
95
95
  label: resource.title ?? configKey,
96
96
  mcpName: configKey,
97
- resource,
97
+ resource: { ...resource, access: resource.access ?? defaultAccess },
98
98
  })
99
99
  }
100
100
 
101
- // Mirror Payload's own admin.user detection (sanitize.ts) since plugins run first.
102
- const firstCollectionWithAuth = config.collections!.find(({ auth }) => Boolean(auth))
103
-
104
101
  return {
102
+ access: pluginConfig.access,
105
103
  disabled: pluginConfig.disabled,
104
+ hooks: pluginConfig.hooks,
106
105
  items,
107
106
  mcp: pluginConfig.mcp,
108
- overrideApiKeyCollection: pluginConfig.overrideApiKeyCollection,
109
- overrideAuth: pluginConfig.overrideAuth,
110
- userCollection:
111
- pluginConfig.userCollection ?? config.admin?.user ?? firstCollectionWithAuth?.slug ?? 'users',
107
+ oauth: pluginConfig.oauth === false ? undefined : (pluginConfig.oauth ?? { type: 'builtin' }),
108
+ overrideGetAuthorizedMCP: pluginConfig.overrideGetAuthorizedMCP,
112
109
  }
113
110
  }
114
111
 
@@ -119,27 +116,46 @@ const sanitizeCollectionConfig = ({
119
116
  collection: CollectionConfig | SanitizedCollectionConfig
120
117
  pluginConfig: MCPPluginConfig
121
118
  }): CollectionMCPItem[] => {
122
- if (collection.slug === 'payload-mcp-api-keys') {
123
- return []
124
- }
125
119
  const slug = collection.slug
126
120
  const collectionPluginConfig = pluginConfig.collections?.[slug]
127
121
  const items: CollectionMCPItem[] = []
122
+ /**
123
+ * Payload disables duplicate for auth collections by default unless the
124
+ * collection explicitly opts back in with `disableDuplicate: false`.
125
+ */
126
+ const isDuplicateDisabled =
127
+ collection.disableDuplicate === true ||
128
+ (Boolean(collection.auth) && collection.disableDuplicate !== false)
128
129
 
129
- for (const [toolKey, { mcpName, tool }] of COLLECTION_BUILTIN_ENTRIES) {
130
+ for (const [
131
+ toolKey,
132
+ { mcpName, requiresDuplicateEnabled, requiresUpload, requiresVersions, tool },
133
+ ] of COLLECTION_BUILTIN_ENTRIES) {
134
+ if (requiresVersions && !collection.versions) {
135
+ continue
136
+ }
137
+ if (requiresDuplicateEnabled && isDuplicateDisabled) {
138
+ continue
139
+ }
140
+ if (requiresUpload && !collection.upload) {
141
+ continue
142
+ }
130
143
  const matchedConfigEntry = collectionPluginConfig?.tools?.[toolKey]
131
144
  if (matchedConfigEntry === false) {
132
145
  continue
133
146
  }
134
147
  const override = typeof matchedConfigEntry === 'object' ? matchedConfigEntry : undefined
148
+ const annotations = { ...tool.annotations, ...override?.annotations }
135
149
  items.push({
136
150
  type: 'collectionTool',
137
151
  collectionSlug: slug,
138
152
  configKey: toolKey,
139
- label: capitalize(toolKey),
153
+ label: annotations.title ?? toolKey,
140
154
  mcpName,
141
155
  tool: {
142
156
  ...tool,
157
+ access: override?.access ?? tool.access ?? defaultAccess,
158
+ annotations,
143
159
  description: override?.description ?? tool.description,
144
160
  overrideResponse:
145
161
  override?.overrideResponse ??
@@ -150,21 +166,24 @@ const sanitizeCollectionConfig = ({
150
166
  }
151
167
 
152
168
  if (collection.auth) {
153
- for (const [authToolKey, { label, mcpName, tool }] of COLLECTION_AUTH_BUILTIN_ENTRIES) {
169
+ for (const [authToolKey, { mcpName, tool }] of COLLECTION_AUTH_BUILTIN_ENTRIES) {
154
170
  const matchedConfigEntry = collectionPluginConfig?.tools?.[authToolKey]
155
171
  if (!matchedConfigEntry) {
156
172
  continue
157
173
  }
158
174
  // `true` means "enable, no override"; only the object form carries fields.
159
175
  const override = typeof matchedConfigEntry === 'object' ? matchedConfigEntry : undefined
176
+ const annotations = { ...tool.annotations, ...override?.annotations }
160
177
  items.push({
161
178
  type: 'collectionTool',
162
179
  collectionSlug: slug,
163
180
  configKey: authToolKey,
164
- label,
181
+ label: annotations.title ?? authToolKey,
165
182
  mcpName,
166
183
  tool: {
167
184
  ...tool,
185
+ access: override?.access ?? tool.access ?? defaultAccess,
186
+ annotations,
168
187
  description: override?.description ?? tool.description,
169
188
  overrideResponse:
170
189
  override?.overrideResponse ??
@@ -191,9 +210,9 @@ const sanitizeCollectionConfig = ({
191
210
  type: 'collectionTool',
192
211
  collectionSlug: slug,
193
212
  configKey,
194
- label: configKey,
213
+ label: customTool.annotations?.title ?? configKey,
195
214
  mcpName: configKey,
196
- tool: customTool,
215
+ tool: { ...customTool, access: customTool.access ?? defaultAccess },
197
216
  })
198
217
  }
199
218
 
@@ -211,20 +230,26 @@ const sanitizeGlobalConfig = ({
211
230
  const globalPluginConfig = pluginConfig.globals?.[slug]
212
231
  const items: GlobalMCPItem[] = []
213
232
 
214
- for (const [toolKey, { mcpName, tool }] of GLOBAL_BUILTIN_ENTRIES) {
233
+ for (const [toolKey, { mcpName, requiresVersions, tool }] of GLOBAL_BUILTIN_ENTRIES) {
234
+ if (requiresVersions && !global.versions) {
235
+ continue
236
+ }
215
237
  const matchedConfigEntry = globalPluginConfig?.tools?.[toolKey]
216
238
  if (matchedConfigEntry === false) {
217
239
  continue
218
240
  }
219
241
  const override = typeof matchedConfigEntry === 'object' ? matchedConfigEntry : undefined
242
+ const annotations = { ...tool.annotations, ...override?.annotations }
220
243
  items.push({
221
244
  type: 'globalTool',
222
245
  configKey: toolKey,
223
246
  globalSlug: slug,
224
- label: capitalize(toolKey),
247
+ label: annotations.title ?? toolKey,
225
248
  mcpName,
226
249
  tool: {
227
250
  ...tool,
251
+ access: override?.access ?? tool.access ?? defaultAccess,
252
+ annotations,
228
253
  description: override?.description ?? tool.description,
229
254
  overrideResponse:
230
255
  override?.overrideResponse ??
@@ -248,13 +273,11 @@ const sanitizeGlobalConfig = ({
248
273
  type: 'globalTool',
249
274
  configKey,
250
275
  globalSlug: slug,
251
- label: configKey,
276
+ label: customTool.annotations?.title ?? configKey,
252
277
  mcpName: configKey,
253
- tool: customTool,
278
+ tool: { ...customTool, access: customTool.access ?? defaultAccess },
254
279
  })
255
280
  }
256
281
 
257
282
  return items
258
283
  }
259
-
260
- const capitalize = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1)
package/src/stdio.ts CHANGED
@@ -1,98 +1,131 @@
1
- import type { MaybePromise, Plugin, SanitizedConfig } from 'payload'
1
+ import type { Config, Plugin, SanitizedConfig } from 'payload'
2
2
 
3
3
  /* eslint-disable no-console */
4
- import { StdioServerTransport } from '@modelcontextprotocol/server'
4
+ import { serveStdio } from '@modelcontextprotocol/server/stdio'
5
5
  import { fileURLToPath, pathToFileURL } from 'node:url'
6
- import { createLocalReq, getPayload } from 'payload'
7
- import { findConfig } from 'payload/node'
6
+ import { createPayloadRequest, getPayload } from 'payload'
7
+ import { findConfig, loadEnv } from 'payload/node'
8
8
 
9
- import type { AuthorizedMCP, SanitizedMCPPluginConfig } from './types.js'
9
+ import type { SanitizedMCPPluginConfig } from './types.js'
10
10
 
11
+ import { getAuthorizedMCP } from './endpoint/access.js'
11
12
  import { buildMcpServer } from './mcp/buildMcpServer.js'
12
13
  import { sanitizeMCPConfig } from './mcp/sanitizeMCPConfig.js'
13
14
  import { getPluginConfig } from './utils/getPluginConfig.js'
14
15
  import { resolveProjectRoot } from './utils/resolveProjectRoot.js'
15
16
 
16
17
  /**
17
- * Stdio adapter for the Payload MCP server.
18
+ * Starts Payload's MCP server over stdin and stdout.
18
19
  *
19
- * Do not use in production. There's no auth; whoever can spawn the process gets
20
- * full access to your local data.
20
+ * Set `PAYLOAD_MCP_AUTHORIZATION` to authenticate. In development,
21
+ * `PAYLOAD_MCP_OVERRIDE_ACCESS=true` skips access checks.
21
22
  */
22
23
  export const runMcpStdio = async (): Promise<void> => {
23
- /**
24
- * If MCP clients spawn stdio servers from an arbitrary working directory,
25
- * Payload's cwd-anchored `findConfig()` can't locate the project on
26
- * its own. This module always lives inside the project's `node_modules`, so
27
- * we derive the project root from its own path and `chdir` into it.
28
- *
29
- * An absolute `PAYLOAD_CONFIG_PATH` still overrides everything; unusual
30
- * layouts (e.g. a monorepo where the package is hoisted above the app) can
31
- * fall back to it. See the implementation of findConfig for details.
32
- */
24
+ // MCP clients may start this command from another folder. Move to the Payload
25
+ // project so findConfig() can find the config.
33
26
  const projectRoot = resolveProjectRoot(fileURLToPath(import.meta.url))
34
27
  if (projectRoot) {
35
28
  process.chdir(projectRoot)
36
29
  }
37
30
 
31
+ loadEnv()
38
32
  const configPath = findConfig()
39
33
  const configModule = await import(pathToFileURL(configPath).toString())
40
- const config = (await (configModule.default ?? configModule)) as MaybePromise<SanitizedConfig>
41
-
42
- const payload = await getPayload({ config })
34
+ const config = (await (configModule.default ?? configModule)) as SanitizedConfig
43
35
 
44
36
  /**
45
- * If the user added `mcpPlugin({...})` to their `plugins` array, read the
46
- * sanitized config they registered. Otherwise fall back to the defaults. That way,
47
- * the mcp works on any project that has `@payloadcms/plugin-mcp` installed,
48
- * even if the plugin is not added to the plugins array.
37
+ * stdout is only for MCP messages. The spec says the server must not write
38
+ * logs there and may write them to stderr instead.
39
+ *
40
+ * The 2.0 client library recovers from stray stdout logs, but that behavior is not
41
+ * guaranteed. Move Payload logs to stderr so Payload does not add invalid data
42
+ * to stdout. Keep options from configurable loggers. Replace pre-built loggers
43
+ * because their output cannot be redirected.
44
+ *
45
+ * @see https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#stdio
49
46
  */
47
+ const loggerConfig: { logger?: Config['logger'] } = config
48
+ if (
49
+ loggerConfig.logger &&
50
+ typeof loggerConfig.logger === 'object' &&
51
+ 'options' in loggerConfig.logger
52
+ ) {
53
+ loggerConfig.logger.destination = process.stderr
54
+ } else {
55
+ loggerConfig.logger = { destination: process.stderr, options: {} }
56
+ }
57
+
58
+ const payload = await getPayload({ config, cron: false, disableOnInit: true })
59
+
50
60
  let pluginConfig: SanitizedMCPPluginConfig
51
61
  try {
52
62
  pluginConfig = getPluginConfig({ config: payload.config })
53
63
  } catch {
64
+ // The command also works when mcpPlugin() is not in the Payload config.
54
65
  pluginConfig = sanitizeMCPConfig({ config: payload.config, pluginConfig: {} })
55
66
 
56
- const fakePluginFn: Plugin = (config) => config
57
- fakePluginFn.slug = '@payloadcms/plugin-mcp'
58
- // @ts-expect-error
59
- fakePluginFn.sanitizedOptions = pluginConfig
67
+ const fallbackPlugin: Plugin = (config) => config
68
+ Object.assign(fallbackPlugin, {
69
+ slug: '@payloadcms/plugin-mcp',
70
+ sanitizedOptions: pluginConfig,
71
+ })
72
+ payload.config.plugins ??= []
73
+ payload.config.plugins.push(fallbackPlugin)
74
+ }
75
+
76
+ const overrideAccessEnv = process.env.PAYLOAD_MCP_OVERRIDE_ACCESS
77
+ let overrideAccess = false
78
+
79
+ if (overrideAccessEnv === 'true') {
80
+ overrideAccess = true
81
+ } else if (overrideAccessEnv && overrideAccessEnv !== 'false') {
82
+ throw new Error('PAYLOAD_MCP_OVERRIDE_ACCESS must be "true" or "false".')
83
+ }
60
84
 
61
- // Push to payload config, to ensure consecutive calls to `getPluginConfig()` work
62
- ;(payload.config.plugins ??= []).push(fakePluginFn)
85
+ if (overrideAccess && process.env.NODE_ENV !== 'development') {
86
+ throw new Error('PAYLOAD_MCP_OVERRIDE_ACCESS is only available in development.')
63
87
  }
64
88
 
65
- const authorizedMCP: AuthorizedMCP = {
66
- items: pluginConfig.items,
67
- overrideAccess: true,
68
- user: null,
89
+ const headers = new Headers()
90
+ if (process.env.PAYLOAD_MCP_AUTHORIZATION) {
91
+ headers.set('Authorization', process.env.PAYLOAD_MCP_AUTHORIZATION)
69
92
  }
70
93
 
71
- const req = await createLocalReq({}, payload)
94
+ const req = await createPayloadRequest({ payload, req: { headers } })
72
95
  req.payloadAPI = 'MCP' as const
96
+ const authorizedMCP = await getAuthorizedMCP({ overrideAccess, req })
73
97
 
74
- const server = buildMcpServer({ authorizedMCP, pluginConfig, req })
98
+ const stdioServer = serveStdio(() => buildMcpServer({ authorizedMCP, pluginConfig, req }), {
99
+ onerror: (err) => {
100
+ // MCP messages use stdout, so write SDK errors to stderr.
101
+ console.error('[payload-mcp] error serving MCP over stdio:', err)
102
+ },
103
+ })
75
104
 
76
- const transport = new StdioServerTransport()
77
- await server.connect(transport)
105
+ // Close the MCP server and Payload when the client disconnects or the process stops.
106
+ let isShuttingDown = false
107
+ const shutdown = async () => {
108
+ if (isShuttingDown) {
109
+ return
110
+ }
111
+ isShuttingDown = true
78
112
 
79
- // Process now lives until stdin closes. Wire graceful shutdown so DB
80
- // connections (and any other Payload-managed resources) get released.
81
- const shutdown = async (code = 0) => {
82
113
  try {
83
- await server.close()
114
+ await stdioServer.close()
84
115
  } catch (err) {
85
116
  console.error('[payload-mcp] error closing server:', err)
86
117
  }
118
+
87
119
  try {
88
120
  await payload.destroy()
89
121
  } catch (err) {
90
122
  console.error('[payload-mcp] error destroying payload:', err)
91
123
  }
92
- process.exit(code)
124
+
125
+ process.exit(0)
93
126
  }
94
127
 
95
- process.on('SIGINT', () => void shutdown(0))
96
- process.on('SIGTERM', () => void shutdown(0))
97
- process.stdin.on('close', () => void shutdown(0))
128
+ process.once('SIGINT', () => void shutdown())
129
+ process.once('SIGTERM', () => void shutdown())
130
+ process.stdin.once('close', () => void shutdown())
98
131
  }