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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/LICENSE.md +1 -1
  2. package/dist/defaultAccess.d.ts +3 -0
  3. package/dist/defaultAccess.d.ts.map +1 -0
  4. package/dist/defaultAccess.js +3 -0
  5. package/dist/defaultAccess.js.map +1 -0
  6. package/dist/defineTool.d.ts +8 -8
  7. package/dist/defineTool.d.ts.map +1 -1
  8. package/dist/endpoint/access.d.ts +29 -6
  9. package/dist/endpoint/access.d.ts.map +1 -1
  10. package/dist/endpoint/access.js +133 -100
  11. package/dist/endpoint/access.js.map +1 -1
  12. package/dist/endpoint/index.d.ts +1 -1
  13. package/dist/endpoint/index.d.ts.map +1 -1
  14. package/dist/endpoint/index.js +121 -16
  15. package/dist/endpoint/index.js.map +1 -1
  16. package/dist/endpoint/oauth.d.ts +37 -0
  17. package/dist/endpoint/oauth.d.ts.map +1 -0
  18. package/dist/endpoint/oauth.js +105 -0
  19. package/dist/endpoint/oauth.js.map +1 -0
  20. package/dist/endpoint/oauthLoginToken.d.ts +27 -0
  21. package/dist/endpoint/oauthLoginToken.d.ts.map +1 -0
  22. package/dist/endpoint/oauthLoginToken.js +86 -0
  23. package/dist/endpoint/oauthLoginToken.js.map +1 -0
  24. package/dist/endpoint/oauthServer.d.ts +28 -0
  25. package/dist/endpoint/oauthServer.d.ts.map +1 -0
  26. package/dist/endpoint/oauthServer.js +455 -0
  27. package/dist/endpoint/oauthServer.js.map +1 -0
  28. package/dist/exports/client.d.ts +1 -4
  29. package/dist/exports/client.d.ts.map +1 -1
  30. package/dist/exports/client.js +1 -4
  31. package/dist/exports/client.js.map +1 -1
  32. package/dist/exports/internal.d.ts +2 -0
  33. package/dist/exports/internal.d.ts.map +1 -0
  34. package/dist/exports/internal.js +3 -0
  35. package/dist/exports/internal.js.map +1 -0
  36. package/dist/exports/rsc.d.ts +2 -0
  37. package/dist/exports/rsc.d.ts.map +1 -0
  38. package/dist/exports/rsc.js +3 -0
  39. package/dist/exports/rsc.js.map +1 -0
  40. package/dist/index.d.ts +12 -4
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +31 -55
  43. package/dist/index.js.map +1 -1
  44. package/dist/mcp/buildMcpServer.d.ts +6 -6
  45. package/dist/mcp/buildMcpServer.d.ts.map +1 -1
  46. package/dist/mcp/buildMcpServer.js +70 -34
  47. package/dist/mcp/buildMcpServer.js.map +1 -1
  48. package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -1
  49. package/dist/mcp/builtin/collections/authTools.js +123 -61
  50. package/dist/mcp/builtin/collections/authTools.js.map +1 -1
  51. package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
  52. package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
  53. package/dist/mcp/builtin/collections/countTool.js +63 -0
  54. package/dist/mcp/builtin/collections/countTool.js.map +1 -0
  55. package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
  56. package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
  57. package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
  58. package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
  59. package/dist/mcp/builtin/collections/createTool.d.ts +1 -1
  60. package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -1
  61. package/dist/mcp/builtin/collections/createTool.js +109 -66
  62. package/dist/mcp/builtin/collections/createTool.js.map +1 -1
  63. package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -1
  64. package/dist/mcp/builtin/collections/deleteTool.js +56 -45
  65. package/dist/mcp/builtin/collections/deleteTool.js.map +1 -1
  66. package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
  67. package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
  68. package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
  69. package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
  70. package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
  71. package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
  72. package/dist/mcp/builtin/collections/fileInput.js +88 -0
  73. package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
  74. package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
  75. package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
  76. package/dist/mcp/builtin/collections/findDistinctTool.js +77 -0
  77. package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
  78. package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -1
  79. package/dist/mcp/builtin/collections/findTool.js +58 -56
  80. package/dist/mcp/builtin/collections/findTool.js.map +1 -1
  81. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
  82. package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
  83. package/dist/mcp/builtin/collections/findVersionByIDTool.js +74 -0
  84. package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
  85. package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
  86. package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
  87. package/dist/mcp/builtin/collections/findVersionsTool.js +84 -0
  88. package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
  89. package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -1
  90. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +78 -10
  91. package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -1
  92. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
  93. package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
  94. package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
  95. package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
  96. package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -1
  97. package/dist/mcp/builtin/collections/updateTool.js +75 -102
  98. package/dist/mcp/builtin/collections/updateTool.js.map +1 -1
  99. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
  100. package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
  101. package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
  102. package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
  103. package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
  104. package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
  105. package/dist/mcp/builtin/formatEntityError.js +55 -0
  106. package/dist/mcp/builtin/formatEntityError.js.map +1 -0
  107. package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -1
  108. package/dist/mcp/builtin/getConfigInfoTool.js +30 -10
  109. package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -1
  110. package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
  111. package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
  112. package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
  113. package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
  114. package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -1
  115. package/dist/mcp/builtin/globals/findTool.js +26 -35
  116. package/dist/mcp/builtin/globals/findTool.js.map +1 -1
  117. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
  118. package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
  119. package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
  120. package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
  121. package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
  122. package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
  123. package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
  124. package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
  125. package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -1
  126. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +56 -10
  127. package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -1
  128. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
  129. package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
  130. package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
  131. package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
  132. package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -1
  133. package/dist/mcp/builtin/globals/updateTool.js +38 -54
  134. package/dist/mcp/builtin/globals/updateTool.js.map +1 -1
  135. package/dist/mcp/builtinTools.d.ts +75 -12
  136. package/dist/mcp/builtinTools.d.ts.map +1 -1
  137. package/dist/mcp/builtinTools.js +75 -13
  138. package/dist/mcp/builtinTools.js.map +1 -1
  139. package/dist/mcp/sanitizeMCPConfig.d.ts +0 -1
  140. package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -1
  141. package/dist/mcp/sanitizeMCPConfig.js +76 -27
  142. package/dist/mcp/sanitizeMCPConfig.js.map +1 -1
  143. package/dist/stdio.d.ts +3 -3
  144. package/dist/stdio.d.ts.map +1 -1
  145. package/dist/stdio.js +86 -47
  146. package/dist/stdio.js.map +1 -1
  147. package/dist/types.d.ts +224 -95
  148. package/dist/types.d.ts.map +1 -1
  149. package/dist/types.js +2 -4
  150. package/dist/types.js.map +1 -1
  151. package/dist/utils/camelCase.d.ts.map +1 -1
  152. package/dist/utils/getPluginConfig.d.ts +1 -1
  153. package/dist/utils/getPluginConfig.js +1 -1
  154. package/dist/utils/getPluginConfig.js.map +1 -1
  155. package/dist/utils/resolveProjectRoot.d.ts.map +1 -1
  156. package/dist/utils/seal.d.ts +17 -0
  157. package/dist/utils/seal.d.ts.map +1 -0
  158. package/dist/utils/seal.js +24 -0
  159. package/dist/utils/seal.js.map +1 -0
  160. package/dist/utils/toStandardSchema.d.ts.map +1 -1
  161. package/dist/utils/toStandardSchema.js.map +1 -1
  162. package/dist/views/Authorize/AllowButtons/index.d.ts +18 -0
  163. package/dist/views/Authorize/AllowButtons/index.d.ts.map +1 -0
  164. package/dist/views/Authorize/AllowButtons/index.js +88 -0
  165. package/dist/views/Authorize/AllowButtons/index.js.map +1 -0
  166. package/dist/views/Authorize/index.css +19 -0
  167. package/dist/views/Authorize/index.d.ts +9 -0
  168. package/dist/views/Authorize/index.d.ts.map +1 -0
  169. package/dist/views/Authorize/index.js +98 -0
  170. package/dist/views/Authorize/index.js.map +1 -0
  171. package/package.json +34 -38
  172. package/src/defaultAccess.ts +3 -0
  173. package/src/endpoint/access.ts +149 -109
  174. package/src/endpoint/index.ts +103 -15
  175. package/src/endpoint/oauth.ts +108 -0
  176. package/src/endpoint/oauthLoginToken.ts +100 -0
  177. package/src/endpoint/oauthServer.ts +472 -0
  178. package/src/exports/client.ts +2 -4
  179. package/src/exports/internal.ts +1 -0
  180. package/src/exports/rsc.ts +1 -0
  181. package/src/index.ts +53 -63
  182. package/src/mcp/buildMcpServer.ts +88 -51
  183. package/src/mcp/builtin/collections/authTools.ts +124 -77
  184. package/src/mcp/builtin/collections/countTool.ts +61 -0
  185. package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
  186. package/src/mcp/builtin/collections/createTool.ts +113 -82
  187. package/src/mcp/builtin/collections/deleteTool.ts +49 -66
  188. package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
  189. package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
  190. package/src/mcp/builtin/collections/fileInput.ts +127 -0
  191. package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
  192. package/src/mcp/builtin/collections/findTool.ts +54 -97
  193. package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
  194. package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
  195. package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +70 -7
  196. package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
  197. package/src/mcp/builtin/collections/updateTool.ts +72 -110
  198. package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
  199. package/src/mcp/builtin/formatEntityError.ts +77 -0
  200. package/src/mcp/builtin/getConfigInfoTool.ts +29 -5
  201. package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
  202. package/src/mcp/builtin/globals/findTool.ts +27 -57
  203. package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
  204. package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
  205. package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +52 -7
  206. package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
  207. package/src/mcp/builtin/globals/updateTool.ts +49 -72
  208. package/src/mcp/builtinTools.ts +81 -18
  209. package/src/mcp/sanitizeMCPConfig.ts +53 -30
  210. package/src/stdio.ts +80 -47
  211. package/src/types.ts +232 -99
  212. package/src/utils/getPluginConfig.ts +1 -1
  213. package/src/utils/seal.ts +46 -0
  214. package/src/utils/toStandardSchema.ts +1 -1
  215. package/src/views/Authorize/AllowButtons/index.tsx +97 -0
  216. package/src/views/Authorize/index.css +19 -0
  217. package/src/views/Authorize/index.tsx +100 -0
  218. package/dist/collection/getAccessField.d.ts +0 -12
  219. package/dist/collection/getAccessField.d.ts.map +0 -1
  220. package/dist/collection/getAccessField.js +0 -72
  221. package/dist/collection/getAccessField.js.map +0 -1
  222. package/dist/collection/index.d.ts +0 -6
  223. package/dist/collection/index.d.ts.map +0 -1
  224. package/dist/collection/index.js +0 -105
  225. package/dist/collection/index.js.map +0 -1
  226. package/dist/components/APIKeyField/index.client.d.ts +0 -9
  227. package/dist/components/APIKeyField/index.client.d.ts.map +0 -1
  228. package/dist/components/APIKeyField/index.client.js +0 -85
  229. package/dist/components/APIKeyField/index.client.js.map +0 -1
  230. package/dist/components/APIKeyField/index.css +0 -105
  231. package/dist/components/APIKeysEmptyState/index.client.d.ts +0 -4
  232. package/dist/components/APIKeysEmptyState/index.client.d.ts.map +0 -1
  233. package/dist/components/APIKeysEmptyState/index.client.js +0 -21
  234. package/dist/components/APIKeysEmptyState/index.client.js.map +0 -1
  235. package/dist/components/AccessField/index.client.d.ts +0 -10
  236. package/dist/components/AccessField/index.client.d.ts.map +0 -1
  237. package/dist/components/AccessField/index.client.js +0 -247
  238. package/dist/components/AccessField/index.client.js.map +0 -1
  239. package/dist/components/AccessField/index.css +0 -99
  240. package/dist/components/SettingsMenu/index.client.d.ts +0 -8
  241. package/dist/components/SettingsMenu/index.client.d.ts.map +0 -1
  242. package/dist/components/SettingsMenu/index.client.js +0 -29
  243. package/dist/components/SettingsMenu/index.client.js.map +0 -1
  244. package/dist/mcp/builtin/collections/formatCollectionError.d.ts +0 -9
  245. package/dist/mcp/builtin/collections/formatCollectionError.d.ts.map +0 -1
  246. package/dist/mcp/builtin/collections/formatCollectionError.js +0 -60
  247. package/dist/mcp/builtin/collections/formatCollectionError.js.map +0 -1
  248. package/dist/mcp/builtin/validateEntityData.d.ts +0 -14
  249. package/dist/mcp/builtin/validateEntityData.d.ts.map +0 -1
  250. package/dist/mcp/builtin/validateEntityData.js +0 -82
  251. package/dist/mcp/builtin/validateEntityData.js.map +0 -1
  252. package/dist/translations/index.d.ts +0 -11
  253. package/dist/translations/index.d.ts.map +0 -1
  254. package/dist/translations/index.js +0 -92
  255. package/dist/translations/index.js.map +0 -1
  256. package/dist/translations/languages/ar.d.ts +0 -31
  257. package/dist/translations/languages/ar.d.ts.map +0 -1
  258. package/dist/translations/languages/ar.js +0 -34
  259. package/dist/translations/languages/ar.js.map +0 -1
  260. package/dist/translations/languages/az.d.ts +0 -31
  261. package/dist/translations/languages/az.d.ts.map +0 -1
  262. package/dist/translations/languages/az.js +0 -34
  263. package/dist/translations/languages/az.js.map +0 -1
  264. package/dist/translations/languages/bg.d.ts +0 -31
  265. package/dist/translations/languages/bg.d.ts.map +0 -1
  266. package/dist/translations/languages/bg.js +0 -34
  267. package/dist/translations/languages/bg.js.map +0 -1
  268. package/dist/translations/languages/bnBd.d.ts +0 -31
  269. package/dist/translations/languages/bnBd.d.ts.map +0 -1
  270. package/dist/translations/languages/bnBd.js +0 -34
  271. package/dist/translations/languages/bnBd.js.map +0 -1
  272. package/dist/translations/languages/bnIn.d.ts +0 -31
  273. package/dist/translations/languages/bnIn.d.ts.map +0 -1
  274. package/dist/translations/languages/bnIn.js +0 -34
  275. package/dist/translations/languages/bnIn.js.map +0 -1
  276. package/dist/translations/languages/ca.d.ts +0 -31
  277. package/dist/translations/languages/ca.d.ts.map +0 -1
  278. package/dist/translations/languages/ca.js +0 -34
  279. package/dist/translations/languages/ca.js.map +0 -1
  280. package/dist/translations/languages/cs.d.ts +0 -31
  281. package/dist/translations/languages/cs.d.ts.map +0 -1
  282. package/dist/translations/languages/cs.js +0 -34
  283. package/dist/translations/languages/cs.js.map +0 -1
  284. package/dist/translations/languages/da.d.ts +0 -31
  285. package/dist/translations/languages/da.d.ts.map +0 -1
  286. package/dist/translations/languages/da.js +0 -34
  287. package/dist/translations/languages/da.js.map +0 -1
  288. package/dist/translations/languages/de.d.ts +0 -31
  289. package/dist/translations/languages/de.d.ts.map +0 -1
  290. package/dist/translations/languages/de.js +0 -34
  291. package/dist/translations/languages/de.js.map +0 -1
  292. package/dist/translations/languages/en.d.ts +0 -31
  293. package/dist/translations/languages/en.d.ts.map +0 -1
  294. package/dist/translations/languages/en.js +0 -34
  295. package/dist/translations/languages/en.js.map +0 -1
  296. package/dist/translations/languages/es.d.ts +0 -31
  297. package/dist/translations/languages/es.d.ts.map +0 -1
  298. package/dist/translations/languages/es.js +0 -34
  299. package/dist/translations/languages/es.js.map +0 -1
  300. package/dist/translations/languages/et.d.ts +0 -31
  301. package/dist/translations/languages/et.d.ts.map +0 -1
  302. package/dist/translations/languages/et.js +0 -34
  303. package/dist/translations/languages/et.js.map +0 -1
  304. package/dist/translations/languages/fa.d.ts +0 -31
  305. package/dist/translations/languages/fa.d.ts.map +0 -1
  306. package/dist/translations/languages/fa.js +0 -34
  307. package/dist/translations/languages/fa.js.map +0 -1
  308. package/dist/translations/languages/fr.d.ts +0 -31
  309. package/dist/translations/languages/fr.d.ts.map +0 -1
  310. package/dist/translations/languages/fr.js +0 -34
  311. package/dist/translations/languages/fr.js.map +0 -1
  312. package/dist/translations/languages/he.d.ts +0 -31
  313. package/dist/translations/languages/he.d.ts.map +0 -1
  314. package/dist/translations/languages/he.js +0 -34
  315. package/dist/translations/languages/he.js.map +0 -1
  316. package/dist/translations/languages/hr.d.ts +0 -31
  317. package/dist/translations/languages/hr.d.ts.map +0 -1
  318. package/dist/translations/languages/hr.js +0 -34
  319. package/dist/translations/languages/hr.js.map +0 -1
  320. package/dist/translations/languages/hu.d.ts +0 -31
  321. package/dist/translations/languages/hu.d.ts.map +0 -1
  322. package/dist/translations/languages/hu.js +0 -34
  323. package/dist/translations/languages/hu.js.map +0 -1
  324. package/dist/translations/languages/hy.d.ts +0 -31
  325. package/dist/translations/languages/hy.d.ts.map +0 -1
  326. package/dist/translations/languages/hy.js +0 -34
  327. package/dist/translations/languages/hy.js.map +0 -1
  328. package/dist/translations/languages/id.d.ts +0 -31
  329. package/dist/translations/languages/id.d.ts.map +0 -1
  330. package/dist/translations/languages/id.js +0 -34
  331. package/dist/translations/languages/id.js.map +0 -1
  332. package/dist/translations/languages/is.d.ts +0 -31
  333. package/dist/translations/languages/is.d.ts.map +0 -1
  334. package/dist/translations/languages/is.js +0 -34
  335. package/dist/translations/languages/is.js.map +0 -1
  336. package/dist/translations/languages/it.d.ts +0 -31
  337. package/dist/translations/languages/it.d.ts.map +0 -1
  338. package/dist/translations/languages/it.js +0 -34
  339. package/dist/translations/languages/it.js.map +0 -1
  340. package/dist/translations/languages/ja.d.ts +0 -31
  341. package/dist/translations/languages/ja.d.ts.map +0 -1
  342. package/dist/translations/languages/ja.js +0 -34
  343. package/dist/translations/languages/ja.js.map +0 -1
  344. package/dist/translations/languages/ko.d.ts +0 -31
  345. package/dist/translations/languages/ko.d.ts.map +0 -1
  346. package/dist/translations/languages/ko.js +0 -34
  347. package/dist/translations/languages/ko.js.map +0 -1
  348. package/dist/translations/languages/lt.d.ts +0 -31
  349. package/dist/translations/languages/lt.d.ts.map +0 -1
  350. package/dist/translations/languages/lt.js +0 -34
  351. package/dist/translations/languages/lt.js.map +0 -1
  352. package/dist/translations/languages/lv.d.ts +0 -31
  353. package/dist/translations/languages/lv.d.ts.map +0 -1
  354. package/dist/translations/languages/lv.js +0 -34
  355. package/dist/translations/languages/lv.js.map +0 -1
  356. package/dist/translations/languages/my.d.ts +0 -31
  357. package/dist/translations/languages/my.d.ts.map +0 -1
  358. package/dist/translations/languages/my.js +0 -34
  359. package/dist/translations/languages/my.js.map +0 -1
  360. package/dist/translations/languages/nb.d.ts +0 -31
  361. package/dist/translations/languages/nb.d.ts.map +0 -1
  362. package/dist/translations/languages/nb.js +0 -34
  363. package/dist/translations/languages/nb.js.map +0 -1
  364. package/dist/translations/languages/nl.d.ts +0 -31
  365. package/dist/translations/languages/nl.d.ts.map +0 -1
  366. package/dist/translations/languages/nl.js +0 -34
  367. package/dist/translations/languages/nl.js.map +0 -1
  368. package/dist/translations/languages/pl.d.ts +0 -31
  369. package/dist/translations/languages/pl.d.ts.map +0 -1
  370. package/dist/translations/languages/pl.js +0 -34
  371. package/dist/translations/languages/pl.js.map +0 -1
  372. package/dist/translations/languages/pt.d.ts +0 -31
  373. package/dist/translations/languages/pt.d.ts.map +0 -1
  374. package/dist/translations/languages/pt.js +0 -34
  375. package/dist/translations/languages/pt.js.map +0 -1
  376. package/dist/translations/languages/ro.d.ts +0 -31
  377. package/dist/translations/languages/ro.d.ts.map +0 -1
  378. package/dist/translations/languages/ro.js +0 -34
  379. package/dist/translations/languages/ro.js.map +0 -1
  380. package/dist/translations/languages/rs.d.ts +0 -31
  381. package/dist/translations/languages/rs.d.ts.map +0 -1
  382. package/dist/translations/languages/rs.js +0 -34
  383. package/dist/translations/languages/rs.js.map +0 -1
  384. package/dist/translations/languages/rsLatin.d.ts +0 -31
  385. package/dist/translations/languages/rsLatin.d.ts.map +0 -1
  386. package/dist/translations/languages/rsLatin.js +0 -34
  387. package/dist/translations/languages/rsLatin.js.map +0 -1
  388. package/dist/translations/languages/ru.d.ts +0 -31
  389. package/dist/translations/languages/ru.d.ts.map +0 -1
  390. package/dist/translations/languages/ru.js +0 -34
  391. package/dist/translations/languages/ru.js.map +0 -1
  392. package/dist/translations/languages/sk.d.ts +0 -31
  393. package/dist/translations/languages/sk.d.ts.map +0 -1
  394. package/dist/translations/languages/sk.js +0 -34
  395. package/dist/translations/languages/sk.js.map +0 -1
  396. package/dist/translations/languages/sl.d.ts +0 -31
  397. package/dist/translations/languages/sl.d.ts.map +0 -1
  398. package/dist/translations/languages/sl.js +0 -34
  399. package/dist/translations/languages/sl.js.map +0 -1
  400. package/dist/translations/languages/sv.d.ts +0 -31
  401. package/dist/translations/languages/sv.d.ts.map +0 -1
  402. package/dist/translations/languages/sv.js +0 -34
  403. package/dist/translations/languages/sv.js.map +0 -1
  404. package/dist/translations/languages/ta.d.ts +0 -31
  405. package/dist/translations/languages/ta.d.ts.map +0 -1
  406. package/dist/translations/languages/ta.js +0 -34
  407. package/dist/translations/languages/ta.js.map +0 -1
  408. package/dist/translations/languages/th.d.ts +0 -31
  409. package/dist/translations/languages/th.d.ts.map +0 -1
  410. package/dist/translations/languages/th.js +0 -34
  411. package/dist/translations/languages/th.js.map +0 -1
  412. package/dist/translations/languages/tr.d.ts +0 -31
  413. package/dist/translations/languages/tr.d.ts.map +0 -1
  414. package/dist/translations/languages/tr.js +0 -34
  415. package/dist/translations/languages/tr.js.map +0 -1
  416. package/dist/translations/languages/uk.d.ts +0 -31
  417. package/dist/translations/languages/uk.d.ts.map +0 -1
  418. package/dist/translations/languages/uk.js +0 -34
  419. package/dist/translations/languages/uk.js.map +0 -1
  420. package/dist/translations/languages/vi.d.ts +0 -31
  421. package/dist/translations/languages/vi.d.ts.map +0 -1
  422. package/dist/translations/languages/vi.js +0 -34
  423. package/dist/translations/languages/vi.js.map +0 -1
  424. package/dist/translations/languages/zh.d.ts +0 -31
  425. package/dist/translations/languages/zh.d.ts.map +0 -1
  426. package/dist/translations/languages/zh.js +0 -34
  427. package/dist/translations/languages/zh.js.map +0 -1
  428. package/dist/translations/languages/zhTw.d.ts +0 -31
  429. package/dist/translations/languages/zhTw.d.ts.map +0 -1
  430. package/dist/translations/languages/zhTw.js +0 -34
  431. package/dist/translations/languages/zhTw.js.map +0 -1
  432. package/dist/translations/types.d.ts +0 -32
  433. package/dist/translations/types.d.ts.map +0 -1
  434. package/dist/translations/types.js +0 -3
  435. package/dist/translations/types.js.map +0 -1
  436. package/dist/utils/getVirtualFieldNames.d.ts +0 -14
  437. package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
  438. package/dist/utils/getVirtualFieldNames.js +0 -35
  439. package/dist/utils/getVirtualFieldNames.js.map +0 -1
  440. package/dist/utils/localAPIDefaults.d.ts +0 -20
  441. package/dist/utils/localAPIDefaults.d.ts.map +0 -1
  442. package/dist/utils/localAPIDefaults.js +0 -19
  443. package/dist/utils/localAPIDefaults.js.map +0 -1
  444. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts +0 -11
  445. package/dist/utils/schemaConversion/getEntityInputSchema.d.ts.map +0 -1
  446. package/dist/utils/schemaConversion/getEntityInputSchema.js +0 -34
  447. package/dist/utils/schemaConversion/getEntityInputSchema.js.map +0 -1
  448. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
  449. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
  450. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
  451. package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
  452. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts +0 -15
  453. package/dist/utils/schemaConversion/sanitizeEntitySchema.d.ts.map +0 -1
  454. package/dist/utils/schemaConversion/sanitizeEntitySchema.js +0 -464
  455. package/dist/utils/schemaConversion/sanitizeEntitySchema.js.map +0 -1
  456. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js +0 -158
  457. package/dist/utils/schemaConversion/sanitizeEntitySchema.spec.js.map +0 -1
  458. package/dist/utils/transformPointDataToPayload.d.ts +0 -7
  459. package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
  460. package/dist/utils/transformPointDataToPayload.js +0 -28
  461. package/dist/utils/transformPointDataToPayload.js.map +0 -1
  462. package/dist/utils/whereSchema.d.ts +0 -9
  463. package/dist/utils/whereSchema.d.ts.map +0 -1
  464. package/dist/utils/whereSchema.js +0 -13
  465. package/dist/utils/whereSchema.js.map +0 -1
  466. package/src/collection/getAccessField.ts +0 -84
  467. package/src/collection/index.ts +0 -105
  468. package/src/components/APIKeyField/index.client.tsx +0 -73
  469. package/src/components/APIKeyField/index.css +0 -105
  470. package/src/components/APIKeysEmptyState/index.client.tsx +0 -36
  471. package/src/components/AccessField/index.client.tsx +0 -299
  472. package/src/components/AccessField/index.css +0 -99
  473. package/src/components/SettingsMenu/index.client.tsx +0 -34
  474. package/src/mcp/builtin/collections/formatCollectionError.ts +0 -84
  475. package/src/mcp/builtin/validateEntityData.ts +0 -132
  476. package/src/translations/index.ts +0 -108
  477. package/src/translations/languages/ar.ts +0 -35
  478. package/src/translations/languages/az.ts +0 -35
  479. package/src/translations/languages/bg.ts +0 -35
  480. package/src/translations/languages/bnBd.ts +0 -35
  481. package/src/translations/languages/bnIn.ts +0 -35
  482. package/src/translations/languages/ca.ts +0 -35
  483. package/src/translations/languages/cs.ts +0 -35
  484. package/src/translations/languages/da.ts +0 -35
  485. package/src/translations/languages/de.ts +0 -35
  486. package/src/translations/languages/en.ts +0 -35
  487. package/src/translations/languages/es.ts +0 -35
  488. package/src/translations/languages/et.ts +0 -35
  489. package/src/translations/languages/fa.ts +0 -35
  490. package/src/translations/languages/fr.ts +0 -35
  491. package/src/translations/languages/he.ts +0 -35
  492. package/src/translations/languages/hr.ts +0 -35
  493. package/src/translations/languages/hu.ts +0 -35
  494. package/src/translations/languages/hy.ts +0 -35
  495. package/src/translations/languages/id.ts +0 -35
  496. package/src/translations/languages/is.ts +0 -35
  497. package/src/translations/languages/it.ts +0 -35
  498. package/src/translations/languages/ja.ts +0 -35
  499. package/src/translations/languages/ko.ts +0 -35
  500. package/src/translations/languages/lt.ts +0 -35
  501. package/src/translations/languages/lv.ts +0 -35
  502. package/src/translations/languages/my.ts +0 -35
  503. package/src/translations/languages/nb.ts +0 -35
  504. package/src/translations/languages/nl.ts +0 -35
  505. package/src/translations/languages/pl.ts +0 -35
  506. package/src/translations/languages/pt.ts +0 -35
  507. package/src/translations/languages/ro.ts +0 -35
  508. package/src/translations/languages/rs.ts +0 -35
  509. package/src/translations/languages/rsLatin.ts +0 -35
  510. package/src/translations/languages/ru.ts +0 -35
  511. package/src/translations/languages/sk.ts +0 -35
  512. package/src/translations/languages/sl.ts +0 -35
  513. package/src/translations/languages/sv.ts +0 -35
  514. package/src/translations/languages/ta.ts +0 -35
  515. package/src/translations/languages/th.ts +0 -35
  516. package/src/translations/languages/tr.ts +0 -35
  517. package/src/translations/languages/uk.ts +0 -35
  518. package/src/translations/languages/vi.ts +0 -35
  519. package/src/translations/languages/zh.ts +0 -35
  520. package/src/translations/languages/zhTw.ts +0 -35
  521. package/src/translations/types.ts +0 -34
  522. package/src/utils/getVirtualFieldNames.ts +0 -53
  523. package/src/utils/localAPIDefaults.ts +0 -22
  524. package/src/utils/schemaConversion/getEntityInputSchema.ts +0 -78
  525. package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
  526. package/src/utils/schemaConversion/sanitizeEntitySchema.spec.ts +0 -103
  527. package/src/utils/schemaConversion/sanitizeEntitySchema.ts +0 -529
  528. package/src/utils/transformPointDataToPayload.ts +0 -40
  529. package/src/utils/whereSchema.ts +0 -24
package/dist/types.d.ts CHANGED
@@ -1,34 +1,16 @@
1
- import type { CallToolResult, ContentBlock, JsonSchemaType, McpServer, ResourceTemplate, ServerContext, StandardSchemaWithJSON } from '@modelcontextprotocol/server';
2
- import type { AuthCollectionSlug, CollectionConfig, CollectionSlug, DefaultDocumentIDType, GlobalSlug, MaybePromise, PayloadRequest, TypedUser } from 'payload';
1
+ import type { CallToolResult, ContentBlock, Implementation, JsonSchemaType, McpServerOptions, ResourceTemplate, ServerContext, StandardSchemaWithJSON, ToolAnnotations } from '@modelcontextprotocol/server';
2
+ import type { AuthCollectionSlug, CollectionSlug, GlobalSlug, MaybePromise, PayloadRequest, SanitizedPermissions } from 'payload';
3
+ import type { GetAuthorizedMCPArgs } from './endpoint/access.js';
3
4
  import type { MCPCollectionAuthToolName, MCPCollectionBuiltinName, MCPGlobalBuiltinName } from './mcp/builtinTools.js';
4
5
  export type { MCPCollectionAuthToolName, MCPCollectionBuiltinName, MCPGlobalBuiltinName };
5
- /** Re-exported from `@modelcontextprotocol/server` — the JSON Schema shape the MCP runtime validates against. */
6
- export type { JsonSchemaType, StandardSchemaWithJSON };
6
+ /** Re-exported from `@modelcontextprotocol/server` — common MCP types used in plugin config. */
7
+ export type { JsonSchemaType, StandardSchemaWithJSON, ToolAnnotations };
7
8
  /**
8
9
  * What a tool's `input` (or a prompt's `argsSchema`) can be — either a raw
9
- * JSON Schema literal, or a Standard Schema instance (Zod, Valibot, …).
10
+ * JSON Schema 2020-12 literal, or a Standard Schema instance (Zod, Valibot, …).
11
+ * Raw schemas may omit `$schema`; when present it must declare the 2020-12 dialect.
10
12
  */
11
13
  export type ToolInputSchema = JsonSchemaType | StandardSchemaWithJSON;
12
- /**
13
- * Serializable mirror of `SanitizedMCPPluginConfig` for client components —
14
- * the full sanitized config carries functions (tool handlers, etc.) that can't
15
- * cross the server→client boundary. Built by `sanitizeClientPluginConfig` and
16
- * passed to the `AccessField` component via `clientProps`.
17
- *
18
- * @internal
19
- */
20
- export type ClientMCPPluginConfig = {
21
- items: Array<{
22
- collectionSlug?: string;
23
- configKey: string;
24
- description?: string;
25
- globalSlug?: string;
26
- /** Admin-UI bucket for collection/global tools: built-in CRUD, auth, or custom. */
27
- group?: 'auth' | 'custom' | 'operations';
28
- label: string;
29
- type: 'collectionTool' | 'globalTool' | 'prompt' | 'resource' | 'tool';
30
- }>;
31
- };
32
14
  export type MCPToolResponse = {
33
15
  content: ContentBlock[];
34
16
  /**
@@ -39,11 +21,27 @@ export type MCPToolResponse = {
39
21
  doc?: Record<string, unknown>;
40
22
  } & Pick<CallToolResult, '_meta' | 'isError' | 'structuredContent'>;
41
23
  export type MCPResponseOverride = (response: MCPToolResponse, doc: Record<string, unknown>, req: PayloadRequest) => MCPToolResponse;
24
+ export type MCPAfterToolCallHook = (args: {
25
+ input: unknown;
26
+ req: PayloadRequest;
27
+ response: MCPToolResponse;
28
+ toolName: string;
29
+ }) => MaybePromise<MCPToolResponse>;
42
30
  /**
43
31
  * The handler's `input` type. A specific Standard Schema (Zod, Valibot, …) gets
44
32
  * its inferred output; anything else falls back to `Record<string, unknown>`.
45
33
  */
46
34
  export type TypedInput<TSchema> = TSchema extends StandardSchemaWithJSON ? StandardSchemaWithJSON extends TSchema ? Record<string, unknown> : StandardSchemaWithJSON.InferOutput<TSchema> : Record<string, unknown>;
35
+ export type MCPAccessArgs = {
36
+ permissions?: SanitizedPermissions;
37
+ req: PayloadRequest;
38
+ };
39
+ export type CollectionMCPAccessArgs = {
40
+ slug: CollectionSlug;
41
+ } & MCPAccessArgs;
42
+ export type GlobalMCPAccessArgs = {
43
+ slug: GlobalSlug;
44
+ } & MCPAccessArgs;
47
45
  export type ToolHandlerArgs<TSchema = undefined> = {
48
46
  authorizedMCP: AuthorizedMCP;
49
47
  input: TypedInput<TSchema>;
@@ -51,12 +49,19 @@ export type ToolHandlerArgs<TSchema = undefined> = {
51
49
  serverContext: ServerContext;
52
50
  };
53
51
  export type CollectionToolHandlerArgs<TSchema = undefined> = {
54
- collectionSlug: CollectionSlug;
52
+ slug: CollectionSlug;
55
53
  } & ToolHandlerArgs<TSchema>;
56
54
  export type GlobalToolHandlerArgs<TSchema = undefined> = {
57
- globalSlug: GlobalSlug;
55
+ slug: GlobalSlug;
58
56
  } & ToolHandlerArgs<TSchema>;
59
57
  export type Tool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {
58
+ /**
59
+ * Runs while authorizing each MCP request, before the tool is advertised or called. Return
60
+ * `false` to make the tool unavailable for that request. This is skipped when `overrideAccess`
61
+ * is enabled.
62
+ */
63
+ access?: (args: MCPAccessArgs) => MaybePromise<boolean>;
64
+ annotations?: ToolAnnotations;
60
65
  description: string;
61
66
  handler: (args: ToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>;
62
67
  input?: TSchema;
@@ -66,19 +71,50 @@ export type Tool<TSchema extends ToolInputSchema | undefined = ToolInputSchema |
66
71
  overrideResponse?: MCPResponseOverride;
67
72
  };
68
73
  export type CollectionTool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {
74
+ /**
75
+ * Runs while authorizing each MCP request for this collection. Return `false` to reject calls
76
+ * to this tool for the collection. The shared tool is not advertised when no collections allow
77
+ * it, but can remain advertised when it is available for another collection. This is skipped
78
+ * when `overrideAccess` is enabled.
79
+ */
80
+ access?: (args: CollectionMCPAccessArgs) => MaybePromise<boolean>;
69
81
  handler: (args: CollectionToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>;
70
82
  input?: TSchema;
71
- } & Pick<Tool, 'description' | 'overrideResponse'>;
83
+ } & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>;
72
84
  export type GlobalTool<TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined> = {
85
+ /**
86
+ * Runs while authorizing each MCP request for this global. Return `false` to reject calls to
87
+ * this tool for the global. The shared tool is not advertised when no globals allow it, but
88
+ * can remain advertised when it is available for another global. This is skipped when
89
+ * `overrideAccess` is enabled.
90
+ */
91
+ access?: (args: GlobalMCPAccessArgs) => MaybePromise<boolean>;
73
92
  handler: (args: GlobalToolHandlerArgs<TSchema>) => MaybePromise<MCPToolResponse>;
74
93
  input?: TSchema;
75
- } & Pick<Tool, 'description' | 'overrideResponse'>;
94
+ } & Pick<Tool, 'annotations' | 'description' | 'overrideResponse'>;
76
95
  /**
77
96
  * Configures (or disables) a built-in tool without replacing it.
78
97
  * `handler?: never` prevents a full `CollectionTool`/`GlobalTool` (which has a
79
98
  * required handler) from being silently accepted at a built-in key slot.
80
99
  */
81
- export type MCPBuiltInToolOverride = {
100
+ export type MCPBuiltInCollectionToolOverride = {
101
+ /**
102
+ * Replaces the built-in tool's access check. Return `false` to make the tool unavailable for
103
+ * this collection. This is skipped when `overrideAccess` is enabled.
104
+ */
105
+ access?: (args: CollectionMCPAccessArgs) => MaybePromise<boolean>;
106
+ annotations?: ToolAnnotations;
107
+ description?: string;
108
+ handler?: never;
109
+ overrideResponse?: MCPResponseOverride;
110
+ };
111
+ export type MCPBuiltInGlobalToolOverride = {
112
+ /**
113
+ * Replaces the built-in tool's access check. Return `false` to make the tool unavailable for
114
+ * this global. This is skipped when `overrideAccess` is enabled.
115
+ */
116
+ access?: (args: GlobalMCPAccessArgs) => MaybePromise<boolean>;
117
+ annotations?: ToolAnnotations;
82
118
  description?: string;
83
119
  handler?: never;
84
120
  overrideResponse?: MCPResponseOverride;
@@ -90,19 +126,19 @@ export type MCPBuiltInToolOverride = {
90
126
  */
91
127
  export type MCPTopLevelToolEntry = Tool;
92
128
  export type MCPCollectionToolsMap = {
93
- [customToolName: string]: boolean | CollectionTool | MCPBuiltInToolOverride | undefined;
129
+ [customToolName: string]: boolean | CollectionTool | MCPBuiltInCollectionToolOverride | undefined;
94
130
  } & {
95
- [K in MCPCollectionBuiltinName]?: false | MCPBuiltInToolOverride;
131
+ [K in MCPCollectionBuiltinName]?: false | MCPBuiltInCollectionToolOverride;
96
132
  };
97
133
  export type MCPAuthCollectionToolsMap = {
98
- [K in MCPCollectionAuthToolName]?: MCPBuiltInToolOverride | true;
134
+ [K in MCPCollectionAuthToolName]?: MCPBuiltInCollectionToolOverride | true;
99
135
  } & MCPCollectionToolsMap;
100
136
  /** Auth-enabled collections get auth-tool name autocomplete; others get CRUD-only. */
101
137
  export type MCPToolsMapForCollection<Slug extends CollectionSlug> = Slug extends AuthCollectionSlug ? MCPAuthCollectionToolsMap : MCPCollectionToolsMap;
102
138
  export type MCPGlobalToolsMap = {
103
- [customToolName: string]: boolean | GlobalTool | MCPBuiltInToolOverride | undefined;
139
+ [customToolName: string]: boolean | GlobalTool | MCPBuiltInGlobalToolOverride | undefined;
104
140
  } & {
105
- [K in MCPGlobalBuiltinName]?: false | MCPBuiltInToolOverride;
141
+ [K in MCPGlobalBuiltinName]?: false | MCPBuiltInGlobalToolOverride;
106
142
  };
107
143
  export type MCPTopLevelToolsMap = Record<string, Tool>;
108
144
  export type PromptHandlerArgs<TSchema = undefined> = {
@@ -111,6 +147,12 @@ export type PromptHandlerArgs<TSchema = undefined> = {
111
147
  serverContext: ServerContext;
112
148
  };
113
149
  export type Prompt<TSchema extends ToolInputSchema = ToolInputSchema> = {
150
+ /**
151
+ * Runs while authorizing each MCP request, before the prompt is advertised or used. Return
152
+ * `false` to make the prompt unavailable for that request. This is skipped when
153
+ * `overrideAccess` is enabled.
154
+ */
155
+ access?: (args: MCPAccessArgs) => MaybePromise<boolean>;
114
156
  argsSchema: TSchema;
115
157
  description: string;
116
158
  handler: (args: PromptHandlerArgs<TSchema>) => MaybePromise<{
@@ -132,6 +174,12 @@ export type ResourceHandlerArgs = {
132
174
  uri: URL;
133
175
  };
134
176
  export type Resource = {
177
+ /**
178
+ * Runs while authorizing each MCP request, before the resource is advertised or read. Return
179
+ * `false` to make the resource unavailable for that request. This is skipped when
180
+ * `overrideAccess` is enabled.
181
+ */
182
+ access?: (args: MCPAccessArgs) => MaybePromise<boolean>;
135
183
  description: string;
136
184
  handler: (args: ResourceHandlerArgs) => MaybePromise<{
137
185
  contents: Array<{
@@ -162,87 +210,171 @@ export type MCPPluginGlobalConfig = {
162
210
  * actually works with.
163
211
  */
164
212
  export type MCPPluginConfig = {
213
+ /**
214
+ * Decides who can use MCP at all. Runs on every MCP request once the user is authenticated,
215
+ * before the `access` callbacks of tools, prompts, and resources, and when a user allows an MCP
216
+ * client on the built-in OAuth server's sign-in page. Return `false` to answer MCP requests with
217
+ * `403` and to refuse to sign the client in. This is skipped when `overrideAccess` is enabled.
218
+ * `overrideGetAuthorizedMCP` replaces it on MCP requests.
219
+ *
220
+ * It only applies to MCP, not to Payload's REST or GraphQL APIs, so it doesn't replace access
221
+ * control on collections and globals.
222
+ *
223
+ * @default no check, so tools, prompts, and resources decide on their own
224
+ */
225
+ access?: (args: MCPAccessArgs) => MaybePromise<boolean>;
165
226
  collections?: {
166
227
  [Slug in CollectionSlug]?: MCPPluginCollectionConfig<Slug>;
167
228
  };
168
- /** Skip MCP registration. The API key collection is still added (so DB / types stay stable). */
229
+ /** Skip MCP endpoint registration. */
169
230
  disabled?: boolean;
170
231
  globals?: {
171
232
  [Slug in GlobalSlug]?: MCPPluginGlobalConfig;
172
233
  };
234
+ hooks?: {
235
+ /** Transform a tool response after its handler returns */
236
+ afterToolCall?: MCPAfterToolCallHook[];
237
+ };
173
238
  mcp?: {
239
+ /**
240
+ * Largest HTTP request body, in bytes, that the MCP endpoint accepts. Larger requests
241
+ * are answered with `413`. Base64 file uploads count toward this limit.
242
+ *
243
+ * @default 4194304 (4 MiB, the MCP SDK default)
244
+ */
245
+ maxRequestBodySize?: number;
174
246
  serverOptions?: MCPServerOptions;
175
247
  verboseLogs?: boolean;
176
248
  };
177
- overrideApiKeyCollection?: (collection: CollectionConfig) => CollectionConfig;
178
- /** Replace the default API-key auth with a custom resolver. */
179
- overrideAuth?: (args: {
180
- getAPIKeyDoc: (overrideApiKey?: string) => Promise<MCPAPIKeysDoc>;
181
- getAuthorizedMCP: (args: {
182
- apiKeyDoc: MCPAPIKeysDoc;
183
- }) => AuthorizedMCP;
249
+ /**
250
+ * How MCP clients sign in. MCP requests without an authenticated user get a `401` that points
251
+ * to the protected resource metadata (RFC 9728). Set to `false` to only accept API keys and
252
+ * anonymous requests.
253
+ *
254
+ * @default { type: 'builtin' }
255
+ */
256
+ oauth?: false | MCPOAuthConfig;
257
+ /**
258
+ * Replace the default MCP authorization resolver.
259
+ *
260
+ * This hook replaces the default authentication flow, including the plugin's `access`. It must
261
+ * set `req.user` to the authenticated Payload user, or to `null` for an anonymous caller, before
262
+ * returning.
263
+ */
264
+ overrideGetAuthorizedMCP?: (args: {
184
265
  pluginConfig: SanitizedMCPPluginConfig;
185
- req: PayloadRequest;
186
- }) => MaybePromise<AuthorizedMCP>;
266
+ } & GetAuthorizedMCPArgs) => MaybePromise<AuthorizedMCP>;
187
267
  prompts?: Record<string, Prompt>;
188
268
  resources?: Record<string, Resource>;
189
269
  /** Cross-cutting tools (not scoped to any collection or global). */
190
270
  tools?: MCPTopLevelToolsMap;
191
- userCollection?: CollectionSlug;
192
- };
193
- export type SanitizedMCPPluginConfig = {
194
- items: MCPItem[];
195
- userCollection: CollectionSlug;
196
- } & Pick<MCPPluginConfig, 'disabled' | 'mcp' | 'overrideApiKeyCollection' | 'overrideAuth'>;
197
- export type MCPServerOptions = {
198
- options?: ConstructorParameters<typeof McpServer>[1];
199
- serverInfo?: Partial<ConstructorParameters<typeof McpServer>[0]>;
200
271
  };
272
+ export type MCPOAuthConfig = MCPBuiltinOAuthConfig | MCPExternalOAuthConfig;
201
273
  /**
202
- * Nested access tree as stored in the collection.
203
- * A `false` leaf disables that tool; missing keys defer to
204
- * defaults (built-in CRUD is on, opt-in tools are off).
274
+ * This Payload app is the authorization server. Users sign in to the admin panel and allow the
275
+ * MCP client, which then gets an access token for them.
205
276
  */
206
- export type MCPAPIKeysDocAccessTree = {
207
- collections?: {
208
- [CollectionSlug: CollectionSlug]: {
209
- [ToolKey: string]: boolean;
210
- };
211
- };
212
- globals?: {
213
- [GlobalSlug: GlobalSlug]: {
214
- [ToolKey: string]: boolean;
277
+ export type MCPBuiltinOAuthConfig = {
278
+ /**
279
+ * Creates the tokens the MCP client gets when the user clicks Allow. `req` is the user's own
280
+ * browser request, so `req.user` is the user who allowed it. Pass `authenticate` too if
281
+ * Payload's auth strategies don't accept the access token.
282
+ *
283
+ * @default a Payload login token for that user that only works for MCP, with a refresh token when
284
+ * the collection uses sessions. Its session is labelled with the client's name.
285
+ */
286
+ issueToken?: (args: {
287
+ /** The MCP client the user allowed, with the address it returns to. */
288
+ client: {
289
+ name: string;
290
+ redirectURI: string;
215
291
  };
216
- };
217
- prompts?: {
218
- [PromptKey: string]: boolean;
219
- };
220
- resources?: {
221
- [ResourceKey: string]: boolean;
222
- };
223
- tools?: {
224
- [ToolKey: string]: boolean;
225
- };
292
+ req: PayloadRequest;
293
+ }) => MaybePromise<MCPOAuthTokens>;
294
+ /**
295
+ * Trades a refresh token from `issueToken`, or from an earlier refresh, for new tokens. Return
296
+ * `null` when it's no longer valid, and the client sends the user through sign-in again. `req`
297
+ * is the MCP client's request, without a user. Only used together with `issueToken`.
298
+ *
299
+ * OAuth requires noticing copied refresh tokens: return a new refresh token every time, and
300
+ * revoke the tokens when an already used refresh token comes back.
301
+ *
302
+ * It also runs when the client trades its authorization code, on the refresh token from
303
+ * `issueToken`, with `reuseInterval: 0`. OAuth requires a code to work only once, so refuse that
304
+ * refresh token if it was used before, even moments ago.
305
+ */
306
+ refreshToken?: (args: {
307
+ refreshToken: string;
308
+ req: PayloadRequest;
309
+ /**
310
+ * How long a refresh token that was just used may still be accepted, in milliseconds, e.g. for
311
+ * clients that refresh twice at once. `0` means not at all. When it's missing, use your usual
312
+ * leeway.
313
+ */
314
+ reuseInterval?: number;
315
+ }) => MaybePromise<MCPOAuthTokens | null>;
316
+ type: 'builtin';
317
+ } & MCPOAuthSharedConfig;
318
+ export type MCPOAuthTokens = {
319
+ accessToken: string;
320
+ /** Seconds until the access token expires. */
321
+ expiresIn?: number;
322
+ /** Lets the client get new tokens without the user, through `refreshToken`. */
323
+ refreshToken?: string;
226
324
  };
227
- /**
228
- * Stored on `payload-mcp-api-keys` docs
229
- */
230
- export type MCPAPIKeysDoc = {
231
- access: MCPAPIKeysDocAccessTree;
232
- apiKey?: string;
233
- apiKeyIndex?: string;
234
- id: DefaultDocumentIDType;
235
- lastUsed?: string;
236
- overrideAccess?: boolean;
237
- user: null | TypedUser;
325
+ /** Another service, e.g. your identity provider, is the authorization server. */
326
+ export type MCPExternalOAuthConfig = {
327
+ /**
328
+ * The authorization servers that issue access tokens for MCP clients. Clients require each one
329
+ * to exactly match the `issuer` in that server's metadata, so pass a function when the exact
330
+ * value is only known at runtime, e.g. from the server's OpenID configuration or per host.
331
+ */
332
+ authorizationServers: ((args: {
333
+ req: PayloadRequest;
334
+ }) => MaybePromise<string[]>) | string[];
335
+ /**
336
+ * Scopes MCP clients should request, e.g. `['openid', 'email', 'profile']`. Without them,
337
+ * clients request none, which some authorization servers reject or answer with a token that
338
+ * doesn't identify the user.
339
+ */
340
+ scopes?: string[];
341
+ type: 'external';
342
+ } & MCPOAuthSharedConfig;
343
+ type MCPOAuthSharedConfig = {
344
+ /**
345
+ * Called on MCP requests with a bearer token that Payload's auth strategies didn't accept.
346
+ * Return the Payload user, including its `collection`, or `null` to answer with the OAuth challenge.
347
+ */
348
+ authenticate?: (args: {
349
+ req: PayloadRequest;
350
+ token: string;
351
+ }) => MaybePromise<PayloadRequest['user']>;
352
+ /**
353
+ * The URL clients call to reach the MCP endpoint. The metadata link and the built-in
354
+ * authorization server's issuer are based on it.
355
+ *
356
+ * @default the absolute URL of `/api/mcp`, based on `serverURL` or the request URL
357
+ */
358
+ resource?: ((args: {
359
+ req: PayloadRequest;
360
+ }) => string) | string;
361
+ };
362
+ export type SanitizedMCPPluginConfig = {
363
+ items: MCPItem[];
364
+ /** `undefined` when OAuth is turned off. */
365
+ oauth?: MCPOAuthConfig;
366
+ } & Pick<MCPPluginConfig, 'access' | 'disabled' | 'hooks' | 'mcp' | 'overrideGetAuthorizedMCP'>;
367
+ export type MCPServerOptions = {
368
+ options?: McpServerOptions;
369
+ serverInfo?: Partial<Implementation>;
238
370
  };
239
371
  /**
240
- * One MCP primitive plus the metadata needed for access checks, admin UI, and
372
+ * One MCP primitive plus the metadata needed for config-driven filtering and
241
373
  * registration.
242
374
  *
243
- * - `configKey`: the config/API-key identifier, e.g. `find` or `echo`.
375
+ * - `configKey`: the config identifier, e.g. `find` or `echo`.
244
376
  * - `mcpName`: the MCP wire name, e.g. `findDocuments` or `echo`.
245
- * - `label`: human-readable admin checkbox text.
377
+ * - `label`: human-readable display text.
246
378
  */
247
379
  export type MCPItemBase = {
248
380
  configKey: string;
@@ -270,14 +402,11 @@ export type MCPItem = ({
270
402
  type: 'tool';
271
403
  } & MCPItemBase) | CollectionMCPItem | GlobalMCPItem;
272
404
  /**
273
- * The caller's identity + the MCP items they can use for this request. Returned
274
- * by `getAuthorizedMCP`; denied items are simply absent from `items`. Handlers
275
- * receive this via `args.authorizedMCP` so they can spread
276
- * `localAPIDefaults(authorizedMCP)` into every local API call.
405
+ * The MCP items and access mode authorized for this request. The authenticated user is available
406
+ * as `req.user`.
277
407
  */
278
408
  export type AuthorizedMCP = {
279
409
  items: MCPItem[];
280
410
  overrideAccess: boolean;
281
- user: null | TypedUser;
282
411
  };
283
412
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js CHANGED
@@ -1,8 +1,6 @@
1
1
  /**
2
- * The caller's identity + the MCP items they can use for this request. Returned
3
- * by `getAuthorizedMCP`; denied items are simply absent from `items`. Handlers
4
- * receive this via `args.authorizedMCP` so they can spread
5
- * `localAPIDefaults(authorizedMCP)` into every local API call.
2
+ * The MCP items and access mode authorized for this request. The authenticated user is available
3
+ * as `req.user`.
6
4
  */ export { };
7
5
 
8
6
  //# sourceMappingURL=types.js.map
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 /**\n * Decides who can use MCP at all. Runs on every MCP request once the user is authenticated,\n * before the `access` callbacks of tools, prompts, and resources, and when a user allows an MCP\n * client on the built-in OAuth server's sign-in page. Return `false` to answer MCP requests with\n * `403` and to refuse to sign the client in. This is skipped when `overrideAccess` is enabled.\n * `overrideGetAuthorizedMCP` replaces it on MCP requests.\n *\n * It only applies to MCP, not to Payload's REST or GraphQL APIs, so it doesn't replace access\n * control on collections and globals.\n *\n * @default no check, so tools, prompts, and resources decide on their own\n */\n access?: (args: MCPAccessArgs) => MaybePromise<boolean>\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 * How MCP clients sign in. MCP requests without an authenticated user get a `401` that points\n * to the protected resource metadata (RFC 9728). Set to `false` to only accept API keys and\n * anonymous requests.\n *\n * @default { type: 'builtin' }\n */\n oauth?: false | MCPOAuthConfig\n /**\n * Replace the default MCP authorization resolver.\n *\n * This hook replaces the default authentication flow, including the plugin's `access`. It must\n * set `req.user` to the authenticated Payload user, or to `null` for an anonymous caller, before\n * 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 MCPOAuthConfig = MCPBuiltinOAuthConfig | MCPExternalOAuthConfig\n\n/**\n * This Payload app is the authorization server. Users sign in to the admin panel and allow the\n * MCP client, which then gets an access token for them.\n */\nexport type MCPBuiltinOAuthConfig = {\n /**\n * Creates the tokens the MCP client gets when the user clicks Allow. `req` is the user's own\n * browser request, so `req.user` is the user who allowed it. Pass `authenticate` too if\n * Payload's auth strategies don't accept the access token.\n *\n * @default a Payload login token for that user that only works for MCP, with a refresh token when\n * the collection uses sessions. Its session is labelled with the client's name.\n */\n issueToken?: (args: {\n /** The MCP client the user allowed, with the address it returns to. */\n client: { name: string; redirectURI: string }\n req: PayloadRequest\n }) => MaybePromise<MCPOAuthTokens>\n /**\n * Trades a refresh token from `issueToken`, or from an earlier refresh, for new tokens. Return\n * `null` when it's no longer valid, and the client sends the user through sign-in again. `req`\n * is the MCP client's request, without a user. Only used together with `issueToken`.\n *\n * OAuth requires noticing copied refresh tokens: return a new refresh token every time, and\n * revoke the tokens when an already used refresh token comes back.\n *\n * It also runs when the client trades its authorization code, on the refresh token from\n * `issueToken`, with `reuseInterval: 0`. OAuth requires a code to work only once, so refuse that\n * refresh token if it was used before, even moments ago.\n */\n refreshToken?: (args: {\n refreshToken: string\n req: PayloadRequest\n /**\n * How long a refresh token that was just used may still be accepted, in milliseconds, e.g. for\n * clients that refresh twice at once. `0` means not at all. When it's missing, use your usual\n * leeway.\n */\n reuseInterval?: number\n }) => MaybePromise<MCPOAuthTokens | null>\n type: 'builtin'\n} & MCPOAuthSharedConfig\n\nexport type MCPOAuthTokens = {\n accessToken: string\n /** Seconds until the access token expires. */\n expiresIn?: number\n /** Lets the client get new tokens without the user, through `refreshToken`. */\n refreshToken?: string\n}\n\n/** Another service, e.g. your identity provider, is the authorization server. */\nexport type MCPExternalOAuthConfig = {\n /**\n * The authorization servers that issue access tokens for MCP clients. Clients require each one\n * to exactly match the `issuer` in that server's metadata, so pass a function when the exact\n * value is only known at runtime, e.g. from the server's OpenID configuration or per host.\n */\n authorizationServers: ((args: { req: PayloadRequest }) => MaybePromise<string[]>) | string[]\n /**\n * Scopes MCP clients should request, e.g. `['openid', 'email', 'profile']`. Without them,\n * clients request none, which some authorization servers reject or answer with a token that\n * doesn't identify the user.\n */\n scopes?: string[]\n type: 'external'\n} & MCPOAuthSharedConfig\n\ntype MCPOAuthSharedConfig = {\n /**\n * Called on MCP requests with a bearer token that Payload's auth strategies didn't accept.\n * Return the Payload user, including its `collection`, or `null` to answer with the OAuth challenge.\n */\n authenticate?: (args: {\n req: PayloadRequest\n token: string\n }) => MaybePromise<PayloadRequest['user']>\n /**\n * The URL clients call to reach the MCP endpoint. The metadata link and the built-in\n * authorization server's issuer are based on it.\n *\n * @default the absolute URL of `/api/mcp`, based on `serverURL` or the request URL\n */\n resource?: ((args: { req: PayloadRequest }) => string) | string\n}\n\nexport type SanitizedMCPPluginConfig = {\n items: MCPItem[]\n /** `undefined` when OAuth is turned off. */\n oauth?: MCPOAuthConfig\n} & Pick<MCPPluginConfig, 'access' | '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":"AAwdA;;;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"}
@@ -0,0 +1,17 @@
1
+ import type { PayloadRequest } from 'payload';
2
+ /**
3
+ * Encrypts data for the client to hold, so it doesn't need to be stored. `type` keeps one kind
4
+ * from being used as another, e.g. a client ID as an authorization code.
5
+ */
6
+ export declare const seal: ({ type, data, expiresInSeconds, req, }: {
7
+ data: object;
8
+ expiresInSeconds?: number;
9
+ req: PayloadRequest;
10
+ type: string;
11
+ }) => string;
12
+ export declare const unseal: <T>({ type, req, value, }: {
13
+ req: PayloadRequest;
14
+ type: string;
15
+ value: null | string;
16
+ }) => T | undefined;
17
+ //# sourceMappingURL=seal.d.ts.map