@payloadcms/plugin-mcp 4.0.0-internal.011fd46 → 4.0.0-internal.0b9bec1

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 (472) hide show
  1. package/LICENSE.md +1 -1
  2. package/bin.js +7 -0
  3. package/dist/defaultAccess.d.ts +3 -0
  4. package/dist/defaultAccess.d.ts.map +1 -0
  5. package/dist/defaultAccess.js +3 -0
  6. package/dist/defaultAccess.js.map +1 -0
  7. package/dist/defineTool.d.ts +8 -8
  8. package/dist/defineTool.d.ts.map +1 -1
  9. package/dist/endpoint/access.d.ts +12 -5
  10. package/dist/endpoint/access.d.ts.map +1 -1
  11. package/dist/endpoint/access.js +74 -103
  12. package/dist/endpoint/access.js.map +1 -1
  13. package/dist/endpoint/index.d.ts +1 -1
  14. package/dist/endpoint/index.d.ts.map +1 -1
  15. package/dist/endpoint/index.js +68 -17
  16. package/dist/endpoint/index.js.map +1 -1
  17. package/dist/exports/client.d.ts +1 -4
  18. package/dist/exports/client.d.ts.map +1 -1
  19. package/dist/exports/client.js +1 -4
  20. package/dist/exports/client.js.map +1 -1
  21. package/dist/exports/internal.d.ts +2 -0
  22. package/dist/exports/internal.d.ts.map +1 -0
  23. package/dist/exports/internal.js +3 -0
  24. package/dist/exports/internal.js.map +1 -0
  25. package/dist/index.d.ts +2 -2
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/index.js +3 -56
  28. package/dist/index.js.map +1 -1
  29. package/dist/mcp/buildMcpServer.d.ts +4 -4
  30. package/dist/mcp/buildMcpServer.d.ts.map +1 -1
  31. package/dist/mcp/buildMcpServer.js +32 -10
  32. package/dist/mcp/buildMcpServer.js.map +1 -1
  33. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  34. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  35. package/dist/mcp/builtin/collections/countTool.js +68 -0
  36. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  37. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  38. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  39. package/dist/mcp/builtin/collections/countVersionsTool.js +64 -0
  40. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  41. package/dist/mcp/builtin/collections/createTool.d.ts +1 -1
  42. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -1
  43. package/dist/mcp/builtin/collections/createTool.js +93 -40
  44. package/dist/mcp/builtin/collections/createTool.js.map +1 -1
  45. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -1
  46. package/dist/mcp/builtin/collections/deleteTool.js +3 -2
  47. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -1
  48. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  49. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  50. package/dist/mcp/builtin/collections/duplicateTool.js +96 -0
  51. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  52. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  53. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  54. package/dist/mcp/builtin/collections/fileInput.js +124 -0
  55. package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
  56. package/dist/mcp/builtin/collections/fileInput.spec.js +86 -0
  57. package/dist/mcp/builtin/collections/fileInput.spec.js.map +1 -0
  58. package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
  59. package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
  60. package/dist/mcp/builtin/collections/findDistinctTool.js +92 -0
  61. package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
  62. package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -1
  63. package/dist/mcp/builtin/collections/findTool.js +5 -4
  64. package/dist/mcp/builtin/collections/findTool.js.map +1 -1
  65. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
  66. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
  67. package/dist/mcp/builtin/collections/findVersionByIDTool.js +83 -0
  68. package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
  69. package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
  70. package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
  71. package/dist/mcp/builtin/collections/findVersionsTool.js +98 -0
  72. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  73. package/dist/mcp/builtin/collections/formatCollectionError.d.ts +1 -1
  74. package/dist/mcp/builtin/collections/formatCollectionError.d.ts.map +1 -1
  75. package/dist/mcp/builtin/collections/formatCollectionError.js.map +1 -1
  76. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -1
  77. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +49 -4
  78. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -1
  79. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  80. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  81. package/dist/mcp/builtin/collections/restoreVersionTool.js +81 -0
  82. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  83. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -1
  84. package/dist/mcp/builtin/collections/updateTool.js +26 -12
  85. package/dist/mcp/builtin/collections/updateTool.js.map +1 -1
  86. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  87. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  88. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  89. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  90. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -1
  91. package/dist/mcp/builtin/getConfigInfoTool.js +20 -8
  92. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -1
  93. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  94. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  95. package/dist/mcp/builtin/globals/countVersionsTool.js +64 -0
  96. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  97. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -1
  98. package/dist/mcp/builtin/globals/findTool.js +4 -2
  99. package/dist/mcp/builtin/globals/findTool.js.map +1 -1
  100. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  101. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  102. package/dist/mcp/builtin/globals/findVersionByIDTool.js +79 -0
  103. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  104. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  105. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  106. package/dist/mcp/builtin/globals/findVersionsTool.js +94 -0
  107. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  108. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -1
  109. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +25 -2
  110. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -1
  111. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  112. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  113. package/dist/mcp/builtin/globals/restoreVersionTool.js +77 -0
  114. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  115. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -1
  116. package/dist/mcp/builtin/globals/updateTool.js +4 -2
  117. package/dist/mcp/builtin/globals/updateTool.js.map +1 -1
  118. package/dist/mcp/builtin/validateEntityData.d.ts.map +1 -1
  119. package/dist/mcp/builtin/validateEntityData.js +1 -1
  120. package/dist/mcp/builtin/validateEntityData.js.map +1 -1
  121. package/dist/mcp/builtinTools.d.ts +73 -2
  122. package/dist/mcp/builtinTools.d.ts.map +1 -1
  123. package/dist/mcp/builtinTools.js +73 -3
  124. package/dist/mcp/builtinTools.js.map +1 -1
  125. package/dist/mcp/sanitizeMCPConfig.d.ts +0 -1
  126. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -1
  127. package/dist/mcp/sanitizeMCPConfig.js +48 -17
  128. package/dist/mcp/sanitizeMCPConfig.js.map +1 -1
  129. package/dist/stdio.d.ts +3 -3
  130. package/dist/stdio.d.ts.map +1 -1
  131. package/dist/stdio.js +84 -46
  132. package/dist/stdio.js.map +1 -1
  133. package/dist/types.d.ts +93 -87
  134. package/dist/types.d.ts.map +1 -1
  135. package/dist/types.js +2 -4
  136. package/dist/types.js.map +1 -1
  137. package/dist/utils/camelCase.d.ts.map +1 -1
  138. package/dist/utils/getPluginConfig.d.ts +1 -1
  139. package/dist/utils/getPluginConfig.js +1 -1
  140. package/dist/utils/getPluginConfig.js.map +1 -1
  141. package/dist/utils/resolveProjectRoot.d.ts.map +1 -1
  142. package/dist/utils/schemaConversion/filterFieldsByAccess.d.ts +28 -0
  143. package/dist/utils/schemaConversion/filterFieldsByAccess.d.ts.map +1 -0
  144. package/dist/utils/schemaConversion/filterFieldsByAccess.js +71 -0
  145. package/dist/utils/schemaConversion/filterFieldsByAccess.js.map +1 -0
  146. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts +5 -3
  147. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts.map +1 -1
  148. package/dist/utils/schemaConversion/getEntityInputSchema.js +44 -12
  149. package/dist/utils/schemaConversion/getEntityInputSchema.js.map +1 -1
  150. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts +5 -10
  151. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts.map +1 -1
  152. package/dist/utils/schemaConversion/sanitizeEntitySchema.js +15 -95
  153. package/dist/utils/schemaConversion/sanitizeEntitySchema.js.map +1 -1
  154. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js +15 -40
  155. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js.map +1 -1
  156. package/dist/utils/toStandardSchema.d.ts.map +1 -1
  157. package/package.json +11 -17
  158. package/src/defaultAccess.ts +3 -0
  159. package/src/endpoint/access.ts +80 -112
  160. package/src/endpoint/index.ts +58 -16
  161. package/src/exports/client.ts +2 -4
  162. package/src/exports/internal.ts +1 -0
  163. package/src/index.ts +5 -62
  164. package/src/mcp/buildMcpServer.ts +46 -21
  165. package/src/mcp/builtin/collections/countTool.ts +73 -0
  166. package/src/mcp/builtin/collections/countVersionsTool.ts +69 -0
  167. package/src/mcp/builtin/collections/createTool.ts +93 -34
  168. package/src/mcp/builtin/collections/deleteTool.ts +4 -2
  169. package/src/mcp/builtin/collections/duplicateTool.ts +134 -0
  170. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  171. package/src/mcp/builtin/collections/fileInput.ts +164 -0
  172. package/src/mcp/builtin/collections/findDistinctTool.ts +119 -0
  173. package/src/mcp/builtin/collections/findTool.ts +6 -4
  174. package/src/mcp/builtin/collections/findVersionByIDTool.ts +109 -0
  175. package/src/mcp/builtin/collections/findVersionsTool.ts +154 -0
  176. package/src/mcp/builtin/collections/formatCollectionError.ts +1 -1
  177. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +48 -3
  178. package/src/mcp/builtin/collections/restoreVersionTool.ts +107 -0
  179. package/src/mcp/builtin/collections/updateTool.ts +29 -10
  180. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  181. package/src/mcp/builtin/getConfigInfoTool.ts +20 -4
  182. package/src/mcp/builtin/globals/countVersionsTool.ts +68 -0
  183. package/src/mcp/builtin/globals/findTool.ts +5 -2
  184. package/src/mcp/builtin/globals/findVersionByIDTool.ts +103 -0
  185. package/src/mcp/builtin/globals/findVersionsTool.ts +147 -0
  186. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +30 -2
  187. package/src/mcp/builtin/globals/restoreVersionTool.ts +99 -0
  188. package/src/mcp/builtin/globals/updateTool.ts +5 -2
  189. package/src/mcp/builtin/validateEntityData.ts +1 -1
  190. package/src/mcp/builtinTools.ts +72 -6
  191. package/src/mcp/sanitizeMCPConfig.ts +36 -19
  192. package/src/stdio.ts +79 -46
  193. package/src/types.ts +101 -91
  194. package/src/utils/getPluginConfig.ts +1 -1
  195. package/src/utils/schemaConversion/filterFieldsByAccess.ts +123 -0
  196. package/src/utils/schemaConversion/getEntityInputSchema.ts +45 -27
  197. package/src/utils/schemaConversion/sanitizeEntitySchema.spec.ts +12 -19
  198. package/src/utils/schemaConversion/sanitizeEntitySchema.ts +17 -114
  199. package/dist/collection/getAccessField.d.ts +0 -12
  200. package/dist/collection/getAccessField.d.ts.map +0 -1
  201. package/dist/collection/getAccessField.js +0 -72
  202. package/dist/collection/getAccessField.js.map +0 -1
  203. package/dist/collection/index.d.ts +0 -6
  204. package/dist/collection/index.d.ts.map +0 -1
  205. package/dist/collection/index.js +0 -105
  206. package/dist/collection/index.js.map +0 -1
  207. package/dist/components/APIKeyField/index.client.d.ts +0 -9
  208. package/dist/components/APIKeyField/index.client.d.ts.map +0 -1
  209. package/dist/components/APIKeyField/index.client.js +0 -85
  210. package/dist/components/APIKeyField/index.client.js.map +0 -1
  211. package/dist/components/APIKeyField/index.css +0 -105
  212. package/dist/components/APIKeysEmptyState/index.client.d.ts +0 -4
  213. package/dist/components/APIKeysEmptyState/index.client.d.ts.map +0 -1
  214. package/dist/components/APIKeysEmptyState/index.client.js +0 -21
  215. package/dist/components/APIKeysEmptyState/index.client.js.map +0 -1
  216. package/dist/components/AccessField/index.client.d.ts +0 -10
  217. package/dist/components/AccessField/index.client.d.ts.map +0 -1
  218. package/dist/components/AccessField/index.client.js +0 -247
  219. package/dist/components/AccessField/index.client.js.map +0 -1
  220. package/dist/components/AccessField/index.css +0 -99
  221. package/dist/components/SettingsMenu/index.client.d.ts +0 -8
  222. package/dist/components/SettingsMenu/index.client.d.ts.map +0 -1
  223. package/dist/components/SettingsMenu/index.client.js +0 -24
  224. package/dist/components/SettingsMenu/index.client.js.map +0 -1
  225. package/dist/translations/index.d.ts +0 -11
  226. package/dist/translations/index.d.ts.map +0 -1
  227. package/dist/translations/index.js +0 -92
  228. package/dist/translations/index.js.map +0 -1
  229. package/dist/translations/languages/ar.d.ts +0 -31
  230. package/dist/translations/languages/ar.d.ts.map +0 -1
  231. package/dist/translations/languages/ar.js +0 -34
  232. package/dist/translations/languages/ar.js.map +0 -1
  233. package/dist/translations/languages/az.d.ts +0 -31
  234. package/dist/translations/languages/az.d.ts.map +0 -1
  235. package/dist/translations/languages/az.js +0 -34
  236. package/dist/translations/languages/az.js.map +0 -1
  237. package/dist/translations/languages/bg.d.ts +0 -31
  238. package/dist/translations/languages/bg.d.ts.map +0 -1
  239. package/dist/translations/languages/bg.js +0 -34
  240. package/dist/translations/languages/bg.js.map +0 -1
  241. package/dist/translations/languages/bnBd.d.ts +0 -31
  242. package/dist/translations/languages/bnBd.d.ts.map +0 -1
  243. package/dist/translations/languages/bnBd.js +0 -34
  244. package/dist/translations/languages/bnBd.js.map +0 -1
  245. package/dist/translations/languages/bnIn.d.ts +0 -31
  246. package/dist/translations/languages/bnIn.d.ts.map +0 -1
  247. package/dist/translations/languages/bnIn.js +0 -34
  248. package/dist/translations/languages/bnIn.js.map +0 -1
  249. package/dist/translations/languages/ca.d.ts +0 -31
  250. package/dist/translations/languages/ca.d.ts.map +0 -1
  251. package/dist/translations/languages/ca.js +0 -34
  252. package/dist/translations/languages/ca.js.map +0 -1
  253. package/dist/translations/languages/cs.d.ts +0 -31
  254. package/dist/translations/languages/cs.d.ts.map +0 -1
  255. package/dist/translations/languages/cs.js +0 -34
  256. package/dist/translations/languages/cs.js.map +0 -1
  257. package/dist/translations/languages/da.d.ts +0 -31
  258. package/dist/translations/languages/da.d.ts.map +0 -1
  259. package/dist/translations/languages/da.js +0 -34
  260. package/dist/translations/languages/da.js.map +0 -1
  261. package/dist/translations/languages/de.d.ts +0 -31
  262. package/dist/translations/languages/de.d.ts.map +0 -1
  263. package/dist/translations/languages/de.js +0 -34
  264. package/dist/translations/languages/de.js.map +0 -1
  265. package/dist/translations/languages/en.d.ts +0 -31
  266. package/dist/translations/languages/en.d.ts.map +0 -1
  267. package/dist/translations/languages/en.js +0 -34
  268. package/dist/translations/languages/en.js.map +0 -1
  269. package/dist/translations/languages/es.d.ts +0 -31
  270. package/dist/translations/languages/es.d.ts.map +0 -1
  271. package/dist/translations/languages/es.js +0 -34
  272. package/dist/translations/languages/es.js.map +0 -1
  273. package/dist/translations/languages/et.d.ts +0 -31
  274. package/dist/translations/languages/et.d.ts.map +0 -1
  275. package/dist/translations/languages/et.js +0 -34
  276. package/dist/translations/languages/et.js.map +0 -1
  277. package/dist/translations/languages/fa.d.ts +0 -31
  278. package/dist/translations/languages/fa.d.ts.map +0 -1
  279. package/dist/translations/languages/fa.js +0 -34
  280. package/dist/translations/languages/fa.js.map +0 -1
  281. package/dist/translations/languages/fr.d.ts +0 -31
  282. package/dist/translations/languages/fr.d.ts.map +0 -1
  283. package/dist/translations/languages/fr.js +0 -34
  284. package/dist/translations/languages/fr.js.map +0 -1
  285. package/dist/translations/languages/he.d.ts +0 -31
  286. package/dist/translations/languages/he.d.ts.map +0 -1
  287. package/dist/translations/languages/he.js +0 -34
  288. package/dist/translations/languages/he.js.map +0 -1
  289. package/dist/translations/languages/hr.d.ts +0 -31
  290. package/dist/translations/languages/hr.d.ts.map +0 -1
  291. package/dist/translations/languages/hr.js +0 -34
  292. package/dist/translations/languages/hr.js.map +0 -1
  293. package/dist/translations/languages/hu.d.ts +0 -31
  294. package/dist/translations/languages/hu.d.ts.map +0 -1
  295. package/dist/translations/languages/hu.js +0 -34
  296. package/dist/translations/languages/hu.js.map +0 -1
  297. package/dist/translations/languages/hy.d.ts +0 -31
  298. package/dist/translations/languages/hy.d.ts.map +0 -1
  299. package/dist/translations/languages/hy.js +0 -34
  300. package/dist/translations/languages/hy.js.map +0 -1
  301. package/dist/translations/languages/id.d.ts +0 -31
  302. package/dist/translations/languages/id.d.ts.map +0 -1
  303. package/dist/translations/languages/id.js +0 -34
  304. package/dist/translations/languages/id.js.map +0 -1
  305. package/dist/translations/languages/is.d.ts +0 -31
  306. package/dist/translations/languages/is.d.ts.map +0 -1
  307. package/dist/translations/languages/is.js +0 -34
  308. package/dist/translations/languages/is.js.map +0 -1
  309. package/dist/translations/languages/it.d.ts +0 -31
  310. package/dist/translations/languages/it.d.ts.map +0 -1
  311. package/dist/translations/languages/it.js +0 -34
  312. package/dist/translations/languages/it.js.map +0 -1
  313. package/dist/translations/languages/ja.d.ts +0 -31
  314. package/dist/translations/languages/ja.d.ts.map +0 -1
  315. package/dist/translations/languages/ja.js +0 -34
  316. package/dist/translations/languages/ja.js.map +0 -1
  317. package/dist/translations/languages/ko.d.ts +0 -31
  318. package/dist/translations/languages/ko.d.ts.map +0 -1
  319. package/dist/translations/languages/ko.js +0 -34
  320. package/dist/translations/languages/ko.js.map +0 -1
  321. package/dist/translations/languages/lt.d.ts +0 -31
  322. package/dist/translations/languages/lt.d.ts.map +0 -1
  323. package/dist/translations/languages/lt.js +0 -34
  324. package/dist/translations/languages/lt.js.map +0 -1
  325. package/dist/translations/languages/lv.d.ts +0 -31
  326. package/dist/translations/languages/lv.d.ts.map +0 -1
  327. package/dist/translations/languages/lv.js +0 -34
  328. package/dist/translations/languages/lv.js.map +0 -1
  329. package/dist/translations/languages/my.d.ts +0 -31
  330. package/dist/translations/languages/my.d.ts.map +0 -1
  331. package/dist/translations/languages/my.js +0 -34
  332. package/dist/translations/languages/my.js.map +0 -1
  333. package/dist/translations/languages/nb.d.ts +0 -31
  334. package/dist/translations/languages/nb.d.ts.map +0 -1
  335. package/dist/translations/languages/nb.js +0 -34
  336. package/dist/translations/languages/nb.js.map +0 -1
  337. package/dist/translations/languages/nl.d.ts +0 -31
  338. package/dist/translations/languages/nl.d.ts.map +0 -1
  339. package/dist/translations/languages/nl.js +0 -34
  340. package/dist/translations/languages/nl.js.map +0 -1
  341. package/dist/translations/languages/pl.d.ts +0 -31
  342. package/dist/translations/languages/pl.d.ts.map +0 -1
  343. package/dist/translations/languages/pl.js +0 -34
  344. package/dist/translations/languages/pl.js.map +0 -1
  345. package/dist/translations/languages/pt.d.ts +0 -31
  346. package/dist/translations/languages/pt.d.ts.map +0 -1
  347. package/dist/translations/languages/pt.js +0 -34
  348. package/dist/translations/languages/pt.js.map +0 -1
  349. package/dist/translations/languages/ro.d.ts +0 -31
  350. package/dist/translations/languages/ro.d.ts.map +0 -1
  351. package/dist/translations/languages/ro.js +0 -34
  352. package/dist/translations/languages/ro.js.map +0 -1
  353. package/dist/translations/languages/rs.d.ts +0 -31
  354. package/dist/translations/languages/rs.d.ts.map +0 -1
  355. package/dist/translations/languages/rs.js +0 -34
  356. package/dist/translations/languages/rs.js.map +0 -1
  357. package/dist/translations/languages/rsLatin.d.ts +0 -31
  358. package/dist/translations/languages/rsLatin.d.ts.map +0 -1
  359. package/dist/translations/languages/rsLatin.js +0 -34
  360. package/dist/translations/languages/rsLatin.js.map +0 -1
  361. package/dist/translations/languages/ru.d.ts +0 -31
  362. package/dist/translations/languages/ru.d.ts.map +0 -1
  363. package/dist/translations/languages/ru.js +0 -34
  364. package/dist/translations/languages/ru.js.map +0 -1
  365. package/dist/translations/languages/sk.d.ts +0 -31
  366. package/dist/translations/languages/sk.d.ts.map +0 -1
  367. package/dist/translations/languages/sk.js +0 -34
  368. package/dist/translations/languages/sk.js.map +0 -1
  369. package/dist/translations/languages/sl.d.ts +0 -31
  370. package/dist/translations/languages/sl.d.ts.map +0 -1
  371. package/dist/translations/languages/sl.js +0 -34
  372. package/dist/translations/languages/sl.js.map +0 -1
  373. package/dist/translations/languages/sv.d.ts +0 -31
  374. package/dist/translations/languages/sv.d.ts.map +0 -1
  375. package/dist/translations/languages/sv.js +0 -34
  376. package/dist/translations/languages/sv.js.map +0 -1
  377. package/dist/translations/languages/ta.d.ts +0 -31
  378. package/dist/translations/languages/ta.d.ts.map +0 -1
  379. package/dist/translations/languages/ta.js +0 -34
  380. package/dist/translations/languages/ta.js.map +0 -1
  381. package/dist/translations/languages/th.d.ts +0 -31
  382. package/dist/translations/languages/th.d.ts.map +0 -1
  383. package/dist/translations/languages/th.js +0 -34
  384. package/dist/translations/languages/th.js.map +0 -1
  385. package/dist/translations/languages/tr.d.ts +0 -31
  386. package/dist/translations/languages/tr.d.ts.map +0 -1
  387. package/dist/translations/languages/tr.js +0 -34
  388. package/dist/translations/languages/tr.js.map +0 -1
  389. package/dist/translations/languages/uk.d.ts +0 -31
  390. package/dist/translations/languages/uk.d.ts.map +0 -1
  391. package/dist/translations/languages/uk.js +0 -34
  392. package/dist/translations/languages/uk.js.map +0 -1
  393. package/dist/translations/languages/vi.d.ts +0 -31
  394. package/dist/translations/languages/vi.d.ts.map +0 -1
  395. package/dist/translations/languages/vi.js +0 -34
  396. package/dist/translations/languages/vi.js.map +0 -1
  397. package/dist/translations/languages/zh.d.ts +0 -31
  398. package/dist/translations/languages/zh.d.ts.map +0 -1
  399. package/dist/translations/languages/zh.js +0 -34
  400. package/dist/translations/languages/zh.js.map +0 -1
  401. package/dist/translations/languages/zhTw.d.ts +0 -31
  402. package/dist/translations/languages/zhTw.d.ts.map +0 -1
  403. package/dist/translations/languages/zhTw.js +0 -34
  404. package/dist/translations/languages/zhTw.js.map +0 -1
  405. package/dist/translations/types.d.ts +0 -32
  406. package/dist/translations/types.d.ts.map +0 -1
  407. package/dist/translations/types.js +0 -3
  408. package/dist/translations/types.js.map +0 -1
  409. package/dist/utils/localAPIDefaults.d.ts +0 -20
  410. package/dist/utils/localAPIDefaults.d.ts.map +0 -1
  411. package/dist/utils/localAPIDefaults.js +0 -19
  412. package/dist/utils/localAPIDefaults.js.map +0 -1
  413. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
  414. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
  415. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
  416. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
  417. package/src/collection/getAccessField.ts +0 -84
  418. package/src/collection/index.ts +0 -105
  419. package/src/components/APIKeyField/index.client.tsx +0 -68
  420. package/src/components/APIKeyField/index.css +0 -105
  421. package/src/components/APIKeysEmptyState/index.client.tsx +0 -33
  422. package/src/components/AccessField/index.client.tsx +0 -296
  423. package/src/components/AccessField/index.css +0 -99
  424. package/src/components/SettingsMenu/index.client.tsx +0 -30
  425. package/src/translations/index.ts +0 -105
  426. package/src/translations/languages/ar.ts +0 -38
  427. package/src/translations/languages/az.ts +0 -38
  428. package/src/translations/languages/bg.ts +0 -39
  429. package/src/translations/languages/bnBd.ts +0 -39
  430. package/src/translations/languages/bnIn.ts +0 -39
  431. package/src/translations/languages/ca.ts +0 -39
  432. package/src/translations/languages/cs.ts +0 -39
  433. package/src/translations/languages/da.ts +0 -38
  434. package/src/translations/languages/de.ts +0 -39
  435. package/src/translations/languages/en.ts +0 -39
  436. package/src/translations/languages/es.ts +0 -39
  437. package/src/translations/languages/et.ts +0 -38
  438. package/src/translations/languages/fa.ts +0 -39
  439. package/src/translations/languages/fr.ts +0 -39
  440. package/src/translations/languages/he.ts +0 -37
  441. package/src/translations/languages/hr.ts +0 -39
  442. package/src/translations/languages/hu.ts +0 -39
  443. package/src/translations/languages/hy.ts +0 -39
  444. package/src/translations/languages/id.ts +0 -39
  445. package/src/translations/languages/is.ts +0 -39
  446. package/src/translations/languages/it.ts +0 -39
  447. package/src/translations/languages/ja.ts +0 -39
  448. package/src/translations/languages/ko.ts +0 -39
  449. package/src/translations/languages/lt.ts +0 -39
  450. package/src/translations/languages/lv.ts +0 -38
  451. package/src/translations/languages/my.ts +0 -39
  452. package/src/translations/languages/nb.ts +0 -39
  453. package/src/translations/languages/nl.ts +0 -39
  454. package/src/translations/languages/pl.ts +0 -38
  455. package/src/translations/languages/pt.ts +0 -39
  456. package/src/translations/languages/ro.ts +0 -39
  457. package/src/translations/languages/rs.ts +0 -38
  458. package/src/translations/languages/rsLatin.ts +0 -38
  459. package/src/translations/languages/ru.ts +0 -39
  460. package/src/translations/languages/sk.ts +0 -39
  461. package/src/translations/languages/sl.ts +0 -38
  462. package/src/translations/languages/sv.ts +0 -39
  463. package/src/translations/languages/ta.ts +0 -39
  464. package/src/translations/languages/th.ts +0 -38
  465. package/src/translations/languages/tr.ts +0 -38
  466. package/src/translations/languages/uk.ts +0 -39
  467. package/src/translations/languages/vi.ts +0 -39
  468. package/src/translations/languages/zh.ts +0 -36
  469. package/src/translations/languages/zhTw.ts +0 -36
  470. package/src/translations/types.ts +0 -34
  471. package/src/utils/localAPIDefaults.ts +0 -22
  472. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
@@ -0,0 +1,154 @@
1
+ import type { PopulateType, SelectType } from 'payload'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import { defaultAccess } from '../../../defaultAccess.js'
6
+ import { defineCollectionTool } from '../../../defineTool.js'
7
+ import { getLogger } from '../../../utils/getLogger.js'
8
+ import { whereSchema } from '../../../utils/whereSchema.js'
9
+
10
+ const DEFAULT_DESCRIPTION =
11
+ 'Find document versions in any version-enabled collection by passing the collection slug and optional where clause.'
12
+
13
+ export const findVersionsTool = defineCollectionTool({
14
+ access: (args) =>
15
+ defaultAccess(args) &&
16
+ Boolean(args.permissions?.collections?.[args.collectionSlug]?.readVersions),
17
+ annotations: {
18
+ destructiveHint: false,
19
+ idempotentHint: true,
20
+ openWorldHint: false,
21
+ readOnlyHint: true,
22
+ title: 'Find Versions',
23
+ },
24
+ description: DEFAULT_DESCRIPTION,
25
+ input: z.object({
26
+ depth: z
27
+ .number()
28
+ .int()
29
+ .min(0)
30
+ .max(10)
31
+ .describe('How many levels deep to populate relationships in version documents')
32
+ .optional()
33
+ .default(0),
34
+ fallbackLocale: z
35
+ .string()
36
+ .describe('Optional: fallback locale code to use when requested locale is not available')
37
+ .optional(),
38
+ limit: z
39
+ .number()
40
+ .int()
41
+ .min(1)
42
+ .max(100)
43
+ .describe('Maximum number of versions to return (default: 10, max: 100)')
44
+ .optional()
45
+ .default(10),
46
+ locale: z
47
+ .string()
48
+ .describe(
49
+ 'Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields',
50
+ )
51
+ .optional(),
52
+ page: z
53
+ .number()
54
+ .int()
55
+ .min(1)
56
+ .describe('Page number for pagination (default: 1)')
57
+ .optional()
58
+ .default(1),
59
+ pagination: z
60
+ .boolean()
61
+ .describe('Optional: set to false to skip the count query overhead')
62
+ .optional(),
63
+ populate: z
64
+ .record(z.string(), z.unknown())
65
+ .describe(
66
+ 'Optional: control which fields to include from populated relationship or upload documents.',
67
+ )
68
+ .optional(),
69
+ select: z
70
+ .record(z.string(), z.unknown())
71
+ .describe(
72
+ 'Optional: define exactly which fields you\'d like to return in the response, e.g., {"version.title": true}',
73
+ )
74
+ .optional(),
75
+ showHiddenFields: z
76
+ .boolean()
77
+ .describe('Optional: include hidden fields in returned version documents')
78
+ .optional(),
79
+ sort: z
80
+ .string()
81
+ .describe('Field to sort by (e.g., "-updatedAt", "-version.updatedAt" for descending)')
82
+ .optional(),
83
+ trash: z
84
+ .boolean()
85
+ .describe('Optional: include versions for soft-deleted documents when trash is enabled')
86
+ .optional(),
87
+ where: whereSchema
88
+ .describe(
89
+ 'Optional: where clause for filtering versions. Version document fields are usually under "version". Example: {"version.title":{"contains":"test"}}',
90
+ )
91
+ .optional(),
92
+ }),
93
+ }).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {
94
+ const payload = req.payload
95
+ const logger = getLogger({ payload })
96
+ const {
97
+ depth,
98
+ fallbackLocale,
99
+ limit,
100
+ locale,
101
+ page,
102
+ pagination,
103
+ populate,
104
+ select,
105
+ showHiddenFields,
106
+ sort,
107
+ trash,
108
+ where,
109
+ } = input
110
+
111
+ logger.info(`Finding versions in collection: ${collectionSlug}, limit: ${limit}, page: ${page}`)
112
+
113
+ try {
114
+ const result = await payload.findVersions({
115
+ collection: collectionSlug,
116
+ depth,
117
+ limit,
118
+ overrideAccess: authorizedMCP.overrideAccess,
119
+ page,
120
+ req,
121
+ ...(fallbackLocale ? { fallbackLocale } : {}),
122
+ ...(locale ? { locale } : {}),
123
+ ...(pagination !== undefined ? { pagination } : {}),
124
+ ...(populate ? { populate: populate as PopulateType } : {}),
125
+ ...(select ? { select: select as SelectType } : {}),
126
+ ...(showHiddenFields !== undefined ? { showHiddenFields } : {}),
127
+ ...(sort ? { sort } : {}),
128
+ ...(trash !== undefined ? { trash } : {}),
129
+ ...(where ? { where } : {}),
130
+ })
131
+
132
+ return {
133
+ content: [
134
+ {
135
+ type: 'text',
136
+ text: `Versions for collection "${collectionSlug}":\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``,
137
+ },
138
+ ],
139
+ doc: result as unknown as Record<string, unknown>,
140
+ }
141
+ } catch (error) {
142
+ const errorMessage = error instanceof Error ? error.message : 'Unknown error'
143
+ logger.error(`Error finding versions in ${collectionSlug}: ${errorMessage}`)
144
+ return {
145
+ content: [
146
+ {
147
+ type: 'text',
148
+ text: `❌ **Error finding versions in collection "${collectionSlug}":** ${errorMessage}`,
149
+ },
150
+ ],
151
+ isError: true,
152
+ }
153
+ }
154
+ })
@@ -38,7 +38,7 @@ export const formatCollectionError = ({
38
38
  error,
39
39
  req,
40
40
  }: {
41
- action: 'creating' | 'updating'
41
+ action: 'creating' | 'duplicating' | 'updating'
42
42
  collectionSlug: CollectionSlug
43
43
  error: unknown
44
44
  req: PayloadRequest
@@ -1,7 +1,15 @@
1
+ import { getAccessResults } from 'payload'
2
+
3
+ import { defaultAccess } from '../../../defaultAccess.js'
1
4
  import { defineCollectionTool } from '../../../defineTool.js'
2
5
  import { getCollectionInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'
3
6
 
4
7
  export const getCollectionSchemaTool = defineCollectionTool({
8
+ access: (args) => {
9
+ const permissions = args.permissions?.collections?.[args.collectionSlug]
10
+
11
+ return defaultAccess(args) && Boolean(permissions?.create || permissions?.update)
12
+ },
5
13
  annotations: {
6
14
  destructiveHint: false,
7
15
  idempotentHint: true,
@@ -10,8 +18,28 @@ export const getCollectionSchemaTool = defineCollectionTool({
10
18
  title: 'Get Collection Schema',
11
19
  },
12
20
  description: 'Get the input schema for creating or updating documents in a collection.',
13
- }).handler(({ collectionSlug, req }) => {
14
- const inputSchema = getCollectionInputSchema({ collectionSlug, req })
21
+ }).handler(async ({ authorizedMCP, collectionSlug, req }) => {
22
+ const permissions = authorizedMCP.overrideAccess
23
+ ? null
24
+ : (await getAccessResults({ req })).collections?.[collectionSlug]
25
+
26
+ if (!authorizedMCP.overrideAccess && !permissions?.create && !permissions?.update) {
27
+ return {
28
+ content: [
29
+ {
30
+ type: 'text',
31
+ text: `Error: MCP access to "getCollectionSchema" is not enabled for collection "${collectionSlug}"`,
32
+ },
33
+ ],
34
+ isError: true,
35
+ }
36
+ }
37
+
38
+ const inputSchema = getCollectionInputSchema({
39
+ collectionSlug,
40
+ req,
41
+ ...(permissions ? { permissions } : {}),
42
+ })
15
43
 
16
44
  if (!inputSchema) {
17
45
  return {
@@ -20,16 +48,33 @@ export const getCollectionSchemaTool = defineCollectionTool({
20
48
  }
21
49
  }
22
50
 
51
+ const uploadConfig = req.payload.collections[collectionSlug]?.config.upload
52
+ const maxFileSize = req.payload.config.upload.limits?.fileSize
53
+ const upload = uploadConfig
54
+ ? {
55
+ enabled: true,
56
+ filesRequiredOnCreate: uploadConfig.filesRequiredOnCreate !== false,
57
+ mimeTypes: uploadConfig.mimeTypes ?? ['*/*'],
58
+ sources: [
59
+ ...(uploadConfig.pasteURL !== false ? ['externalURL'] : []),
60
+ 'base64',
61
+ 'uploadReference',
62
+ ],
63
+ ...(typeof maxFileSize === 'number' && Number.isFinite(maxFileSize) ? { maxFileSize } : {}),
64
+ }
65
+ : { enabled: false }
66
+
23
67
  return {
24
68
  content: [
25
69
  {
26
70
  type: 'text',
27
- text: `Schema for collection "${collectionSlug}":\n\`\`\`json\n${JSON.stringify(inputSchema)}\n\`\`\``,
71
+ text: `Schema for collection "${collectionSlug}":\n\`\`\`json\n${JSON.stringify(inputSchema)}\n\`\`\`\nUpload configuration:\n\`\`\`json\n${JSON.stringify(upload)}\n\`\`\``,
28
72
  },
29
73
  ],
30
74
  structuredContent: {
31
75
  collectionSlug,
32
76
  schema: inputSchema,
77
+ upload,
33
78
  },
34
79
  }
35
80
  })
@@ -0,0 +1,107 @@
1
+ import type { PopulateType, SelectType } from 'payload'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import { defaultAccess } from '../../../defaultAccess.js'
6
+ import { defineCollectionTool } from '../../../defineTool.js'
7
+ import { getLogger } from '../../../utils/getLogger.js'
8
+
9
+ const DEFAULT_DESCRIPTION =
10
+ 'Restore a document from a previous version in any version-enabled collection.'
11
+
12
+ export const restoreVersionTool = defineCollectionTool({
13
+ access: (args) =>
14
+ defaultAccess(args) && Boolean(args.permissions?.collections?.[args.collectionSlug]?.update),
15
+ annotations: {
16
+ destructiveHint: true,
17
+ idempotentHint: false,
18
+ openWorldHint: false,
19
+ readOnlyHint: false,
20
+ title: 'Restore Version',
21
+ },
22
+ description: DEFAULT_DESCRIPTION,
23
+ input: z.object({
24
+ id: z.string().describe('The ID of the version to restore'),
25
+ depth: z
26
+ .number()
27
+ .int()
28
+ .min(0)
29
+ .max(10)
30
+ .describe('How many levels deep to populate relationships in response')
31
+ .optional()
32
+ .default(0),
33
+ draft: z
34
+ .boolean()
35
+ .describe('Whether to restore the version as a draft')
36
+ .optional()
37
+ .default(false),
38
+ fallbackLocale: z
39
+ .string()
40
+ .describe('Optional: fallback locale code to use when requested locale is not available')
41
+ .optional(),
42
+ locale: z
43
+ .string()
44
+ .describe('Optional: locale code to restore in (e.g., "en", "es")')
45
+ .optional(),
46
+ populate: z
47
+ .record(z.string(), z.unknown())
48
+ .describe(
49
+ 'Optional: control which fields to include from populated relationship or upload documents.',
50
+ )
51
+ .optional(),
52
+ select: z
53
+ .record(z.string(), z.unknown())
54
+ .describe(
55
+ 'Optional: define exactly which fields you\'d like to return in the response, e.g., {"title": true}',
56
+ )
57
+ .optional(),
58
+ showHiddenFields: z
59
+ .boolean()
60
+ .describe('Optional: include hidden fields in the restored document response')
61
+ .optional(),
62
+ }),
63
+ }).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {
64
+ const payload = req.payload
65
+ const logger = getLogger({ payload })
66
+ const { id, depth, draft, fallbackLocale, locale, populate, select, showHiddenFields } = input
67
+
68
+ logger.info(`Restoring version in collection: ${collectionSlug} with ID: ${id}`)
69
+
70
+ try {
71
+ const result = await payload.restoreVersion({
72
+ id,
73
+ collection: collectionSlug,
74
+ depth,
75
+ draft,
76
+ overrideAccess: authorizedMCP.overrideAccess,
77
+ req,
78
+ ...(fallbackLocale ? { fallbackLocale } : {}),
79
+ ...(locale ? { locale } : {}),
80
+ ...(populate ? { populate: populate as PopulateType } : {}),
81
+ ...(select ? { select: select as SelectType } : {}),
82
+ ...(showHiddenFields !== undefined ? { showHiddenFields } : {}),
83
+ })
84
+
85
+ return {
86
+ content: [
87
+ {
88
+ type: 'text',
89
+ text: `Version "${id}" restored successfully in collection "${collectionSlug}"!\nRestored document:\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``,
90
+ },
91
+ ],
92
+ doc: result as Record<string, unknown>,
93
+ }
94
+ } catch (error) {
95
+ const errorMessage = error instanceof Error ? error.message : 'Unknown error'
96
+ logger.error(`Error restoring version ${id} in ${collectionSlug}: ${errorMessage}`)
97
+ return {
98
+ content: [
99
+ {
100
+ type: 'text',
101
+ text: `❌ **Error restoring version "${id}" in collection "${collectionSlug}":** ${errorMessage}`,
102
+ },
103
+ ],
104
+ isError: true,
105
+ }
106
+ }
107
+ })
@@ -2,23 +2,26 @@ import type { SelectType, Where } from 'payload'
2
2
 
3
3
  import { z } from 'zod'
4
4
 
5
+ import { defaultAccess } from '../../../defaultAccess.js'
5
6
  import { defineCollectionTool } from '../../../defineTool.js'
6
7
  import { getLogger } from '../../../utils/getLogger.js'
7
8
  import {
8
9
  getCollectionVirtualFieldNames,
9
10
  stripVirtualFields,
10
11
  } from '../../../utils/getVirtualFieldNames.js'
11
- import { localAPIDefaults } from '../../../utils/localAPIDefaults.js'
12
12
  import { getCollectionInputSchema } from '../../../utils/schemaConversion/getEntityInputSchema.js'
13
13
  import { transformPointDataToPayload } from '../../../utils/transformPointDataToPayload.js'
14
14
  import { whereSchema } from '../../../utils/whereSchema.js'
15
15
  import { validateCollectionData } from '../validateEntityData.js'
16
+ import { fileInputSchema, resolveFile } from './fileInput.js'
16
17
  import { formatCollectionError } from './formatCollectionError.js'
17
18
 
18
19
  const DEFAULT_DESCRIPTION =
19
- 'Update documents in any collection by passing the collection slug and data.'
20
+ 'Update documents. Prefer uploadReference after upload, externalURL for URLs, or base64 for small local files.'
20
21
 
21
22
  export const updateDocumentTool = defineCollectionTool({
23
+ access: (args) =>
24
+ defaultAccess(args) && Boolean(args.permissions?.collections?.[args.collectionSlug]?.update),
22
25
  annotations: {
23
26
  destructiveHint: true,
24
27
  idempotentHint: false,
@@ -29,7 +32,11 @@ export const updateDocumentTool = defineCollectionTool({
29
32
  description: DEFAULT_DESCRIPTION,
30
33
  input: z.object({
31
34
  id: z.union([z.string(), z.number()]).describe('The ID of the document to update').optional(),
32
- data: z.record(z.string(), z.unknown()).describe('The fields to update'),
35
+ data: z
36
+ .record(z.string(), z.unknown())
37
+ .describe(
38
+ 'The fields to update. Only include fields permitted by the schema returned by getCollectionSchema.',
39
+ ),
33
40
  depth: z
34
41
  .number()
35
42
  .describe('How many levels deep to populate relationships')
@@ -37,14 +44,16 @@ export const updateDocumentTool = defineCollectionTool({
37
44
  .default(0),
38
45
  draft: z
39
46
  .boolean()
40
- .describe('Whether to update the document as a draft')
47
+ .describe(
48
+ 'Only if getCollectionSchema includes _status; otherwise _status does not exist. true saves only a draft version; false updates main and versions. data._status: "published" overrides true.',
49
+ )
41
50
  .optional()
42
51
  .default(false),
43
52
  fallbackLocale: z
44
53
  .string()
45
54
  .describe('Optional: fallback locale code to use when requested locale is not available')
46
55
  .optional(),
47
- filePath: z.string().describe('File path for file uploads').optional(),
56
+ file: fileInputSchema.optional(),
48
57
  locale: z
49
58
  .string()
50
59
  .describe(
@@ -61,6 +70,12 @@ export const updateDocumentTool = defineCollectionTool({
61
70
  .describe('Whether to overwrite existing files')
62
71
  .optional()
63
72
  .default(false),
73
+ publishAllLocales: z
74
+ .boolean()
75
+ .describe(
76
+ 'For collections with localized publishing status, whether publishing should affect every locale. Set false with locale to publish only that locale.',
77
+ )
78
+ .optional(),
64
79
  select: z
65
80
  .record(z.string(), z.unknown())
66
81
  .describe(
@@ -83,10 +98,11 @@ export const updateDocumentTool = defineCollectionTool({
83
98
  depth,
84
99
  draft,
85
100
  fallbackLocale,
86
- filePath,
101
+ file: fileInput,
87
102
  locale,
88
103
  overrideLock,
89
104
  overwriteExistingFiles,
105
+ publishAllLocales,
90
106
  select,
91
107
  where,
92
108
  } = input
@@ -116,6 +132,7 @@ export const updateDocumentTool = defineCollectionTool({
116
132
  }
117
133
 
118
134
  const parsedData = transformPointDataToPayload(inputData)
135
+ const file = await resolveFile({ collectionSlug, input: fileInput, req })
119
136
 
120
137
  const whereClause: Where = where ?? {}
121
138
 
@@ -126,11 +143,12 @@ export const updateDocumentTool = defineCollectionTool({
126
143
  data: parsedData,
127
144
  depth,
128
145
  draft,
146
+ overrideAccess: authorizedMCP.overrideAccess,
129
147
  overrideLock,
130
148
  req,
131
- ...localAPIDefaults(authorizedMCP),
132
- ...(filePath ? { filePath } : {}),
149
+ ...(file ? { file } : {}),
133
150
  ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),
151
+ ...(publishAllLocales !== undefined ? { publishAllLocales } : {}),
134
152
  ...(locale ? { locale } : {}),
135
153
  ...(fallbackLocale ? { fallbackLocale } : {}),
136
154
  ...(select ? { select: select as SelectType } : {}),
@@ -152,12 +170,13 @@ export const updateDocumentTool = defineCollectionTool({
152
170
  data: parsedData,
153
171
  depth,
154
172
  draft,
173
+ overrideAccess: authorizedMCP.overrideAccess,
155
174
  overrideLock,
156
175
  req,
157
176
  where: whereClause,
158
- ...localAPIDefaults(authorizedMCP),
159
- ...(filePath ? { filePath } : {}),
177
+ ...(file ? { file } : {}),
160
178
  ...(overwriteExistingFiles ? { overwriteExistingFiles } : {}),
179
+ ...(publishAllLocales !== undefined ? { publishAllLocales } : {}),
161
180
  ...(locale ? { locale } : {}),
162
181
  ...(fallbackLocale ? { fallbackLocale } : {}),
163
182
  ...(select ? { select: select as SelectType } : {}),
@@ -0,0 +1,64 @@
1
+ import { getUploadInstructions as getPayloadUploadInstructions } from 'payload/internal'
2
+ import { z } from 'zod'
3
+
4
+ import { defaultAccess } from '../../../defaultAccess.js'
5
+ import { defineCollectionTool } from '../../../defineTool.js'
6
+
7
+ export const getUploadInstructionsTool = defineCollectionTool({
8
+ access: (args) =>
9
+ defaultAccess(args) &&
10
+ Boolean(
11
+ args.permissions?.collections?.[args.collectionSlug]?.create ||
12
+ args.permissions?.collections?.[args.collectionSlug]?.update,
13
+ ),
14
+ annotations: {
15
+ destructiveHint: false,
16
+ idempotentHint: false,
17
+ openWorldHint: true,
18
+ readOnlyHint: false,
19
+ title: 'Get Upload Instructions',
20
+ },
21
+ description:
22
+ 'Prepare uploads for createDocuments or updateDocument. This does not upload bytes; finish the returned action before use.',
23
+ input: z.object({
24
+ docPrefix: z.string().describe('Optional document folder or prefix').optional(),
25
+ filename: z.string().describe('The original file name'),
26
+ filesize: z.number().int().nonnegative().describe('The file size in bytes'),
27
+ mimeType: z.string().describe('The file MIME type'),
28
+ }),
29
+ }).handler(async ({ authorizedMCP, collectionSlug, input, req }) => {
30
+ try {
31
+ const instructions = await getPayloadUploadInstructions({
32
+ ...input,
33
+ collectionSlug,
34
+ overrideAccess: authorizedMCP.overrideAccess,
35
+ req,
36
+ })
37
+
38
+ const nextStep =
39
+ instructions.type === 'http'
40
+ ? 'Upload bytes with instructions.request. After success, pass { source: "uploadReference", file: instructions.file }.'
41
+ : `Call "${instructions.name}" with file and data. After success, pass { source: "uploadReference", file: instructions.file }.`
42
+
43
+ return {
44
+ content: [
45
+ {
46
+ type: 'text',
47
+ text: `Upload instructions for collection "${collectionSlug}":\n\`\`\`json\n${JSON.stringify(instructions)}\n\`\`\`\n${nextStep}`,
48
+ },
49
+ ],
50
+ structuredContent: { instructions },
51
+ }
52
+ } catch (error) {
53
+ const message = error instanceof Error ? error.message : 'Unknown error'
54
+ return {
55
+ content: [
56
+ {
57
+ type: 'text',
58
+ text: `Error getting upload instructions for collection "${collectionSlug}": ${message}`,
59
+ },
60
+ ],
61
+ isError: true,
62
+ }
63
+ }
64
+ })
@@ -12,17 +12,30 @@ export const getConfigInfoTool = defineTool({
12
12
  },
13
13
  description: 'List the Payload collection and global slugs visible to this MCP client.',
14
14
  }).handler(async ({ authorizedMCP, req }) => {
15
- const user = authorizedMCP.user ?? req.user ?? null
16
- const permissions = user ? await getAccessResults({ req: { ...req, user } }) : null
15
+ const user = req.user
16
+ const permissions = authorizedMCP.overrideAccess ? null : await getAccessResults({ req })
17
+ const authorizedCollectionSlugs = new Set<string>()
18
+ const authorizedGlobalSlugs = new Set<string>()
19
+
20
+ for (const item of authorizedMCP.items) {
21
+ if (item.type === 'collectionTool') {
22
+ authorizedCollectionSlugs.add(item.collectionSlug)
23
+ } else if (item.type === 'globalTool') {
24
+ authorizedGlobalSlugs.add(item.globalSlug)
25
+ }
26
+ }
17
27
 
18
28
  const collections: string[] = []
19
29
  const globals: string[] = []
20
30
 
21
31
  for (const collection of req.payload.config.collections) {
32
+ if (!authorizedCollectionSlugs.has(collection.slug)) {
33
+ continue
34
+ }
22
35
  if (user && isEntityHidden({ hidden: collection.admin.hidden, user })) {
23
36
  continue
24
37
  }
25
- if (user && !permissions?.collections?.[collection.slug]?.read) {
38
+ if (!authorizedMCP.overrideAccess && !permissions?.collections?.[collection.slug]?.read) {
26
39
  continue
27
40
  }
28
41
 
@@ -30,10 +43,13 @@ export const getConfigInfoTool = defineTool({
30
43
  }
31
44
 
32
45
  for (const global of req.payload.config.globals) {
46
+ if (!authorizedGlobalSlugs.has(global.slug)) {
47
+ continue
48
+ }
33
49
  if (user && isEntityHidden({ hidden: global.admin.hidden, user })) {
34
50
  continue
35
51
  }
36
- if (user && !permissions?.globals?.[global.slug]?.read) {
52
+ if (!authorizedMCP.overrideAccess && !permissions?.globals?.[global.slug]?.read) {
37
53
  continue
38
54
  }
39
55
 
@@ -0,0 +1,68 @@
1
+ import { z } from 'zod'
2
+
3
+ import { defaultAccess } from '../../../defaultAccess.js'
4
+ import { defineGlobalTool } from '../../../defineTool.js'
5
+ import { getLogger } from '../../../utils/getLogger.js'
6
+ import { whereSchema } from '../../../utils/whereSchema.js'
7
+
8
+ const DEFAULT_DESCRIPTION =
9
+ 'Count global versions in any version-enabled global by passing the global slug and optional where clause.'
10
+
11
+ export const countGlobalVersionsTool = defineGlobalTool({
12
+ access: (args) =>
13
+ defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.readVersions),
14
+ annotations: {
15
+ destructiveHint: false,
16
+ idempotentHint: true,
17
+ openWorldHint: false,
18
+ readOnlyHint: true,
19
+ title: 'Count Global Versions',
20
+ },
21
+ description: DEFAULT_DESCRIPTION,
22
+ input: z.object({
23
+ locale: z.string().describe('Optional: locale code to count versions in').optional(),
24
+ where: whereSchema
25
+ .describe(
26
+ 'Optional: where clause for filtering versions. Version document fields are usually under "version". Example: {"version.siteName":{"contains":"test"}}',
27
+ )
28
+ .optional(),
29
+ }),
30
+ }).handler(async ({ authorizedMCP, globalSlug, input, req }) => {
31
+ const payload = req.payload
32
+ const logger = getLogger({ payload })
33
+ const { locale, where } = input
34
+
35
+ logger.info(`Counting versions for global: ${globalSlug}`)
36
+
37
+ try {
38
+ const result = await payload.countGlobalVersions({
39
+ global: globalSlug,
40
+ overrideAccess: authorizedMCP.overrideAccess,
41
+ req,
42
+ ...(locale ? { locale } : {}),
43
+ ...(where ? { where } : {}),
44
+ })
45
+
46
+ return {
47
+ content: [
48
+ {
49
+ type: 'text',
50
+ text: `Global "${globalSlug}" contains ${result.totalDocs} matching versions.\n\`\`\`json\n${JSON.stringify(result)}\n\`\`\``,
51
+ },
52
+ ],
53
+ doc: result,
54
+ }
55
+ } catch (error) {
56
+ const errorMessage = error instanceof Error ? error.message : 'Unknown error'
57
+ logger.error(`Error counting versions for global ${globalSlug}: ${errorMessage}`)
58
+ return {
59
+ content: [
60
+ {
61
+ type: 'text',
62
+ text: `❌ **Error counting versions for global "${globalSlug}":** ${errorMessage}`,
63
+ },
64
+ ],
65
+ isError: true,
66
+ }
67
+ }
68
+ })
@@ -2,13 +2,15 @@ import type { PopulateType, SelectType } from 'payload'
2
2
 
3
3
  import { z } from 'zod'
4
4
 
5
+ import { defaultAccess } from '../../../defaultAccess.js'
5
6
  import { defineGlobalTool } from '../../../defineTool.js'
6
7
  import { getLogger } from '../../../utils/getLogger.js'
7
- import { localAPIDefaults } from '../../../utils/localAPIDefaults.js'
8
8
 
9
9
  const DEFAULT_DESCRIPTION = 'Find any Payload global by passing the global slug.'
10
10
 
11
11
  export const findGlobalTool = defineGlobalTool({
12
+ access: (args) =>
13
+ defaultAccess(args) && Boolean(args.permissions?.globals?.[args.globalSlug]?.read),
12
14
  annotations: {
13
15
  destructiveHint: false,
14
16
  idempotentHint: true,
@@ -63,7 +65,8 @@ export const findGlobalTool = defineGlobalTool({
63
65
  const findOptions: Parameters<typeof payload.findGlobal>[0] = {
64
66
  slug: globalSlug,
65
67
  depth,
66
- ...localAPIDefaults(authorizedMCP),
68
+ overrideAccess: authorizedMCP.overrideAccess,
69
+ req,
67
70
  }
68
71
 
69
72
  if (locale) {