@payloadcms/plugin-mcp 4.0.0-internal.688c4d0 → 4.0.0-internal.6e89a16

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 (495) 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 +12 -5
  9. package/dist/endpoint/access.d.ts.map +1 -1
  10. package/dist/endpoint/access.js +74 -103
  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 +96 -16
  15. package/dist/endpoint/index.js.map +1 -1
  16. package/dist/exports/client.d.ts +1 -4
  17. package/dist/exports/client.d.ts.map +1 -1
  18. package/dist/exports/client.js +1 -4
  19. package/dist/exports/client.js.map +1 -1
  20. package/dist/exports/internal.d.ts +2 -0
  21. package/dist/exports/internal.d.ts.map +1 -0
  22. package/dist/exports/internal.js +3 -0
  23. package/dist/exports/internal.js.map +1 -0
  24. package/dist/index.d.ts +2 -2
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +3 -51
  27. package/dist/index.js.map +1 -1
  28. package/dist/mcp/buildMcpServer.d.ts +6 -6
  29. package/dist/mcp/buildMcpServer.d.ts.map +1 -1
  30. package/dist/mcp/buildMcpServer.js +70 -34
  31. package/dist/mcp/buildMcpServer.js.map +1 -1
  32. package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -1
  33. package/dist/mcp/builtin/collections/authTools.js +123 -61
  34. package/dist/mcp/builtin/collections/authTools.js.map +1 -1
  35. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  36. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  37. package/dist/mcp/builtin/collections/countTool.js +63 -0
  38. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  39. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  40. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  41. package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
  42. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  43. package/dist/mcp/builtin/collections/createTool.d.ts +1 -1
  44. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -1
  45. package/dist/mcp/builtin/collections/createTool.js +109 -66
  46. package/dist/mcp/builtin/collections/createTool.js.map +1 -1
  47. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -1
  48. package/dist/mcp/builtin/collections/deleteTool.js +53 -44
  49. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -1
  50. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  51. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  52. package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
  53. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  54. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  55. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  56. package/dist/mcp/builtin/collections/fileInput.js +88 -0
  57. package/dist/mcp/builtin/collections/fileInput.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 +77 -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 +58 -56
  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 +74 -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 +84 -0
  72. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  73. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -1
  74. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +78 -10
  75. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -1
  76. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  77. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  78. package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
  79. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  80. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -1
  81. package/dist/mcp/builtin/collections/updateTool.js +75 -102
  82. package/dist/mcp/builtin/collections/updateTool.js.map +1 -1
  83. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  84. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  85. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  86. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  87. package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
  88. package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
  89. package/dist/mcp/builtin/formatEntityError.js +55 -0
  90. package/dist/mcp/builtin/formatEntityError.js.map +1 -0
  91. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -1
  92. package/dist/mcp/builtin/getConfigInfoTool.js +30 -10
  93. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -1
  94. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  95. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  96. package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
  97. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  98. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -1
  99. package/dist/mcp/builtin/globals/findTool.js +26 -35
  100. package/dist/mcp/builtin/globals/findTool.js.map +1 -1
  101. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  102. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  103. package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
  104. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  105. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  106. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  107. package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
  108. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  109. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -1
  110. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +56 -10
  111. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -1
  112. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  113. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  114. package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
  115. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  116. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -1
  117. package/dist/mcp/builtin/globals/updateTool.js +38 -54
  118. package/dist/mcp/builtin/globals/updateTool.js.map +1 -1
  119. package/dist/mcp/builtinTools.d.ts +75 -12
  120. package/dist/mcp/builtinTools.d.ts.map +1 -1
  121. package/dist/mcp/builtinTools.js +75 -13
  122. package/dist/mcp/builtinTools.js.map +1 -1
  123. package/dist/mcp/sanitizeMCPConfig.d.ts +0 -1
  124. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -1
  125. package/dist/mcp/sanitizeMCPConfig.js +72 -27
  126. package/dist/mcp/sanitizeMCPConfig.js.map +1 -1
  127. package/dist/stdio.d.ts +3 -3
  128. package/dist/stdio.d.ts.map +1 -1
  129. package/dist/stdio.js +86 -47
  130. package/dist/stdio.js.map +1 -1
  131. package/dist/types.d.ts +111 -96
  132. package/dist/types.d.ts.map +1 -1
  133. package/dist/types.js +2 -4
  134. package/dist/types.js.map +1 -1
  135. package/dist/utils/camelCase.d.ts.map +1 -1
  136. package/dist/utils/getPluginConfig.d.ts +1 -1
  137. package/dist/utils/getPluginConfig.js +1 -1
  138. package/dist/utils/getPluginConfig.js.map +1 -1
  139. package/dist/utils/resolveProjectRoot.d.ts.map +1 -1
  140. package/dist/utils/toStandardSchema.d.ts.map +1 -1
  141. package/dist/utils/toStandardSchema.js.map +1 -1
  142. package/package.json +27 -38
  143. package/src/defaultAccess.ts +3 -0
  144. package/src/endpoint/access.ts +79 -112
  145. package/src/endpoint/index.ts +87 -15
  146. package/src/exports/client.ts +2 -4
  147. package/src/exports/internal.ts +1 -0
  148. package/src/index.ts +6 -60
  149. package/src/mcp/buildMcpServer.ts +88 -51
  150. package/src/mcp/builtin/collections/authTools.ts +124 -77
  151. package/src/mcp/builtin/collections/countTool.ts +61 -0
  152. package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
  153. package/src/mcp/builtin/collections/createTool.ts +113 -82
  154. package/src/mcp/builtin/collections/deleteTool.ts +46 -65
  155. package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
  156. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  157. package/src/mcp/builtin/collections/fileInput.ts +127 -0
  158. package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
  159. package/src/mcp/builtin/collections/findTool.ts +54 -97
  160. package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
  161. package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
  162. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +70 -7
  163. package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
  164. package/src/mcp/builtin/collections/updateTool.ts +72 -110
  165. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  166. package/src/mcp/builtin/formatEntityError.ts +77 -0
  167. package/src/mcp/builtin/getConfigInfoTool.ts +29 -5
  168. package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
  169. package/src/mcp/builtin/globals/findTool.ts +27 -57
  170. package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
  171. package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
  172. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +52 -7
  173. package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
  174. package/src/mcp/builtin/globals/updateTool.ts +49 -72
  175. package/src/mcp/builtinTools.ts +81 -18
  176. package/src/mcp/sanitizeMCPConfig.ts +51 -30
  177. package/src/stdio.ts +80 -47
  178. package/src/types.ts +121 -100
  179. package/src/utils/getPluginConfig.ts +1 -1
  180. package/src/utils/toStandardSchema.ts +1 -1
  181. package/dist/@types/assets.d.js +0 -2
  182. package/dist/@types/assets.d.js.map +0 -1
  183. package/dist/collection/getAccessField.d.ts +0 -12
  184. package/dist/collection/getAccessField.d.ts.map +0 -1
  185. package/dist/collection/getAccessField.js +0 -72
  186. package/dist/collection/getAccessField.js.map +0 -1
  187. package/dist/collection/index.d.ts +0 -6
  188. package/dist/collection/index.d.ts.map +0 -1
  189. package/dist/collection/index.js +0 -105
  190. package/dist/collection/index.js.map +0 -1
  191. package/dist/components/APIKeyField/index.client.d.ts +0 -9
  192. package/dist/components/APIKeyField/index.client.d.ts.map +0 -1
  193. package/dist/components/APIKeyField/index.client.js +0 -85
  194. package/dist/components/APIKeyField/index.client.js.map +0 -1
  195. package/dist/components/APIKeyField/index.css +0 -105
  196. package/dist/components/APIKeysEmptyState/index.client.d.ts +0 -4
  197. package/dist/components/APIKeysEmptyState/index.client.d.ts.map +0 -1
  198. package/dist/components/APIKeysEmptyState/index.client.js +0 -21
  199. package/dist/components/APIKeysEmptyState/index.client.js.map +0 -1
  200. package/dist/components/AccessField/index.client.d.ts +0 -10
  201. package/dist/components/AccessField/index.client.d.ts.map +0 -1
  202. package/dist/components/AccessField/index.client.js +0 -247
  203. package/dist/components/AccessField/index.client.js.map +0 -1
  204. package/dist/components/AccessField/index.css +0 -99
  205. package/dist/components/SettingsMenu/index.client.d.ts +0 -8
  206. package/dist/components/SettingsMenu/index.client.d.ts.map +0 -1
  207. package/dist/components/SettingsMenu/index.client.js +0 -29
  208. package/dist/components/SettingsMenu/index.client.js.map +0 -1
  209. package/dist/mcp/builtin/collections/formatCollectionError.d.ts +0 -9
  210. package/dist/mcp/builtin/collections/formatCollectionError.d.ts.map +0 -1
  211. package/dist/mcp/builtin/collections/formatCollectionError.js +0 -60
  212. package/dist/mcp/builtin/collections/formatCollectionError.js.map +0 -1
  213. package/dist/mcp/builtin/validateEntityData.d.ts +0 -14
  214. package/dist/mcp/builtin/validateEntityData.d.ts.map +0 -1
  215. package/dist/mcp/builtin/validateEntityData.js +0 -82
  216. package/dist/mcp/builtin/validateEntityData.js.map +0 -1
  217. package/dist/translations/index.d.ts +0 -11
  218. package/dist/translations/index.d.ts.map +0 -1
  219. package/dist/translations/index.js +0 -92
  220. package/dist/translations/index.js.map +0 -1
  221. package/dist/translations/languages/ar.d.ts +0 -31
  222. package/dist/translations/languages/ar.d.ts.map +0 -1
  223. package/dist/translations/languages/ar.js +0 -34
  224. package/dist/translations/languages/ar.js.map +0 -1
  225. package/dist/translations/languages/az.d.ts +0 -31
  226. package/dist/translations/languages/az.d.ts.map +0 -1
  227. package/dist/translations/languages/az.js +0 -34
  228. package/dist/translations/languages/az.js.map +0 -1
  229. package/dist/translations/languages/bg.d.ts +0 -31
  230. package/dist/translations/languages/bg.d.ts.map +0 -1
  231. package/dist/translations/languages/bg.js +0 -34
  232. package/dist/translations/languages/bg.js.map +0 -1
  233. package/dist/translations/languages/bnBd.d.ts +0 -31
  234. package/dist/translations/languages/bnBd.d.ts.map +0 -1
  235. package/dist/translations/languages/bnBd.js +0 -34
  236. package/dist/translations/languages/bnBd.js.map +0 -1
  237. package/dist/translations/languages/bnIn.d.ts +0 -31
  238. package/dist/translations/languages/bnIn.d.ts.map +0 -1
  239. package/dist/translations/languages/bnIn.js +0 -34
  240. package/dist/translations/languages/bnIn.js.map +0 -1
  241. package/dist/translations/languages/ca.d.ts +0 -31
  242. package/dist/translations/languages/ca.d.ts.map +0 -1
  243. package/dist/translations/languages/ca.js +0 -34
  244. package/dist/translations/languages/ca.js.map +0 -1
  245. package/dist/translations/languages/cs.d.ts +0 -31
  246. package/dist/translations/languages/cs.d.ts.map +0 -1
  247. package/dist/translations/languages/cs.js +0 -34
  248. package/dist/translations/languages/cs.js.map +0 -1
  249. package/dist/translations/languages/da.d.ts +0 -31
  250. package/dist/translations/languages/da.d.ts.map +0 -1
  251. package/dist/translations/languages/da.js +0 -34
  252. package/dist/translations/languages/da.js.map +0 -1
  253. package/dist/translations/languages/de.d.ts +0 -31
  254. package/dist/translations/languages/de.d.ts.map +0 -1
  255. package/dist/translations/languages/de.js +0 -34
  256. package/dist/translations/languages/de.js.map +0 -1
  257. package/dist/translations/languages/en.d.ts +0 -31
  258. package/dist/translations/languages/en.d.ts.map +0 -1
  259. package/dist/translations/languages/en.js +0 -34
  260. package/dist/translations/languages/en.js.map +0 -1
  261. package/dist/translations/languages/es.d.ts +0 -31
  262. package/dist/translations/languages/es.d.ts.map +0 -1
  263. package/dist/translations/languages/es.js +0 -34
  264. package/dist/translations/languages/es.js.map +0 -1
  265. package/dist/translations/languages/et.d.ts +0 -31
  266. package/dist/translations/languages/et.d.ts.map +0 -1
  267. package/dist/translations/languages/et.js +0 -34
  268. package/dist/translations/languages/et.js.map +0 -1
  269. package/dist/translations/languages/fa.d.ts +0 -31
  270. package/dist/translations/languages/fa.d.ts.map +0 -1
  271. package/dist/translations/languages/fa.js +0 -34
  272. package/dist/translations/languages/fa.js.map +0 -1
  273. package/dist/translations/languages/fr.d.ts +0 -31
  274. package/dist/translations/languages/fr.d.ts.map +0 -1
  275. package/dist/translations/languages/fr.js +0 -34
  276. package/dist/translations/languages/fr.js.map +0 -1
  277. package/dist/translations/languages/he.d.ts +0 -31
  278. package/dist/translations/languages/he.d.ts.map +0 -1
  279. package/dist/translations/languages/he.js +0 -34
  280. package/dist/translations/languages/he.js.map +0 -1
  281. package/dist/translations/languages/hr.d.ts +0 -31
  282. package/dist/translations/languages/hr.d.ts.map +0 -1
  283. package/dist/translations/languages/hr.js +0 -34
  284. package/dist/translations/languages/hr.js.map +0 -1
  285. package/dist/translations/languages/hu.d.ts +0 -31
  286. package/dist/translations/languages/hu.d.ts.map +0 -1
  287. package/dist/translations/languages/hu.js +0 -34
  288. package/dist/translations/languages/hu.js.map +0 -1
  289. package/dist/translations/languages/hy.d.ts +0 -31
  290. package/dist/translations/languages/hy.d.ts.map +0 -1
  291. package/dist/translations/languages/hy.js +0 -34
  292. package/dist/translations/languages/hy.js.map +0 -1
  293. package/dist/translations/languages/id.d.ts +0 -31
  294. package/dist/translations/languages/id.d.ts.map +0 -1
  295. package/dist/translations/languages/id.js +0 -34
  296. package/dist/translations/languages/id.js.map +0 -1
  297. package/dist/translations/languages/is.d.ts +0 -31
  298. package/dist/translations/languages/is.d.ts.map +0 -1
  299. package/dist/translations/languages/is.js +0 -34
  300. package/dist/translations/languages/is.js.map +0 -1
  301. package/dist/translations/languages/it.d.ts +0 -31
  302. package/dist/translations/languages/it.d.ts.map +0 -1
  303. package/dist/translations/languages/it.js +0 -34
  304. package/dist/translations/languages/it.js.map +0 -1
  305. package/dist/translations/languages/ja.d.ts +0 -31
  306. package/dist/translations/languages/ja.d.ts.map +0 -1
  307. package/dist/translations/languages/ja.js +0 -34
  308. package/dist/translations/languages/ja.js.map +0 -1
  309. package/dist/translations/languages/ko.d.ts +0 -31
  310. package/dist/translations/languages/ko.d.ts.map +0 -1
  311. package/dist/translations/languages/ko.js +0 -34
  312. package/dist/translations/languages/ko.js.map +0 -1
  313. package/dist/translations/languages/lt.d.ts +0 -31
  314. package/dist/translations/languages/lt.d.ts.map +0 -1
  315. package/dist/translations/languages/lt.js +0 -34
  316. package/dist/translations/languages/lt.js.map +0 -1
  317. package/dist/translations/languages/lv.d.ts +0 -31
  318. package/dist/translations/languages/lv.d.ts.map +0 -1
  319. package/dist/translations/languages/lv.js +0 -34
  320. package/dist/translations/languages/lv.js.map +0 -1
  321. package/dist/translations/languages/my.d.ts +0 -31
  322. package/dist/translations/languages/my.d.ts.map +0 -1
  323. package/dist/translations/languages/my.js +0 -34
  324. package/dist/translations/languages/my.js.map +0 -1
  325. package/dist/translations/languages/nb.d.ts +0 -31
  326. package/dist/translations/languages/nb.d.ts.map +0 -1
  327. package/dist/translations/languages/nb.js +0 -34
  328. package/dist/translations/languages/nb.js.map +0 -1
  329. package/dist/translations/languages/nl.d.ts +0 -31
  330. package/dist/translations/languages/nl.d.ts.map +0 -1
  331. package/dist/translations/languages/nl.js +0 -34
  332. package/dist/translations/languages/nl.js.map +0 -1
  333. package/dist/translations/languages/pl.d.ts +0 -31
  334. package/dist/translations/languages/pl.d.ts.map +0 -1
  335. package/dist/translations/languages/pl.js +0 -34
  336. package/dist/translations/languages/pl.js.map +0 -1
  337. package/dist/translations/languages/pt.d.ts +0 -31
  338. package/dist/translations/languages/pt.d.ts.map +0 -1
  339. package/dist/translations/languages/pt.js +0 -34
  340. package/dist/translations/languages/pt.js.map +0 -1
  341. package/dist/translations/languages/ro.d.ts +0 -31
  342. package/dist/translations/languages/ro.d.ts.map +0 -1
  343. package/dist/translations/languages/ro.js +0 -34
  344. package/dist/translations/languages/ro.js.map +0 -1
  345. package/dist/translations/languages/rs.d.ts +0 -31
  346. package/dist/translations/languages/rs.d.ts.map +0 -1
  347. package/dist/translations/languages/rs.js +0 -34
  348. package/dist/translations/languages/rs.js.map +0 -1
  349. package/dist/translations/languages/rsLatin.d.ts +0 -31
  350. package/dist/translations/languages/rsLatin.d.ts.map +0 -1
  351. package/dist/translations/languages/rsLatin.js +0 -34
  352. package/dist/translations/languages/rsLatin.js.map +0 -1
  353. package/dist/translations/languages/ru.d.ts +0 -31
  354. package/dist/translations/languages/ru.d.ts.map +0 -1
  355. package/dist/translations/languages/ru.js +0 -34
  356. package/dist/translations/languages/ru.js.map +0 -1
  357. package/dist/translations/languages/sk.d.ts +0 -31
  358. package/dist/translations/languages/sk.d.ts.map +0 -1
  359. package/dist/translations/languages/sk.js +0 -34
  360. package/dist/translations/languages/sk.js.map +0 -1
  361. package/dist/translations/languages/sl.d.ts +0 -31
  362. package/dist/translations/languages/sl.d.ts.map +0 -1
  363. package/dist/translations/languages/sl.js +0 -34
  364. package/dist/translations/languages/sl.js.map +0 -1
  365. package/dist/translations/languages/sv.d.ts +0 -31
  366. package/dist/translations/languages/sv.d.ts.map +0 -1
  367. package/dist/translations/languages/sv.js +0 -34
  368. package/dist/translations/languages/sv.js.map +0 -1
  369. package/dist/translations/languages/ta.d.ts +0 -31
  370. package/dist/translations/languages/ta.d.ts.map +0 -1
  371. package/dist/translations/languages/ta.js +0 -34
  372. package/dist/translations/languages/ta.js.map +0 -1
  373. package/dist/translations/languages/th.d.ts +0 -31
  374. package/dist/translations/languages/th.d.ts.map +0 -1
  375. package/dist/translations/languages/th.js +0 -34
  376. package/dist/translations/languages/th.js.map +0 -1
  377. package/dist/translations/languages/tr.d.ts +0 -31
  378. package/dist/translations/languages/tr.d.ts.map +0 -1
  379. package/dist/translations/languages/tr.js +0 -34
  380. package/dist/translations/languages/tr.js.map +0 -1
  381. package/dist/translations/languages/uk.d.ts +0 -31
  382. package/dist/translations/languages/uk.d.ts.map +0 -1
  383. package/dist/translations/languages/uk.js +0 -34
  384. package/dist/translations/languages/uk.js.map +0 -1
  385. package/dist/translations/languages/vi.d.ts +0 -31
  386. package/dist/translations/languages/vi.d.ts.map +0 -1
  387. package/dist/translations/languages/vi.js +0 -34
  388. package/dist/translations/languages/vi.js.map +0 -1
  389. package/dist/translations/languages/zh.d.ts +0 -31
  390. package/dist/translations/languages/zh.d.ts.map +0 -1
  391. package/dist/translations/languages/zh.js +0 -34
  392. package/dist/translations/languages/zh.js.map +0 -1
  393. package/dist/translations/languages/zhTw.d.ts +0 -31
  394. package/dist/translations/languages/zhTw.d.ts.map +0 -1
  395. package/dist/translations/languages/zhTw.js +0 -34
  396. package/dist/translations/languages/zhTw.js.map +0 -1
  397. package/dist/translations/types.d.ts +0 -32
  398. package/dist/translations/types.d.ts.map +0 -1
  399. package/dist/translations/types.js +0 -3
  400. package/dist/translations/types.js.map +0 -1
  401. package/dist/utils/getVirtualFieldNames.d.ts +0 -14
  402. package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
  403. package/dist/utils/getVirtualFieldNames.js +0 -35
  404. package/dist/utils/getVirtualFieldNames.js.map +0 -1
  405. package/dist/utils/localAPIDefaults.d.ts +0 -20
  406. package/dist/utils/localAPIDefaults.d.ts.map +0 -1
  407. package/dist/utils/localAPIDefaults.js +0 -19
  408. package/dist/utils/localAPIDefaults.js.map +0 -1
  409. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts +0 -11
  410. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts.map +0 -1
  411. package/dist/utils/schemaConversion/getEntityInputSchema.js +0 -34
  412. package/dist/utils/schemaConversion/getEntityInputSchema.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/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts +0 -15
  418. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts.map +0 -1
  419. package/dist/utils/schemaConversion/sanitizeEntitySchema.js +0 -464
  420. package/dist/utils/schemaConversion/sanitizeEntitySchema.js.map +0 -1
  421. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js +0 -158
  422. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js.map +0 -1
  423. package/dist/utils/transformPointDataToPayload.d.ts +0 -7
  424. package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
  425. package/dist/utils/transformPointDataToPayload.js +0 -28
  426. package/dist/utils/transformPointDataToPayload.js.map +0 -1
  427. package/dist/utils/whereSchema.d.ts +0 -9
  428. package/dist/utils/whereSchema.d.ts.map +0 -1
  429. package/dist/utils/whereSchema.js +0 -13
  430. package/dist/utils/whereSchema.js.map +0 -1
  431. package/src/@types/assets.d.ts +0 -3
  432. package/src/collection/getAccessField.ts +0 -84
  433. package/src/collection/index.ts +0 -105
  434. package/src/components/APIKeyField/index.client.tsx +0 -73
  435. package/src/components/APIKeyField/index.css +0 -105
  436. package/src/components/APIKeysEmptyState/index.client.tsx +0 -36
  437. package/src/components/AccessField/index.client.tsx +0 -299
  438. package/src/components/AccessField/index.css +0 -99
  439. package/src/components/SettingsMenu/index.client.tsx +0 -34
  440. package/src/mcp/builtin/collections/formatCollectionError.ts +0 -84
  441. package/src/mcp/builtin/validateEntityData.ts +0 -132
  442. package/src/translations/index.ts +0 -108
  443. package/src/translations/languages/ar.ts +0 -35
  444. package/src/translations/languages/az.ts +0 -35
  445. package/src/translations/languages/bg.ts +0 -35
  446. package/src/translations/languages/bnBd.ts +0 -35
  447. package/src/translations/languages/bnIn.ts +0 -35
  448. package/src/translations/languages/ca.ts +0 -35
  449. package/src/translations/languages/cs.ts +0 -35
  450. package/src/translations/languages/da.ts +0 -35
  451. package/src/translations/languages/de.ts +0 -35
  452. package/src/translations/languages/en.ts +0 -35
  453. package/src/translations/languages/es.ts +0 -35
  454. package/src/translations/languages/et.ts +0 -35
  455. package/src/translations/languages/fa.ts +0 -35
  456. package/src/translations/languages/fr.ts +0 -35
  457. package/src/translations/languages/he.ts +0 -35
  458. package/src/translations/languages/hr.ts +0 -35
  459. package/src/translations/languages/hu.ts +0 -35
  460. package/src/translations/languages/hy.ts +0 -35
  461. package/src/translations/languages/id.ts +0 -35
  462. package/src/translations/languages/is.ts +0 -35
  463. package/src/translations/languages/it.ts +0 -35
  464. package/src/translations/languages/ja.ts +0 -35
  465. package/src/translations/languages/ko.ts +0 -35
  466. package/src/translations/languages/lt.ts +0 -35
  467. package/src/translations/languages/lv.ts +0 -35
  468. package/src/translations/languages/my.ts +0 -35
  469. package/src/translations/languages/nb.ts +0 -35
  470. package/src/translations/languages/nl.ts +0 -35
  471. package/src/translations/languages/pl.ts +0 -35
  472. package/src/translations/languages/pt.ts +0 -35
  473. package/src/translations/languages/ro.ts +0 -35
  474. package/src/translations/languages/rs.ts +0 -35
  475. package/src/translations/languages/rsLatin.ts +0 -35
  476. package/src/translations/languages/ru.ts +0 -35
  477. package/src/translations/languages/sk.ts +0 -35
  478. package/src/translations/languages/sl.ts +0 -35
  479. package/src/translations/languages/sv.ts +0 -35
  480. package/src/translations/languages/ta.ts +0 -35
  481. package/src/translations/languages/th.ts +0 -35
  482. package/src/translations/languages/tr.ts +0 -35
  483. package/src/translations/languages/uk.ts +0 -35
  484. package/src/translations/languages/vi.ts +0 -35
  485. package/src/translations/languages/zh.ts +0 -35
  486. package/src/translations/languages/zhTw.ts +0 -35
  487. package/src/translations/types.ts +0 -34
  488. package/src/utils/getVirtualFieldNames.ts +0 -53
  489. package/src/utils/localAPIDefaults.ts +0 -22
  490. package/src/utils/schemaConversion/getEntityInputSchema.ts +0 -78
  491. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
  492. package/src/utils/schemaConversion/sanitizeEntitySchema.spec.ts +0 -103
  493. package/src/utils/schemaConversion/sanitizeEntitySchema.ts +0 -529
  494. package/src/utils/transformPointDataToPayload.ts +0 -40
  495. package/src/utils/whereSchema.ts +0 -24
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n CallToolResult,\n ContentBlock,\n JsonSchemaType,\n McpServer,\n ResourceTemplate,\n ServerContext,\n StandardSchemaWithJSON,\n} from '@modelcontextprotocol/server'\nimport type {\n AuthCollectionSlug,\n CollectionConfig,\n CollectionSlug,\n DefaultDocumentIDType,\n GlobalSlug,\n MaybePromise,\n PayloadRequest,\n TypedUser,\n} from 'payload'\n\nimport type {\n MCPCollectionAuthToolName,\n MCPCollectionBuiltinName,\n MCPGlobalBuiltinName,\n} from './mcp/builtinTools.js'\n\nexport type { MCPCollectionAuthToolName, MCPCollectionBuiltinName, MCPGlobalBuiltinName }\n\n/** Re-exported from `@modelcontextprotocol/server` — the JSON Schema shape the MCP runtime validates against. */\nexport type { JsonSchemaType, StandardSchemaWithJSON }\n\n/**\n * What a tool's `input` (or a prompt's `argsSchema`) can be — either a raw\n * JSON Schema literal, or a Standard Schema instance (Zod, Valibot, …).\n */\nexport type ToolInputSchema = JsonSchemaType | StandardSchemaWithJSON\n\n/**\n * Serializable mirror of `SanitizedMCPPluginConfig` for client components —\n * the full sanitized config carries functions (tool handlers, etc.) that can't\n * cross the server→client boundary. Built by `sanitizeClientPluginConfig` and\n * passed to the `AccessField` component via `clientProps`.\n *\n * @internal\n */\nexport type ClientMCPPluginConfig = {\n items: Array<{\n collectionSlug?: string\n configKey: string\n description?: string\n globalSlug?: string\n /** Admin-UI bucket for collection/global tools: built-in CRUD, auth, or custom. */\n group?: 'auth' | 'custom' | 'operations'\n label: string\n type: 'collectionTool' | 'globalTool' | 'prompt' | 'resource' | 'tool'\n }>\n}\n\nexport type MCPToolResponse = {\n content: ContentBlock[]\n /**\n * If available, return the document fetched within the\n * mcp tool. This is threaded as an additional argument to\n * overrideResponse functions and stripped before going on the wire.\n */\n doc?: Record<string, unknown>\n} & Pick<CallToolResult, '_meta' | 'isError' | 'structuredContent'>\n\nexport type MCPResponseOverride = (\n response: MCPToolResponse,\n doc: Record<string, unknown>,\n req: PayloadRequest,\n) => MCPToolResponse\n\n/**\n * The handler's `input` type. A specific Standard Schema (Zod, Valibot, …) gets\n * its inferred output; anything else falls back to `Record<string, unknown>`.\n */\nexport type TypedInput<TSchema> = TSchema extends StandardSchemaWithJSON\n ? StandardSchemaWithJSON extends TSchema\n ? Record<string, unknown>\n : StandardSchemaWithJSON.InferOutput<TSchema>\n : Record<string, unknown>\n\nexport type ToolHandlerArgs<TSchema = undefined> = {\n authorizedMCP: AuthorizedMCP\n input: TypedInput<TSchema>\n req: PayloadRequest\n serverContext: ServerContext\n}\n\nexport type CollectionToolHandlerArgs<TSchema = undefined> = {\n collectionSlug: CollectionSlug\n} & ToolHandlerArgs<TSchema>\n\nexport type GlobalToolHandlerArgs<TSchema = undefined> = {\n globalSlug: GlobalSlug\n} & ToolHandlerArgs<TSchema>\n\nexport type Tool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {\n description: string\n handler: (args: ToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n /**\n * Override the return value of the tool handler\n */\n overrideResponse?: MCPResponseOverride\n}\n\nexport type CollectionTool<\n TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined,\n> = {\n handler: (args: CollectionToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n} & Pick<Tool, 'description' | 'overrideResponse'>\n\nexport type GlobalTool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> =\n {\n handler: (args: GlobalToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n } & Pick<Tool, 'description' | 'overrideResponse'>\n\n/**\n * Configures (or disables) a built-in tool without replacing it.\n * `handler?: never` prevents a full `CollectionTool`/`GlobalTool` (which has a\n * required handler) from being silently accepted at a built-in key slot.\n */\nexport type MCPBuiltInToolOverride = {\n description?: string\n handler?: never\n overrideResponse?: MCPResponseOverride\n}\n\n/**\n * Value at a custom (non-built-in) tool key. Either the tool itself, or `false`\n * to disable it (useful when one plugin defines a custom tool and another\n * wants to opt out per-collection).\n */\nexport type MCPTopLevelToolEntry = Tool\n\nexport type MCPCollectionToolsMap = {\n [customToolName: string]: boolean | CollectionTool | MCPBuiltInToolOverride | undefined\n} & {\n [K in MCPCollectionBuiltinName]?: false | MCPBuiltInToolOverride\n}\n\nexport type MCPAuthCollectionToolsMap = {\n [K in MCPCollectionAuthToolName]?: MCPBuiltInToolOverride | true\n} & MCPCollectionToolsMap\n\n/** Auth-enabled collections get auth-tool name autocomplete; others get CRUD-only. */\nexport type MCPToolsMapForCollection<Slug extends CollectionSlug> = Slug extends AuthCollectionSlug\n ? MCPAuthCollectionToolsMap\n : MCPCollectionToolsMap\n\nexport type MCPGlobalToolsMap = {\n [customToolName: string]: boolean | GlobalTool | MCPBuiltInToolOverride | undefined\n} & {\n [K in MCPGlobalBuiltinName]?: false | MCPBuiltInToolOverride\n}\n\nexport type MCPTopLevelToolsMap = Record<string, Tool>\n\nexport type PromptHandlerArgs<TSchema = undefined> = {\n input: TypedInput<TSchema>\n req: PayloadRequest\n serverContext: ServerContext\n}\n\nexport type Prompt<TSchema extends ToolInputSchema = ToolInputSchema> = {\n argsSchema: TSchema\n description: string\n handler: (args: PromptHandlerArgs<TSchema>) => MaybePromise<{\n messages: Array<{ content: { text: string; type: 'text' }; role: 'assistant' | 'user' }>\n }>\n title: string\n}\n\nexport type ResourceHandlerArgs = {\n /** Variables extracted from a `ResourceTemplate` URI. Empty for static-URI resources. */\n params: Record<string, string>\n req: PayloadRequest\n serverContext: ServerContext\n uri: URL\n}\n\nexport type Resource = {\n description: string\n handler: (args: ResourceHandlerArgs) => MaybePromise<{\n contents: Array<{ text: string; uri: string }>\n }>\n mimeType: string\n title: string\n uri: ResourceTemplate | string\n}\n\nexport type MCPPluginCollectionConfig<TSlug extends CollectionSlug> = {\n description?: string\n /** Fallback for built-in tools that don't set their own `overrideResponse`. */\n overrideResponse?: MCPResponseOverride\n tools?: MCPToolsMapForCollection<TSlug>\n}\n\nexport type MCPPluginGlobalConfig = {\n description?: string\n overrideResponse?: MCPResponseOverride\n tools?: MCPGlobalToolsMap\n}\n\n/**\n * The user-facing config shape passed to `mcpPlugin({ ... })`. Tools, prompts,\n * resources, and per-collection/global tool maps live in their own nested\n * fields. `sanitizeMCPConfig` flattens those into `items` and applies defaults\n * to produce a `SanitizedMCPPluginConfig` — the form every internal consumer\n * actually works with.\n */\nexport type MCPPluginConfig = {\n collections?: {\n [Slug in CollectionSlug]?: MCPPluginCollectionConfig<Slug>\n }\n /** Skip MCP registration. The API key collection is still added (so DB / types stay stable). */\n disabled?: boolean\n globals?: {\n [Slug in GlobalSlug]?: MCPPluginGlobalConfig\n }\n mcp?: {\n serverOptions?: MCPServerOptions\n verboseLogs?: boolean\n }\n overrideApiKeyCollection?: (collection: CollectionConfig) => CollectionConfig\n /** Replace the default API-key auth with a custom resolver. */\n overrideAuth?: (args: {\n getAPIKeyDoc: (overrideApiKey?: string) => Promise<MCPAPIKeysDoc>\n getAuthorizedMCP: (args: { apiKeyDoc: MCPAPIKeysDoc }) => AuthorizedMCP\n pluginConfig: SanitizedMCPPluginConfig\n req: PayloadRequest\n }) => MaybePromise<AuthorizedMCP>\n prompts?: Record<string, Prompt>\n resources?: Record<string, Resource>\n /** Cross-cutting tools (not scoped to any collection or global). */\n tools?: MCPTopLevelToolsMap\n userCollection?: CollectionSlug\n}\n\nexport type SanitizedMCPPluginConfig = {\n items: MCPItem[]\n userCollection: CollectionSlug\n} & Pick<MCPPluginConfig, 'disabled' | 'mcp' | 'overrideApiKeyCollection' | 'overrideAuth'>\n\nexport type MCPServerOptions = {\n options?: ConstructorParameters<typeof McpServer>[1]\n serverInfo?: Partial<ConstructorParameters<typeof McpServer>[0]>\n}\n\n/**\n * Nested access tree as stored in the collection.\n * A `false` leaf disables that tool; missing keys defer to\n * defaults (built-in CRUD is on, opt-in tools are off).\n */\nexport type MCPAPIKeysDocAccessTree = {\n collections?: {\n [CollectionSlug: CollectionSlug]: {\n [ToolKey: string]: boolean\n }\n }\n globals?: {\n [GlobalSlug: GlobalSlug]: {\n [ToolKey: string]: boolean\n }\n }\n prompts?: {\n [PromptKey: string]: boolean\n }\n resources?: {\n [ResourceKey: string]: boolean\n }\n tools?: {\n [ToolKey: string]: boolean\n }\n}\n\n/**\n * Stored on `payload-mcp-api-keys` docs\n */\nexport type MCPAPIKeysDoc = {\n access: MCPAPIKeysDocAccessTree\n apiKey?: string\n apiKeyIndex?: string\n id: DefaultDocumentIDType\n lastUsed?: string\n overrideAccess?: boolean\n user: null | TypedUser\n}\n\n/**\n * One MCP primitive plus the metadata needed for access checks, admin UI, and\n * registration.\n *\n * - `configKey`: the config/API-key identifier, e.g. `find` or `echo`.\n * - `mcpName`: the MCP wire name, e.g. `findDocuments` or `echo`.\n * - `label`: human-readable admin checkbox text.\n */\nexport type MCPItemBase = {\n configKey: string\n label: string\n mcpName: string\n}\n\nexport type CollectionMCPItem = {\n collectionSlug: CollectionSlug\n tool: CollectionTool\n type: 'collectionTool'\n} & MCPItemBase\n\nexport type GlobalMCPItem = {\n globalSlug: GlobalSlug\n tool: GlobalTool\n type: 'globalTool'\n} & MCPItemBase\n\nexport type MCPItem =\n | ({\n prompt: Prompt\n type: 'prompt'\n } & MCPItemBase)\n | ({\n resource: Resource\n type: 'resource'\n } & MCPItemBase)\n | ({\n tool: Tool\n type: 'tool'\n } & MCPItemBase)\n | CollectionMCPItem\n | GlobalMCPItem\n\n/**\n * The caller's identity + the MCP items they can use for this request. Returned\n * by `getAuthorizedMCP`; denied items are simply absent from `items`. Handlers\n * receive this via `args.authorizedMCP` so they can spread\n * `localAPIDefaults(authorizedMCP)` into every local API call.\n */\nexport type AuthorizedMCP = {\n items: MCPItem[]\n overrideAccess: boolean\n user: null | TypedUser\n}\n"],"names":[],"mappings":"AAgVA;;;;;CAKC,GACD,WAIC"}
1
+ {"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n CallToolResult,\n ContentBlock,\n Implementation,\n JsonSchemaType,\n McpServerOptions,\n ResourceTemplate,\n ServerContext,\n StandardSchemaWithJSON,\n ToolAnnotations,\n} from '@modelcontextprotocol/server'\nimport type {\n AuthCollectionSlug,\n CollectionSlug,\n GlobalSlug,\n MaybePromise,\n PayloadRequest,\n SanitizedPermissions,\n} from 'payload'\n\nimport type { GetAuthorizedMCPArgs } from './endpoint/access.js'\nimport type {\n MCPCollectionAuthToolName,\n MCPCollectionBuiltinName,\n MCPGlobalBuiltinName,\n} from './mcp/builtinTools.js'\n\nexport type { MCPCollectionAuthToolName, MCPCollectionBuiltinName, MCPGlobalBuiltinName }\n\n/** Re-exported from `@modelcontextprotocol/server` — common MCP types used in plugin config. */\nexport type { JsonSchemaType, StandardSchemaWithJSON, ToolAnnotations }\n\n/**\n * What a tool's `input` (or a prompt's `argsSchema`) can be — either a raw\n * JSON Schema 2020-12 literal, or a Standard Schema instance (Zod, Valibot, …).\n * Raw schemas may omit `$schema`; when present it must declare the 2020-12 dialect.\n */\nexport type ToolInputSchema = JsonSchemaType | StandardSchemaWithJSON\n\nexport type MCPToolResponse = {\n content: ContentBlock[]\n /**\n * If available, return the document fetched within the\n * mcp tool. This is threaded as an additional argument to\n * overrideResponse functions and stripped before going on the wire.\n */\n doc?: Record<string, unknown>\n} & Pick<CallToolResult, '_meta' | 'isError' | 'structuredContent'>\n\nexport type MCPResponseOverride = (\n response: MCPToolResponse,\n doc: Record<string, unknown>,\n req: PayloadRequest,\n) => MCPToolResponse\n\nexport type MCPAfterToolCallHook = (args: {\n input: unknown\n req: PayloadRequest\n response: MCPToolResponse\n toolName: string\n}) => MaybePromise<MCPToolResponse>\n\n/**\n * The handler's `input` type. A specific Standard Schema (Zod, Valibot, …) gets\n * its inferred output; anything else falls back to `Record<string, unknown>`.\n */\nexport type TypedInput<TSchema> = TSchema extends StandardSchemaWithJSON\n ? StandardSchemaWithJSON extends TSchema\n ? Record<string, unknown>\n : StandardSchemaWithJSON.InferOutput<TSchema>\n : Record<string, unknown>\n\nexport type MCPAccessArgs = {\n permissions?: SanitizedPermissions\n req: PayloadRequest\n}\n\nexport type CollectionMCPAccessArgs = {\n slug: CollectionSlug\n} & MCPAccessArgs\n\nexport type GlobalMCPAccessArgs = {\n slug: GlobalSlug\n} & MCPAccessArgs\n\nexport type ToolHandlerArgs<TSchema = undefined> = {\n authorizedMCP: AuthorizedMCP\n input: TypedInput<TSchema>\n req: PayloadRequest\n serverContext: ServerContext\n}\n\nexport type CollectionToolHandlerArgs<TSchema = undefined> = {\n slug: CollectionSlug\n} & ToolHandlerArgs<TSchema>\n\nexport type GlobalToolHandlerArgs<TSchema = undefined> = {\n slug: GlobalSlug\n} & ToolHandlerArgs<TSchema>\n\nexport type Tool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {\n /**\n * Runs while authorizing each MCP request, before the tool is advertised or called. Return\n * `false` to make the tool unavailable for that request. This is skipped when `overrideAccess`\n * is enabled.\n */\n access?: (args: MCPAccessArgs) => MaybePromise<boolean>\n annotations?: ToolAnnotations\n description: string\n handler: (args: ToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n /**\n * Override the return value of the tool handler\n */\n overrideResponse?: MCPResponseOverride\n}\n\nexport type CollectionTool<\n TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined,\n> = {\n /**\n * Runs while authorizing each MCP request for this collection. Return `false` to reject calls\n * to this tool for the collection. The shared tool is not advertised when no collections allow\n * it, but can remain advertised when it is available for another collection. This is skipped\n * when `overrideAccess` is enabled.\n */\n access?: (args: CollectionMCPAccessArgs) => MaybePromise<boolean>\n handler: (args: CollectionToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n} & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>\n\nexport type GlobalTool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> =\n {\n /**\n * Runs while authorizing each MCP request for this global. Return `false` to reject calls to\n * this tool for the global. The shared tool is not advertised when no globals allow it, but\n * can remain advertised when it is available for another global. This is skipped when\n * `overrideAccess` is enabled.\n */\n access?: (args: GlobalMCPAccessArgs) => MaybePromise<boolean>\n handler: (args: GlobalToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>\n input?: TSchema\n } & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>\n\n/**\n * Configures (or disables) a built-in tool without replacing it.\n * `handler?: never` prevents a full `CollectionTool`/`GlobalTool` (which has a\n * required handler) from being silently accepted at a built-in key slot.\n */\nexport type MCPBuiltInCollectionToolOverride = {\n /**\n * Replaces the built-in tool's access check. Return `false` to make the tool unavailable for\n * this collection. This is skipped when `overrideAccess` is enabled.\n */\n access?: (args: CollectionMCPAccessArgs) => MaybePromise<boolean>\n annotations?: ToolAnnotations\n description?: string\n handler?: never\n overrideResponse?: MCPResponseOverride\n}\n\nexport type MCPBuiltInGlobalToolOverride = {\n /**\n * Replaces the built-in tool's access check. Return `false` to make the tool unavailable for\n * this global. This is skipped when `overrideAccess` is enabled.\n */\n access?: (args: GlobalMCPAccessArgs) => MaybePromise<boolean>\n annotations?: ToolAnnotations\n description?: string\n handler?: never\n overrideResponse?: MCPResponseOverride\n}\n\n/**\n * Value at a custom (non-built-in) tool key. Either the tool itself, or `false`\n * to disable it (useful when one plugin defines a custom tool and another\n * wants to opt out per-collection).\n */\nexport type MCPTopLevelToolEntry = Tool\n\nexport type MCPCollectionToolsMap = {\n [customToolName: string]: boolean | CollectionTool | MCPBuiltInCollectionToolOverride | undefined\n} & {\n [K in MCPCollectionBuiltinName]?: false | MCPBuiltInCollectionToolOverride\n}\n\nexport type MCPAuthCollectionToolsMap = {\n [K in MCPCollectionAuthToolName]?: MCPBuiltInCollectionToolOverride | true\n} & MCPCollectionToolsMap\n\n/** Auth-enabled collections get auth-tool name autocomplete; others get CRUD-only. */\nexport type MCPToolsMapForCollection<Slug extends CollectionSlug> = Slug extends AuthCollectionSlug\n ? MCPAuthCollectionToolsMap\n : MCPCollectionToolsMap\n\nexport type MCPGlobalToolsMap = {\n [customToolName: string]: boolean | GlobalTool | MCPBuiltInGlobalToolOverride | undefined\n} & {\n [K in MCPGlobalBuiltinName]?: false | MCPBuiltInGlobalToolOverride\n}\n\nexport type MCPTopLevelToolsMap = Record<string, Tool>\n\nexport type PromptHandlerArgs<TSchema = undefined> = {\n input: TypedInput<TSchema>\n req: PayloadRequest\n serverContext: ServerContext\n}\n\nexport type Prompt<TSchema extends ToolInputSchema = ToolInputSchema> = {\n /**\n * Runs while authorizing each MCP request, before the prompt is advertised or used. Return\n * `false` to make the prompt unavailable for that request. This is skipped when\n * `overrideAccess` is enabled.\n */\n access?: (args: MCPAccessArgs) => MaybePromise<boolean>\n argsSchema: TSchema\n description: string\n handler: (args: PromptHandlerArgs<TSchema>) => MaybePromise<{\n messages: Array<{ content: { text: string; type: 'text' }; role: 'assistant' | 'user' }>\n }>\n title: string\n}\n\nexport type ResourceHandlerArgs = {\n /** Variables extracted from a `ResourceTemplate` URI. Empty for static-URI resources. */\n params: Record<string, string>\n req: PayloadRequest\n serverContext: ServerContext\n uri: URL\n}\n\nexport type Resource = {\n /**\n * Runs while authorizing each MCP request, before the resource is advertised or read. Return\n * `false` to make the resource unavailable for that request. This is skipped when\n * `overrideAccess` is enabled.\n */\n access?: (args: MCPAccessArgs) => MaybePromise<boolean>\n description: string\n handler: (args: ResourceHandlerArgs) => MaybePromise<{\n contents: Array<{ text: string; uri: string }>\n }>\n mimeType: string\n title: string\n uri: ResourceTemplate | string\n}\n\nexport type MCPPluginCollectionConfig<TSlug extends CollectionSlug> = {\n description?: string\n /** Fallback for built-in tools that don't set their own `overrideResponse`. */\n overrideResponse?: MCPResponseOverride\n tools?: MCPToolsMapForCollection<TSlug>\n}\n\nexport type MCPPluginGlobalConfig = {\n description?: string\n overrideResponse?: MCPResponseOverride\n tools?: MCPGlobalToolsMap\n}\n\n/**\n * The user-facing config shape passed to `mcpPlugin({ ... })`. Tools, prompts,\n * resources, and per-collection/global tool maps live in their own nested\n * fields. `sanitizeMCPConfig` flattens those into `items` and applies defaults\n * to produce a `SanitizedMCPPluginConfig` — the form every internal consumer\n * actually works with.\n */\nexport type MCPPluginConfig = {\n collections?: {\n [Slug in CollectionSlug]?: MCPPluginCollectionConfig<Slug>\n }\n /** Skip MCP endpoint registration. */\n disabled?: boolean\n globals?: {\n [Slug in GlobalSlug]?: MCPPluginGlobalConfig\n }\n hooks?: {\n /** Transform a tool response after its handler returns */\n afterToolCall?: MCPAfterToolCallHook[]\n }\n mcp?: {\n /**\n * Largest HTTP request body, in bytes, that the MCP endpoint accepts. Larger requests\n * are answered with `413`. Base64 file uploads count toward this limit.\n *\n * @default 4194304 (4 MiB, the MCP SDK default)\n */\n maxRequestBodySize?: number\n serverOptions?: MCPServerOptions\n verboseLogs?: boolean\n }\n /**\n * Replace the default MCP authorization resolver.\n *\n * This hook replaces the default authentication flow. It must set `req.user` to the\n * authenticated Payload user, or to `null` for an anonymous caller, before returning.\n */\n overrideGetAuthorizedMCP?: (\n args: {\n pluginConfig: SanitizedMCPPluginConfig\n } & GetAuthorizedMCPArgs,\n ) => MaybePromise<AuthorizedMCP>\n prompts?: Record<string, Prompt>\n resources?: Record<string, Resource>\n /** Cross-cutting tools (not scoped to any collection or global). */\n tools?: MCPTopLevelToolsMap\n}\n\nexport type SanitizedMCPPluginConfig = {\n items: MCPItem[]\n} & Pick<MCPPluginConfig, 'disabled' | 'hooks' | 'mcp' | 'overrideGetAuthorizedMCP'>\n\nexport type MCPServerOptions = {\n options?: McpServerOptions\n serverInfo?: Partial<Implementation>\n}\n\n/**\n * One MCP primitive plus the metadata needed for config-driven filtering and\n * registration.\n *\n * - `configKey`: the config identifier, e.g. `find` or `echo`.\n * - `mcpName`: the MCP wire name, e.g. `findDocuments` or `echo`.\n * - `label`: human-readable display text.\n */\nexport type MCPItemBase = {\n configKey: string\n label: string\n mcpName: string\n}\n\nexport type CollectionMCPItem = {\n collectionSlug: CollectionSlug\n tool: CollectionTool\n type: 'collectionTool'\n} & MCPItemBase\n\nexport type GlobalMCPItem = {\n globalSlug: GlobalSlug\n tool: GlobalTool\n type: 'globalTool'\n} & MCPItemBase\n\nexport type MCPItem =\n | ({\n prompt: Prompt\n type: 'prompt'\n } & MCPItemBase)\n | ({\n resource: Resource\n type: 'resource'\n } & MCPItemBase)\n | ({\n tool: Tool\n type: 'tool'\n } & MCPItemBase)\n | CollectionMCPItem\n | GlobalMCPItem\n\n/**\n * The MCP items and access mode authorized for this request. The authenticated user is available\n * as `req.user`.\n */\nexport type AuthorizedMCP = {\n items: MCPItem[]\n overrideAccess: boolean\n}\n"],"names":[],"mappings":"AAwWA;;;CAGC,GACD,WAGC"}
@@ -1 +1 @@
1
- {"version":3,"file":"camelCase.d.ts","sourceRoot":"","sources":["../../src/utils/camelCase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAIzC,CAAA"}
1
+ {"version":3,"file":"camelCase.d.ts","sourceRoot":"","sources":["../../src/utils/camelCase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MAIzC,CAAA"}
@@ -3,7 +3,7 @@ import type { SanitizedMCPPluginConfig } from '../types.js';
3
3
  /**
4
4
  * Returns the sanitized plugin config — the form produced by
5
5
  * `sanitizeMCPConfig` and stashed back on the plugin's `options` during init.
6
- * Callers downstream of plugin init can rely on `items`, `userCollection`, etc.
6
+ * Callers downstream of plugin init can rely on `items` and other defaults
7
7
  * being fully resolved.
8
8
  */
9
9
  export declare const getPluginConfig: (args: {
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Returns the sanitized plugin config — the form produced by
3
3
  * `sanitizeMCPConfig` and stashed back on the plugin's `options` during init.
4
- * Callers downstream of plugin init can rely on `items`, `userCollection`, etc.
4
+ * Callers downstream of plugin init can rely on `items` and other defaults
5
5
  * being fully resolved.
6
6
  */ export const getPluginConfig = ({ config })=>{
7
7
  const plugin = config.plugins?.find((plugin)=>plugin.slug === '@payloadcms/plugin-mcp');
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/getPluginConfig.ts"],"sourcesContent":["import type { PluginsMap, SanitizedConfig } from 'payload'\n\nimport type { SanitizedMCPPluginConfig } from '../types.js'\n\n/**\n * Returns the sanitized plugin config — the form produced by\n * `sanitizeMCPConfig` and stashed back on the plugin's `options` during init.\n * Callers downstream of plugin init can rely on `items`, `userCollection`, etc.\n * being fully resolved.\n */\nexport const getPluginConfig: (args: { config: SanitizedConfig }) => SanitizedMCPPluginConfig = ({\n config,\n}) => {\n const plugin = config.plugins?.find(\n (plugin) => plugin.slug === '@payloadcms/plugin-mcp',\n ) as PluginsMap['@payloadcms/plugin-mcp']\n\n if (!plugin) {\n throw new Error('MCP Plugin not found in config.plugins.')\n }\n\n // @ts-expect-error\n return plugin.sanitizedOptions\n}\n"],"names":["getPluginConfig","config","plugin","plugins","find","slug","Error","sanitizedOptions"],"mappings":"AAIA;;;;;CAKC,GACD,OAAO,MAAMA,kBAAmF,CAAC,EAC/FC,MAAM,EACP;IACC,MAAMC,SAASD,OAAOE,OAAO,EAAEC,KAC7B,CAACF,SAAWA,OAAOG,IAAI,KAAK;IAG9B,IAAI,CAACH,QAAQ;QACX,MAAM,IAAII,MAAM;IAClB;IAEA,mBAAmB;IACnB,OAAOJ,OAAOK,gBAAgB;AAChC,EAAC"}
1
+ {"version":3,"sources":["../../src/utils/getPluginConfig.ts"],"sourcesContent":["import type { PluginsMap, SanitizedConfig } from 'payload'\n\nimport type { SanitizedMCPPluginConfig } from '../types.js'\n\n/**\n * Returns the sanitized plugin config — the form produced by\n * `sanitizeMCPConfig` and stashed back on the plugin's `options` during init.\n * Callers downstream of plugin init can rely on `items` and other defaults\n * being fully resolved.\n */\nexport const getPluginConfig: (args: { config: SanitizedConfig }) => SanitizedMCPPluginConfig = ({\n config,\n}) => {\n const plugin = config.plugins?.find(\n (plugin) => plugin.slug === '@payloadcms/plugin-mcp',\n ) as PluginsMap['@payloadcms/plugin-mcp']\n\n if (!plugin) {\n throw new Error('MCP Plugin not found in config.plugins.')\n }\n\n // @ts-expect-error\n return plugin.sanitizedOptions\n}\n"],"names":["getPluginConfig","config","plugin","plugins","find","slug","Error","sanitizedOptions"],"mappings":"AAIA;;;;;CAKC,GACD,OAAO,MAAMA,kBAAmF,CAAC,EAC/FC,MAAM,EACP;IACC,MAAMC,SAASD,OAAOE,OAAO,EAAEC,KAC7B,CAACF,SAAWA,OAAOG,IAAI,KAAK;IAG9B,IAAI,CAACH,QAAQ;QACX,MAAM,IAAII,MAAM;IAClB;IAEA,mBAAmB;IACnB,OAAOJ,OAAOK,gBAAgB;AAChC,EAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"resolveProjectRoot.d.ts","sourceRoot":"","sources":["../../src/utils/resolveProjectRoot.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,IAAI,GAAG,MAS5D,CAAA"}
1
+ {"version":3,"file":"resolveProjectRoot.d.ts","sourceRoot":"","sources":["../../src/utils/resolveProjectRoot.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAc,MAAM,KAAG,IAAI,GAAG,MAS5D,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"toStandardSchema.d.ts","sourceRoot":"","sources":["../../src/utils/toStandardSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAE1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,gIAAgI;AAChI,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,KAAG,sBAG/B,CAAA"}
1
+ {"version":3,"file":"toStandardSchema.d.ts","sourceRoot":"","sources":["../../src/utils/toStandardSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAE1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,gIAAgI;AAChI,eAAO,MAAM,gBAAgB,WAAY,eAAe,KAAG,sBAG/B,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/utils/toStandardSchema.ts"],"sourcesContent":["import { fromJsonSchema, type StandardSchemaWithJSON } from '@modelcontextprotocol/server'\n\nimport type { ToolInputSchema } from '../types.js'\n\n/** Normalize a tool/prompt input to a Standard Schema. Raw JSON Schema gets wrapped; Standard Schema instances pass through. */\nexport const toStandardSchema = (schema: ToolInputSchema): StandardSchemaWithJSON =>\n typeof schema === 'object' && schema !== null && '~standard' in schema\n ? (schema as StandardSchemaWithJSON)\n : fromJsonSchema(schema)\n"],"names":["fromJsonSchema","toStandardSchema","schema"],"mappings":"AAAA,SAASA,cAAc,QAAqC,+BAA8B;AAI1F,8HAA8H,GAC9H,OAAO,MAAMC,mBAAmB,CAACC,SAC/B,OAAOA,WAAW,YAAYA,WAAW,QAAQ,eAAeA,SAC3DA,SACDF,eAAeE,QAAO"}
1
+ {"version":3,"sources":["../../src/utils/toStandardSchema.ts"],"sourcesContent":["import { fromJsonSchema, type StandardSchemaWithJSON } from '@modelcontextprotocol/server'\n\nimport type { ToolInputSchema } from '../types.js'\n\n/** Normalize a tool/prompt input to a Standard Schema. Raw JSON Schema gets wrapped; Standard Schema instances pass through. */\nexport const toStandardSchema = (schema: ToolInputSchema): StandardSchemaWithJSON =>\n typeof schema === 'object' && schema !== null && '~standard' in schema\n ? schema\n : fromJsonSchema(schema)\n"],"names":["fromJsonSchema","toStandardSchema","schema"],"mappings":"AAAA,SAASA,cAAc,QAAqC,+BAA8B;AAI1F,8HAA8H,GAC9H,OAAO,MAAMC,mBAAmB,CAACC,SAC/B,OAAOA,WAAW,YAAYA,WAAW,QAAQ,eAAeA,SAC5DA,SACAF,eAAeE,QAAO"}
package/package.json CHANGED
@@ -1,17 +1,12 @@
1
1
  {
2
2
  "name": "@payloadcms/plugin-mcp",
3
- "version": "4.0.0-internal.688c4d0",
3
+ "version": "4.0.0-internal.6e89a16",
4
4
  "description": "MCP (Model Context Protocol) capabilities with Payload",
5
5
  "keywords": [
6
- "plugin",
7
6
  "mcp",
8
- "model context protocol"
7
+ "model context protocol",
8
+ "plugin"
9
9
  ],
10
- "repository": {
11
- "type": "git",
12
- "url": "https://github.com/payloadcms/payload.git",
13
- "directory": "packages/plugin-mcp"
14
- },
15
10
  "license": "MIT",
16
11
  "author": "Payload <dev@payloadcms.com> (https://payloadcms.com)",
17
12
  "maintainers": [
@@ -21,10 +16,22 @@
21
16
  "url": "https://payloadcms.com"
22
17
  }
23
18
  ],
24
- "sideEffects": [
25
- "*.css"
19
+ "repository": {
20
+ "type": "git",
21
+ "url": "https://github.com/payloadcms/payload.git",
22
+ "directory": "packages/plugin-mcp"
23
+ },
24
+ "bin": {
25
+ "payload-mcp": "./bin.js"
26
+ },
27
+ "files": [
28
+ "src",
29
+ "dist",
30
+ "bin.js"
26
31
  ],
27
32
  "type": "module",
33
+ "main": "./dist/index.js",
34
+ "types": "./dist/index.d.ts",
28
35
  "exports": {
29
36
  ".": {
30
37
  "import": "./dist/index.js",
@@ -40,40 +47,24 @@
40
47
  "import": "./dist/stdio.js",
41
48
  "types": "./dist/stdio.d.ts",
42
49
  "default": "./dist/stdio.js"
50
+ },
51
+ "./internal": {
52
+ "import": "./dist/exports/internal.js",
53
+ "types": "./dist/exports/internal.d.ts",
54
+ "default": "./dist/exports/internal.js"
43
55
  }
44
56
  },
45
- "main": "./dist/index.js",
46
- "types": "./dist/index.d.ts",
47
- "bin": {
48
- "payload-mcp": "./bin.js"
49
- },
50
- "files": [
51
- "src",
52
- "dist",
53
- "bin.js"
54
- ],
55
57
  "dependencies": {
56
- "@cfworker/json-schema": "^4.1.1",
57
- "@modelcontextprotocol/server": "2.0.0-alpha.2",
58
- "tsx": "4.22.4",
59
- "zod": "^4.0.0",
60
- "@payloadcms/translations": "4.0.0-internal.688c4d0"
58
+ "@modelcontextprotocol/server": "2.4.0",
59
+ "tsx": "4.23.15"
61
60
  },
62
61
  "devDependencies": {
63
- "@types/react": "19.2.14",
64
- "react": "^19.0.1 || ^19.1.2 || ^19.2.1",
65
- "payload": "4.0.0-internal.688c4d0",
66
- "@payloadcms/eslint-config": "3.28.0",
67
- "@payloadcms/ui": "4.0.0-internal.688c4d0"
62
+ "payload": "4.0.0-internal.6e89a16"
68
63
  },
69
64
  "peerDependencies": {
70
- "react": "^19.0.1 || ^19.1.2 || ^19.2.1",
71
- "@payloadcms/ui": "4.0.0-internal.688c4d0",
72
- "payload": "4.0.0-internal.688c4d0"
65
+ "payload": "4.0.0-internal.6e89a16"
73
66
  },
74
67
  "//deps_notes": {
75
- "zod": "zod is a hard dependency of @modelcontextprotocol/server, thus we can safely use it without it impacting bundle size. Make extra sure the zod version here matches exactly what's defined in the dependencies of @modelcontextprotocol/server to avoid duplicate versions being installed.",
76
- "@cfworker/json-schema": "Should be able to remove in next @modelcontextprotocol/server alpha release. Marked as an optional peer of @modelcontextprotocol/server, but its bundle does an eager top-level `import { Validator } from '@cfworker/json-schema'`, so it must be installed even when only zod-registered tools are used. Drop once upstream lazy-loads the validator. See: https://github.com/modelcontextprotocol/typescript-sdk",
77
68
  "tsx": "Required by the `bin.js` stdio mcp. Keep the version pinned to whatever `payload` ships to avoid duplicate installs."
78
69
  },
79
70
  "homepage:": "https://payloadcms.com",
@@ -83,9 +74,7 @@
83
74
  "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
84
75
  "build:types": "tsc --emitDeclarationOnly --outDir dist",
85
76
  "clean": "rimraf {dist,*.tsbuildinfo}",
86
- "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
87
- "lint": "eslint .",
88
- "lint:fix": "eslint . --fix",
77
+ "copyfiles": "copyfiles -u 1 -e \"**/*.spec.*\" \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
89
78
  "pack:plugin": "pnpm build && pnpm pack"
90
79
  }
91
80
  }
@@ -0,0 +1,3 @@
1
+ import type { MCPAccessArgs } from './types.js'
2
+
3
+ export const defaultAccess = ({ req }: MCPAccessArgs): boolean => Boolean(req.user)
@@ -1,144 +1,111 @@
1
- import type { DefaultDocumentIDType, PayloadRequest, TypedUser } from 'payload'
1
+ import type { PayloadRequest, SanitizedPermissions } from 'payload'
2
2
 
3
- import crypto from 'crypto'
4
- import { UnauthorizedError } from 'payload'
3
+ import { getAccessResults, UnauthorizedError } from 'payload'
5
4
 
6
- import type { AuthorizedMCP, MCPAPIKeysDoc } from '../types.js'
5
+ import type { AuthorizedMCP, MCPItem } from '../types.js'
7
6
 
8
- import { getLogger } from '../utils/getLogger.js'
9
7
  import { getPluginConfig } from '../utils/getPluginConfig.js'
10
8
 
9
+ export type GetAuthorizedMCPArgs = {
10
+ overrideAccess: boolean
11
+ req: PayloadRequest
12
+ }
13
+
11
14
  /**
12
- * Resolves the API key (or dev-mode session) and returns the items the caller
13
- * may use. Denied items are dropped from the array.
15
+ * Authenticates an MCP request and removes items the user cannot access.
16
+ * `overrideAccess` skips Payload and MCP item access checks.
14
17
  */
15
- export const getAuthorizedMCP: (args: { req: PayloadRequest }) => Promise<AuthorizedMCP> = async ({
18
+ export const getAuthorizedMCP: (args: GetAuthorizedMCPArgs) => Promise<AuthorizedMCP> = async ({
19
+ overrideAccess,
16
20
  req,
17
21
  }) => {
18
- const logger = getLogger({ payload: req.payload })
19
22
  const pluginConfig = getPluginConfig({ config: req.payload.config })
20
23
 
21
- const authHeader = req.headers.get('Authorization')
22
- const hasBearerToken = authHeader?.startsWith('Bearer ')
23
-
24
- const buildAuthorized = (apiKeyDoc: MCPAPIKeysDoc): AuthorizedMCP => ({
25
- items: pluginConfig.items.filter((item) => {
26
- switch (item.type) {
27
- case 'collectionTool':
28
- return apiKeyDoc.access.collections?.[item.collectionSlug]?.[item.configKey] !== false
29
- case 'globalTool':
30
- return apiKeyDoc.access.globals?.[item.globalSlug]?.[item.configKey] !== false
31
- case 'prompt':
32
- return apiKeyDoc.access.prompts?.[item.configKey] !== false
33
- case 'resource':
34
- return apiKeyDoc.access.resources?.[item.configKey] !== false
35
- case 'tool':
36
- return apiKeyDoc.access.tools?.[item.configKey] !== false
37
- }
38
- }),
39
- overrideAccess:
40
- typeof apiKeyDoc.overrideAccess === 'boolean' ? apiKeyDoc.overrideAccess : false,
41
- user: apiKeyDoc.user,
42
- })
43
-
44
- if (pluginConfig.overrideAuth) {
45
- return await pluginConfig.overrideAuth({
46
- getAPIKeyDoc: (overrideApiKey) => getAPIKeyDoc({ logger, overrideApiKey, pluginConfig, req }),
47
- getAuthorizedMCP: ({ apiKeyDoc }) => buildAuthorized(apiKeyDoc),
24
+ if (pluginConfig.overrideGetAuthorizedMCP) {
25
+ return await pluginConfig.overrideGetAuthorizedMCP({
26
+ overrideAccess,
48
27
  pluginConfig,
49
28
  req,
50
29
  })
51
30
  }
52
31
 
53
- if (process.env.NODE_ENV === 'development' && !hasBearerToken) {
54
- logger.info('Dev mode: skipping API key check, using session user')
55
- return buildAuthorized({
56
- id: -1,
57
- access: {},
58
- overrideAccess: true,
59
- user: req.user ?? null,
60
- })
32
+ if (req.headers) {
33
+ const headers = new Headers(req.headers)
34
+ const hasAuthorization = headers.has('Authorization')
35
+
36
+ headers.set('DisableAutologin', 'true')
37
+ req.user = (await req.payload.auth({ headers, req })).user
38
+
39
+ if (hasAuthorization && !req.user) {
40
+ throw new UnauthorizedError(req.t)
41
+ }
61
42
  }
62
43
 
63
- return buildAuthorized(await getAPIKeyDoc({ logger, pluginConfig, req }))
44
+ return {
45
+ items: await filterMCPItems({
46
+ items: pluginConfig.items,
47
+ overrideAccess,
48
+ req,
49
+ }),
50
+ overrideAccess,
51
+ }
64
52
  }
65
53
 
66
- const getAPIKeyDoc = async ({
67
- logger,
68
- overrideApiKey,
69
- pluginConfig,
54
+ export const filterMCPItems = async ({
55
+ items,
56
+ overrideAccess,
70
57
  req,
71
58
  }: {
72
- logger: ReturnType<typeof getLogger>
73
- overrideApiKey?: string
74
- pluginConfig: ReturnType<typeof getPluginConfig>
59
+ items: MCPItem[]
60
+ overrideAccess: boolean
75
61
  req: PayloadRequest
76
- }): Promise<MCPAPIKeysDoc> => {
77
- const authHeader = req.headers.get('Authorization')
78
- const hasBearerToken = authHeader?.startsWith('Bearer ')
79
-
80
- const apiKey =
81
- overrideApiKey ?? (hasBearerToken ? authHeader?.replace('Bearer ', '').trim() || null : null)
82
-
83
- if (!apiKey) {
84
- throw new UnauthorizedError()
62
+ }): Promise<MCPItem[]> => {
63
+ // Match Payload core: overrideAccess bypasses access evaluation
64
+ if (overrideAccess) {
65
+ return items
85
66
  }
86
67
 
87
- const sha256APIKeyIndex = crypto
88
- .createHmac('sha256', req.payload.secret)
89
- .update(apiKey)
90
- .digest('hex')
91
-
92
- const doc = await req.payload.db.findOne<MCPAPIKeysDoc>({
93
- collection: 'payload-mcp-api-keys',
94
- req,
95
- where: {
96
- apiKeyIndex: { equals: sha256APIKeyIndex },
97
- },
98
- })
99
-
100
- if (!doc || !doc.user) {
101
- throw new UnauthorizedError()
102
- }
103
-
104
- logger.info('API Key is valid')
68
+ const authorizedItems: MCPItem[] = []
105
69
 
106
- const userRef = doc.user
107
- const userID =
108
- typeof userRef === 'object' && userRef !== null && 'id' in userRef
109
- ? userRef.id
110
- : (userRef as unknown as DefaultDocumentIDType)
70
+ const permissions = await getAccessResults({ req })
111
71
 
112
- const user = (await req.payload.findByID({
113
- id: userID,
114
- collection: pluginConfig.userCollection,
115
- depth: 0,
116
- disableErrors: true,
117
- req,
118
- })) as null | TypedUser
119
-
120
- if (!user) {
121
- throw new UnauthorizedError()
72
+ for (const item of items) {
73
+ if (!(await checkItemAccess({ item, permissions, req }))) {
74
+ continue
75
+ }
76
+ authorizedItems.push(item)
122
77
  }
123
78
 
124
- try {
125
- await req.payload.db.updateOne({
126
- id: doc.id,
127
- collection: 'payload-mcp-api-keys',
128
- data: { lastUsed: new Date().toISOString() },
129
- req,
130
- returning: false,
131
- })
132
- } catch (err) {
133
- logger.warn({ err, msg: 'Failed to update MCP API key last-used timestamp' })
134
- }
79
+ return authorizedItems
80
+ }
135
81
 
136
- return {
137
- ...doc,
138
- user: {
139
- ...user,
140
- _strategy: 'mcp-api-key' as const,
141
- collection: pluginConfig.userCollection,
142
- },
82
+ /**
83
+ * Runs MCP item access callbacks
84
+ */
85
+ const checkItemAccess = async ({
86
+ item,
87
+ permissions,
88
+ req,
89
+ }: {
90
+ item: MCPItem
91
+ permissions?: SanitizedPermissions
92
+ req: PayloadRequest
93
+ }): Promise<boolean> => {
94
+ switch (item.type) {
95
+ case 'collectionTool':
96
+ return (
97
+ !item.tool.access ||
98
+ (await item.tool.access({ slug: item.collectionSlug, permissions, req }))
99
+ )
100
+ case 'globalTool':
101
+ return (
102
+ !item.tool.access || (await item.tool.access({ slug: item.globalSlug, permissions, req }))
103
+ )
104
+ case 'prompt':
105
+ return !item.prompt.access || (await item.prompt.access({ permissions, req }))
106
+ case 'resource':
107
+ return !item.resource.access || (await item.resource.access({ permissions, req }))
108
+ case 'tool':
109
+ return !item.tool.access || (await item.tool.access({ permissions, req }))
143
110
  }
144
111
  }
@@ -1,5 +1,12 @@
1
- import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/server'
2
- import { APIError, type PayloadHandler } from 'payload'
1
+ import type { PayloadHandler, PayloadRequest } from 'payload'
2
+
3
+ import {
4
+ createMcpHandler,
5
+ isLegacyRequest,
6
+ readRequestBody,
7
+ WebStandardStreamableHTTPServerTransport,
8
+ } from '@modelcontextprotocol/server'
9
+ import { APIError } from 'payload'
3
10
 
4
11
  import { buildMcpServer } from '../mcp/buildMcpServer.js'
5
12
  import { getPluginConfig } from '../utils/getPluginConfig.js'
@@ -13,23 +20,88 @@ export const mcpEndpoint: PayloadHandler = async (req) => {
13
20
  req.payloadAPI = 'MCP' as const
14
21
 
15
22
  const pluginConfig = getPluginConfig({ config: req.payload.config })
16
- const authorizedMCP = await getAuthorizedMCP({ req })
23
+ const overrideAccessParam = new URL(req.url).searchParams.get('overrideAccess')
24
+
25
+ if (overrideAccessParam !== null && process.env.NODE_ENV !== 'development') {
26
+ throw new APIError('MCP overrideAccess is only available in development.', 400)
27
+ }
28
+
29
+ let overrideAccess = false
30
+ if (overrideAccessParam === 'true') {
31
+ overrideAccess = true
32
+ } else if (overrideAccessParam !== null && overrideAccessParam !== 'false') {
33
+ throw new APIError('MCP overrideAccess must be "true" or "false".', 400)
34
+ }
35
+
36
+ const authorizedMCP = await getAuthorizedMCP({ overrideAccess, req })
37
+ const maxRequestBodySize = pluginConfig.mcp?.maxRequestBodySize
38
+ // Payload augments the original web-standard Request in place.
39
+ const mcpRequest = req as PayloadRequest & Request
40
+ const parsedBody = await parseRequestBody({ maxRequestBodySize, request: mcpRequest })
17
41
 
18
- const server = buildMcpServer({ authorizedMCP, pluginConfig, req })
42
+ // Keep the old JSON-only, stateless behavior because the SDK's 2025 fallback uses SSE.
43
+ if (await isLegacyRequest(mcpRequest, parsedBody, { maxRequestBodySize })) {
44
+ const server = buildMcpServer({ authorizedMCP, pluginConfig, req })
45
+ const transport = new WebStandardStreamableHTTPServerTransport({
46
+ enableJsonResponse: true,
47
+ maxRequestBodySize,
48
+ sessionIdGenerator: undefined, // stateless mode
49
+ })
50
+ transport.onerror = (err) => {
51
+ req.payload.logger.error({ err, msg: 'Error serving legacy MCP request' })
52
+ }
19
53
 
20
- const transport = new WebStandardStreamableHTTPServerTransport({
21
- enableJsonResponse: true,
22
- sessionIdGenerator: undefined, // stateless mode
54
+ try {
55
+ await server.connect(transport)
56
+ return await transport.handleRequest(mcpRequest, { parsedBody })
57
+ } finally {
58
+ await server.close().catch((err) => {
59
+ req.payload.logger.error({ err, msg: 'Error closing MCP server' })
60
+ })
61
+ }
62
+ }
63
+
64
+ const handler = createMcpHandler(() => buildMcpServer({ authorizedMCP, pluginConfig, req }), {
65
+ legacy: 'reject',
66
+ maxRequestBodySize,
67
+ // SDK subscriptions always use SSE, so disable them to keep every response JSON-only.
68
+ maxSubscriptions: 0,
69
+ onerror: (err) => {
70
+ req.payload.logger.error({ err, msg: 'Error serving modern MCP request' })
71
+ },
72
+ responseMode: 'json',
23
73
  })
24
74
 
25
- await server.connect(transport)
75
+ try {
76
+ return await handler.fetch(mcpRequest, { parsedBody })
77
+ } finally {
78
+ await handler.close().catch((err) => {
79
+ req.payload.logger.error({ err, msg: 'Error closing modern MCP handler' })
80
+ })
81
+ }
82
+ }
26
83
 
27
- const mcpRequest = new Request(req.url, {
28
- body: req.body,
29
- duplex: 'half',
30
- headers: req.headers,
31
- method: req.method,
32
- } as { duplex: 'half' } & RequestInit)
84
+ /**
85
+ * Parses a POST body once so the era check and the SDK handler can share it. The SDK
86
+ * skips its size limit for a pre-parsed body, so this reads with the same limit. It reads
87
+ * a clone and returns `undefined` for any body the SDK should reject (too large, unreadable,
88
+ * or not JSON), leaving the original request for the SDK to read and answer.
89
+ */
90
+ const parseRequestBody = async ({
91
+ maxRequestBodySize,
92
+ request,
93
+ }: {
94
+ maxRequestBodySize?: number
95
+ request: Request
96
+ }): Promise<unknown> => {
97
+ if (request.method.toUpperCase() !== 'POST') {
98
+ return undefined
99
+ }
33
100
 
34
- return await transport.handleRequest(mcpRequest)
101
+ try {
102
+ const body = await readRequestBody(request.clone(), maxRequestBodySize)
103
+ return body.tooLarge ? undefined : JSON.parse(body.text)
104
+ } catch {
105
+ return undefined
106
+ }
35
107
  }
@@ -1,5 +1,3 @@
1
1
  'use client'
2
- export { AccessField } from '../components/AccessField/index.client.js'
3
- export { APIKeyField } from '../components/APIKeyField/index.client.js'
4
- export { APIKeysEmptyState } from '../components/APIKeysEmptyState/index.client.js'
5
- export { MCPSettingsMenu } from '../components/SettingsMenu/index.client.js'
2
+
3
+ export {}
@@ -0,0 +1 @@
1
+ export { filterMCPItems, getAuthorizedMCP } from '../endpoint/access.js'