@vercel/sdk 1.5.0 → 1.6.1

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 (274) hide show
  1. package/README.md +40 -12
  2. package/bin/mcp-server.js +9527 -2360
  3. package/bin/mcp-server.js.map +60 -62
  4. package/docs/sdks/marketplace/README.md +0 -6
  5. package/docs/sdks/security/README.md +8 -2
  6. package/docs/sdks/teams/README.md +0 -2
  7. package/esm/__tests__/apiexperimentation.test.js +3 -15
  8. package/esm/__tests__/apiexperimentation.test.js.map +1 -1
  9. package/esm/__tests__/marketplace.test.js +6 -3
  10. package/esm/__tests__/marketplace.test.js.map +1 -1
  11. package/esm/__tests__/projects.test.js +13 -15
  12. package/esm/__tests__/projects.test.js.map +1 -1
  13. package/esm/__tests__/security.test.js +0 -10
  14. package/esm/__tests__/security.test.js.map +1 -1
  15. package/esm/__tests__/teams.test.js +3 -48
  16. package/esm/__tests__/teams.test.js.map +1 -1
  17. package/esm/funcs/deploymentsGetDeployments.js +2 -0
  18. package/esm/funcs/deploymentsGetDeployments.js.map +1 -1
  19. package/esm/funcs/deploymentsUploadFile.js +2 -1
  20. package/esm/funcs/deploymentsUploadFile.js.map +1 -1
  21. package/esm/funcs/projectsCreateProjectTransferRequest.js +3 -2
  22. package/esm/funcs/projectsCreateProjectTransferRequest.js.map +1 -1
  23. package/esm/funcs/teamsGetTeamMembers.js +2 -8
  24. package/esm/funcs/teamsGetTeamMembers.js.map +1 -1
  25. package/esm/hooks/types.d.ts +1 -1
  26. package/esm/hooks/types.d.ts.map +1 -1
  27. package/esm/lib/config.d.ts +3 -3
  28. package/esm/lib/config.js +3 -3
  29. package/esm/lib/security.d.ts +4 -3
  30. package/esm/lib/security.d.ts.map +1 -1
  31. package/esm/lib/security.js +6 -1
  32. package/esm/lib/security.js.map +1 -1
  33. package/esm/mcp-server/extensions.d.ts +2 -0
  34. package/esm/mcp-server/extensions.d.ts.map +1 -1
  35. package/esm/mcp-server/mcp-server.js +1 -1
  36. package/esm/mcp-server/prompts.d.ts +26 -0
  37. package/esm/mcp-server/prompts.d.ts.map +1 -0
  38. package/esm/mcp-server/prompts.js +47 -0
  39. package/esm/mcp-server/prompts.js.map +1 -0
  40. package/esm/mcp-server/resources.d.ts.map +1 -1
  41. package/esm/mcp-server/resources.js +11 -2
  42. package/esm/mcp-server/resources.js.map +1 -1
  43. package/esm/mcp-server/server.d.ts.map +1 -1
  44. package/esm/mcp-server/server.js +5 -6
  45. package/esm/mcp-server/server.js.map +1 -1
  46. package/esm/mcp-server/tools.d.ts.map +1 -1
  47. package/esm/mcp-server/tools.js +5 -3
  48. package/esm/mcp-server/tools.js.map +1 -1
  49. package/esm/models/addbypassipop.d.ts +2 -0
  50. package/esm/models/addbypassipop.d.ts.map +1 -1
  51. package/esm/models/addbypassipop.js +4 -0
  52. package/esm/models/addbypassipop.js.map +1 -1
  53. package/esm/models/authtoken.d.ts +46 -46
  54. package/esm/models/authtoken.d.ts.map +1 -1
  55. package/esm/models/authtoken.js +63 -61
  56. package/esm/models/authtoken.js.map +1 -1
  57. package/esm/models/authuser.d.ts +22 -66
  58. package/esm/models/authuser.d.ts.map +1 -1
  59. package/esm/models/authuser.js +12 -74
  60. package/esm/models/authuser.js.map +1 -1
  61. package/esm/models/canceldeploymentop.d.ts +20 -5
  62. package/esm/models/canceldeploymentop.d.ts.map +1 -1
  63. package/esm/models/canceldeploymentop.js +12 -3
  64. package/esm/models/canceldeploymentop.js.map +1 -1
  65. package/esm/models/createconfigurablelogdrainop.d.ts +62 -59
  66. package/esm/models/createconfigurablelogdrainop.d.ts.map +1 -1
  67. package/esm/models/createconfigurablelogdrainop.js +49 -48
  68. package/esm/models/createconfigurablelogdrainop.js.map +1 -1
  69. package/esm/models/createdeploymentop.d.ts +169 -154
  70. package/esm/models/createdeploymentop.d.ts.map +1 -1
  71. package/esm/models/createdeploymentop.js +167 -162
  72. package/esm/models/createdeploymentop.js.map +1 -1
  73. package/esm/models/createlogdrainop.d.ts +3 -0
  74. package/esm/models/createlogdrainop.d.ts.map +1 -1
  75. package/esm/models/createlogdrainop.js +1 -0
  76. package/esm/models/createlogdrainop.js.map +1 -1
  77. package/esm/models/createprojectop.d.ts +102 -96
  78. package/esm/models/createprojectop.d.ts.map +1 -1
  79. package/esm/models/createprojectop.js +117 -116
  80. package/esm/models/createprojectop.js.map +1 -1
  81. package/esm/models/createprojecttransferrequestop.d.ts +35 -0
  82. package/esm/models/createprojecttransferrequestop.d.ts.map +1 -1
  83. package/esm/models/createprojecttransferrequestop.js +38 -0
  84. package/esm/models/createprojecttransferrequestop.js.map +1 -1
  85. package/esm/models/createrecordop.d.ts +69 -69
  86. package/esm/models/createrecordop.d.ts.map +1 -1
  87. package/esm/models/createrecordop.js +85 -92
  88. package/esm/models/createrecordop.js.map +1 -1
  89. package/esm/models/deleteteamop.d.ts +15 -15
  90. package/esm/models/deleteteamop.d.ts.map +1 -1
  91. package/esm/models/deleteteamop.js +15 -15
  92. package/esm/models/deleteteamop.js.map +1 -1
  93. package/esm/models/getaliasop.d.ts +15 -15
  94. package/esm/models/getaliasop.d.ts.map +1 -1
  95. package/esm/models/getaliasop.js +15 -15
  96. package/esm/models/getaliasop.js.map +1 -1
  97. package/esm/models/getalllogdrainsop.d.ts +62 -59
  98. package/esm/models/getalllogdrainsop.d.ts.map +1 -1
  99. package/esm/models/getalllogdrainsop.js +46 -45
  100. package/esm/models/getalllogdrainsop.js.map +1 -1
  101. package/esm/models/getauthuserop.d.ts +13 -13
  102. package/esm/models/getauthuserop.d.ts.map +1 -1
  103. package/esm/models/getauthuserop.js +13 -14
  104. package/esm/models/getauthuserop.js.map +1 -1
  105. package/esm/models/getconfigurablelogdrainop.d.ts +62 -59
  106. package/esm/models/getconfigurablelogdrainop.d.ts.map +1 -1
  107. package/esm/models/getconfigurablelogdrainop.js +46 -45
  108. package/esm/models/getconfigurablelogdrainop.js.map +1 -1
  109. package/esm/models/getconfigurationop.d.ts +312 -0
  110. package/esm/models/getconfigurationop.d.ts.map +1 -1
  111. package/esm/models/getconfigurationop.js +298 -0
  112. package/esm/models/getconfigurationop.js.map +1 -1
  113. package/esm/models/getconfigurationsop.d.ts +6 -0
  114. package/esm/models/getconfigurationsop.d.ts.map +1 -1
  115. package/esm/models/getconfigurationsop.js +2 -0
  116. package/esm/models/getconfigurationsop.js.map +1 -1
  117. package/esm/models/getdeploymentop.d.ts +26 -8
  118. package/esm/models/getdeploymentop.d.ts.map +1 -1
  119. package/esm/models/getdeploymentop.js +14 -4
  120. package/esm/models/getdeploymentop.js.map +1 -1
  121. package/esm/models/getdeploymentsop.d.ts +16 -3
  122. package/esm/models/getdeploymentsop.d.ts.map +1 -1
  123. package/esm/models/getdeploymentsop.js +6 -1
  124. package/esm/models/getdeploymentsop.js.map +1 -1
  125. package/esm/models/getdomainconfigop.d.ts +7 -0
  126. package/esm/models/getdomainconfigop.d.ts.map +1 -1
  127. package/esm/models/getdomainconfigop.js +4 -0
  128. package/esm/models/getdomainconfigop.js.map +1 -1
  129. package/esm/models/getfirewallconfigop.d.ts +15 -15
  130. package/esm/models/getfirewallconfigop.d.ts.map +1 -1
  131. package/esm/models/getfirewallconfigop.js +15 -16
  132. package/esm/models/getfirewallconfigop.js.map +1 -1
  133. package/esm/models/getintegrationlogdrainsop.d.ts +3 -0
  134. package/esm/models/getintegrationlogdrainsop.d.ts.map +1 -1
  135. package/esm/models/getintegrationlogdrainsop.js +1 -0
  136. package/esm/models/getintegrationlogdrainsop.js.map +1 -1
  137. package/esm/models/getinvoiceop.d.ts +159 -48
  138. package/esm/models/getinvoiceop.d.ts.map +1 -1
  139. package/esm/models/getinvoiceop.js +26 -23
  140. package/esm/models/getinvoiceop.js.map +1 -1
  141. package/esm/models/getprojectenvop.d.ts +0 -2
  142. package/esm/models/getprojectenvop.d.ts.map +1 -1
  143. package/esm/models/getprojectenvop.js +0 -2
  144. package/esm/models/getprojectenvop.js.map +1 -1
  145. package/esm/models/getprojectsop.d.ts +6 -0
  146. package/esm/models/getprojectsop.d.ts.map +1 -1
  147. package/esm/models/getprojectsop.js +2 -0
  148. package/esm/models/getprojectsop.js.map +1 -1
  149. package/esm/models/getteammembersop.d.ts +0 -5
  150. package/esm/models/getteammembersop.d.ts.map +1 -1
  151. package/esm/models/getteammembersop.js +0 -2
  152. package/esm/models/getteammembersop.js.map +1 -1
  153. package/esm/models/getteamsop.d.ts +13 -13
  154. package/esm/models/getteamsop.d.ts.map +1 -1
  155. package/esm/models/getteamsop.js +13 -14
  156. package/esm/models/getteamsop.js.map +1 -1
  157. package/esm/models/importresourceop.d.ts +64 -0
  158. package/esm/models/importresourceop.d.ts.map +1 -1
  159. package/esm/models/importresourceop.js +64 -0
  160. package/esm/models/importresourceop.js.map +1 -1
  161. package/esm/models/inviteusertoteamop.d.ts +32 -32
  162. package/esm/models/inviteusertoteamop.d.ts.map +1 -1
  163. package/esm/models/inviteusertoteamop.js +49 -49
  164. package/esm/models/inviteusertoteamop.js.map +1 -1
  165. package/esm/models/submitinvoiceop.d.ts +9 -0
  166. package/esm/models/submitinvoiceop.d.ts.map +1 -1
  167. package/esm/models/submitinvoiceop.js.map +1 -1
  168. package/esm/models/updatefirewallconfigop.d.ts +95 -95
  169. package/esm/models/updatefirewallconfigop.d.ts.map +1 -1
  170. package/esm/models/updatefirewallconfigop.js +119 -121
  171. package/esm/models/updatefirewallconfigop.js.map +1 -1
  172. package/esm/models/updateinvoiceop.d.ts +8 -8
  173. package/esm/models/updateinvoiceop.d.ts.map +1 -1
  174. package/esm/models/updateinvoiceop.js +12 -13
  175. package/esm/models/updateinvoiceop.js.map +1 -1
  176. package/esm/models/updateprojectdatacacheop.d.ts +124 -118
  177. package/esm/models/updateprojectdatacacheop.d.ts.map +1 -1
  178. package/esm/models/updateprojectdatacacheop.js +146 -144
  179. package/esm/models/updateprojectdatacacheop.js.map +1 -1
  180. package/esm/models/updateprojectop.d.ts +179 -173
  181. package/esm/models/updateprojectop.d.ts.map +1 -1
  182. package/esm/models/updateprojectop.js +191 -192
  183. package/esm/models/updateprojectop.js.map +1 -1
  184. package/esm/models/uploadfileop.d.ts +2 -0
  185. package/esm/models/uploadfileop.d.ts.map +1 -1
  186. package/esm/models/uploadfileop.js +14 -0
  187. package/esm/models/uploadfileop.js.map +1 -1
  188. package/esm/models/userevent.d.ts +14408 -2
  189. package/esm/models/userevent.d.ts.map +1 -1
  190. package/esm/models/userevent.js +13247 -2
  191. package/esm/models/userevent.js.map +1 -1
  192. package/esm/sdk/sdk.d.ts +0 -3
  193. package/esm/sdk/sdk.d.ts.map +1 -1
  194. package/esm/sdk/sdk.js +0 -4
  195. package/esm/sdk/sdk.js.map +1 -1
  196. package/jsr.json +1 -1
  197. package/package.json +1 -1
  198. package/src/__tests__/apiexperimentation.test.ts +5 -17
  199. package/src/__tests__/marketplace.test.ts +9 -3
  200. package/src/__tests__/projects.test.ts +13 -15
  201. package/src/__tests__/security.test.ts +0 -10
  202. package/src/__tests__/teams.test.ts +5 -50
  203. package/src/funcs/deploymentsGetDeployments.ts +2 -0
  204. package/src/funcs/deploymentsUploadFile.ts +2 -1
  205. package/src/funcs/projectsCreateProjectTransferRequest.ts +3 -2
  206. package/src/funcs/teamsGetTeamMembers.ts +2 -9
  207. package/src/hooks/types.ts +1 -1
  208. package/src/lib/config.ts +3 -3
  209. package/src/lib/security.ts +11 -3
  210. package/src/mcp-server/extensions.ts +4 -0
  211. package/src/mcp-server/mcp-server.ts +1 -1
  212. package/src/mcp-server/prompts.ts +117 -0
  213. package/src/mcp-server/resources.ts +17 -2
  214. package/src/mcp-server/server.ts +6 -6
  215. package/src/mcp-server/tools.ts +7 -3
  216. package/src/models/addbypassipop.ts +6 -0
  217. package/src/models/authtoken.ts +100 -88
  218. package/src/models/authuser.ts +36 -166
  219. package/src/models/canceldeploymentop.ts +24 -7
  220. package/src/models/createconfigurablelogdrainop.ts +76 -75
  221. package/src/models/createdeploymentop.ts +362 -289
  222. package/src/models/createlogdrainop.ts +1 -0
  223. package/src/models/createprojectop.ts +217 -186
  224. package/src/models/createprojecttransferrequestop.ts +96 -0
  225. package/src/models/createrecordop.ts +207 -183
  226. package/src/models/deleteteamop.ts +34 -27
  227. package/src/models/getaliasop.ts +28 -24
  228. package/src/models/getalllogdrainsop.ts +72 -71
  229. package/src/models/getauthuserop.ts +29 -19
  230. package/src/models/getconfigurablelogdrainop.ts +70 -69
  231. package/src/models/getconfigurationop.ts +581 -0
  232. package/src/models/getconfigurationsop.ts +2 -0
  233. package/src/models/getdeploymentop.ts +28 -10
  234. package/src/models/getdeploymentsop.ts +18 -3
  235. package/src/models/getdomainconfigop.ts +11 -0
  236. package/src/models/getfirewallconfigop.ts +40 -33
  237. package/src/models/getintegrationlogdrainsop.ts +1 -0
  238. package/src/models/getinvoiceop.ts +158 -47
  239. package/src/models/getprojectenvop.ts +0 -4
  240. package/src/models/getprojectsop.ts +2 -0
  241. package/src/models/getteammembersop.ts +0 -7
  242. package/src/models/getteamsop.ts +25 -20
  243. package/src/models/importresourceop.ts +141 -0
  244. package/src/models/inviteusertoteamop.ts +79 -79
  245. package/src/models/submitinvoiceop.ts +9 -0
  246. package/src/models/updatefirewallconfigop.ts +246 -210
  247. package/src/models/updateinvoiceop.ts +16 -14
  248. package/src/models/updateprojectdatacacheop.ts +270 -252
  249. package/src/models/updateprojectop.ts +371 -305
  250. package/src/models/uploadfileop.ts +26 -0
  251. package/src/models/userevent.ts +28245 -4
  252. package/src/sdk/sdk.ts +0 -6
  253. package/vercel-spec.json +8586 -925
  254. package/docs/sdks/apiexperimentation/README.md +0 -82
  255. package/esm/funcs/apiExperimentationGetV1ExperimentationItems.d.ts +0 -15
  256. package/esm/funcs/apiExperimentationGetV1ExperimentationItems.d.ts.map +0 -1
  257. package/esm/funcs/apiExperimentationGetV1ExperimentationItems.js +0 -81
  258. package/esm/funcs/apiExperimentationGetV1ExperimentationItems.js.map +0 -1
  259. package/esm/mcp-server/tools/apiExperimentationGetV1ExperimentationItems.d.ts +0 -7
  260. package/esm/mcp-server/tools/apiExperimentationGetV1ExperimentationItems.d.ts.map +0 -1
  261. package/esm/mcp-server/tools/apiExperimentationGetV1ExperimentationItems.js +0 -26
  262. package/esm/mcp-server/tools/apiExperimentationGetV1ExperimentationItems.js.map +0 -1
  263. package/esm/models/getv1experimentationitemsop.d.ts +0 -148
  264. package/esm/models/getv1experimentationitemsop.d.ts.map +0 -1
  265. package/esm/models/getv1experimentationitemsop.js +0 -125
  266. package/esm/models/getv1experimentationitemsop.js.map +0 -1
  267. package/esm/sdk/apiexperimentation.d.ts +0 -9
  268. package/esm/sdk/apiexperimentation.d.ts.map +0 -1
  269. package/esm/sdk/apiexperimentation.js +0 -15
  270. package/esm/sdk/apiexperimentation.js.map +0 -1
  271. package/src/funcs/apiExperimentationGetV1ExperimentationItems.ts +0 -180
  272. package/src/mcp-server/tools/apiExperimentationGetV1ExperimentationItems.ts +0 -37
  273. package/src/models/getv1experimentationitemsop.ts +0 -287
  274. package/src/sdk/apiexperimentation.ts +0 -27
package/README.md CHANGED
@@ -85,7 +85,7 @@ yarn add @vercel/sdk zod
85
85
  This SDK is also an installable MCP server where the various SDK methods are
86
86
  exposed as tools that can be invoked by AI applications.
87
87
 
88
- > Node.js v20 or greater is required to run the MCP server.
88
+ > Node.js v20 or greater is required to run the MCP server from npm.
89
89
 
90
90
  <details>
91
91
  <summary>Claude installation steps</summary>
@@ -113,17 +113,50 @@ Add the following server definition to your `claude_desktop_config.json` file:
113
113
  <details>
114
114
  <summary>Cursor installation steps</summary>
115
115
 
116
- Go to `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
116
+ Create a `.cursor/mcp.json` file in your project root with the following content:
117
117
 
118
- - Name: Vercel
119
- - Type: `command`
120
- - Command:
121
- ```sh
122
- npx -y --package @vercel/sdk -- mcp start --bearer-token ...
118
+ ```json
119
+ {
120
+ "mcpServers": {
121
+ "Vercel": {
122
+ "command": "npx",
123
+ "args": [
124
+ "-y", "--package", "@vercel/sdk",
125
+ "--",
126
+ "mcp", "start",
127
+ "--bearer-token", "..."
128
+ ]
129
+ }
130
+ }
131
+ }
123
132
  ```
124
133
 
125
134
  </details>
126
135
 
136
+ You can also run MCP servers as a standalone binary with no additional dependencies. You must pull these binaries from available Github releases:
137
+
138
+ ```bash
139
+ curl -L -o mcp-server \
140
+ https://github.com/{org}/{repo}/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
141
+ chmod +x mcp-server
142
+ ```
143
+
144
+ If the repo is a private repo you must add your Github PAT to download a release `-H "Authorization: Bearer {GITHUB_PAT}"`.
145
+
146
+
147
+ ```json
148
+ {
149
+ "mcpServers": {
150
+ "Todos": {
151
+ "command": "./DOWNLOAD/PATH/mcp-server",
152
+ "args": [
153
+ "start"
154
+ ]
155
+ }
156
+ }
157
+ }
158
+ ```
159
+
127
160
  For a full list of server arguments, run:
128
161
 
129
162
  ```sh
@@ -276,10 +309,6 @@ run();
276
309
  * [getAlias](docs/sdks/aliases/README.md#getalias) - Get an Alias
277
310
  * [deleteAlias](docs/sdks/aliases/README.md#deletealias) - Delete an Alias
278
311
 
279
- ### [apiExperimentation](docs/sdks/apiexperimentation/README.md)
280
-
281
- * [getV1ExperimentationItems](docs/sdks/apiexperimentation/README.md#getv1experimentationitems) - Query experimentation items
282
-
283
312
  ### [artifacts](docs/sdks/artifacts/README.md)
284
313
 
285
314
  * [recordEvents](docs/sdks/artifacts/README.md#recordevents) - Record an artifacts cache usage event
@@ -515,7 +544,6 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
515
544
  - [`aliasesGetAlias`](docs/sdks/aliases/README.md#getalias) - Get an Alias
516
545
  - [`aliasesListAliases`](docs/sdks/aliases/README.md#listaliases) - List aliases
517
546
  - [`aliasesListDeploymentAliases`](docs/sdks/aliases/README.md#listdeploymentaliases) - List Deployment Aliases
518
- - [`apiExperimentationGetV1ExperimentationItems`](docs/sdks/apiexperimentation/README.md#getv1experimentationitems) - Query experimentation items
519
547
  - [`artifactsArtifactExists`](docs/sdks/artifacts/README.md#artifactexists) - Check if a cache artifact exists
520
548
  - [`artifactsArtifactQuery`](docs/sdks/artifacts/README.md#artifactquery) - Query information about an artifact
521
549
  - [`artifactsDownloadArtifact`](docs/sdks/artifacts/README.md#downloadartifact) - Download a cache artifact