--- title: Caching product: vercel url: /docs/agent-resources/vercel-mcp/tools/caching canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/caching" last_updated: 2018-10-20 type: reference prerequisites: - /docs/agent-resources/vercel-mcp/tools - /docs/agent-resources/vercel-mcp related: [] summary: Vercel MCP tools for caching. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Caching Manage cached build artifacts and check Remote Caching status for your account or team. You can also invalidate cached content by tag or source image when it needs to refresh. ## `artifact_query` Query information about an artifact. ## Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------- | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | Yes | Request body for this tool. | ## `invalidate_by_src_images` Invalidate by source image. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | --------------------------- | | `projectIdOrName` | string | Yes | The project ID or name. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `invalidate_by_tags` Invalidate by tag. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ------ | -------- | --------------------------- | | `projectIdOrName` | string | Yes | The project ID or name. | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | object | No | Request body for this tool. | ## `record_events` Record an artifacts cache usage event. ## Parameters | Parameter | Type | Required | Description | | ---------------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------- | | `xArtifactClientCi` | string | No | The continuous integration or delivery environment where this artifact is downloaded. | | `xArtifactClientInteractive` | integer | No | 1 if the client is an interactive shell. Otherwise 0 | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | Array\ | Yes | Request body for this tool. | ## `status` Get status of Remote Caching for this principal. ## Parameters | Parameter | Type | Required | Description | | --------- | ------ | -------- | ----------- | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | ## `upload_artifact` Upload a cache artifact. ## Parameters | Parameter | Type | Required | Description | | ---------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `contentLength` | number | No | The artifact size in bytes | | `xArtifactDuration` | number | No | The time taken to generate the uploaded artifact in milliseconds. | | `xArtifactClientCi` | string | No | The continuous integration or delivery environment where this artifact was generated. | | `xArtifactClientInteractive` | integer | No | 1 if the client is an interactive shell. Otherwise 0 | | `xArtifactTag` | string | No | The base64 encoded tag for this artifact. The value is sent back to clients when the artifact is downloaded as the header `x-artifact-tag` | | `xArtifactSha` | string | No | The SHA of the source control revision that generated this artifact. | | `xArtifactDirtyHash` | string | No | A hash representing uncommitted changes in the working directory when this artifact was generated. | | `hash` | string | Yes | The artifact hash | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | | `requestBody` | string | Yes | Provide this binary value as a base64 string. | --- [View full sitemap](/docs/sitemap)