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 to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.
`requestBody`	object	Yes	Request body for this tool.

`get_remote_cache_status`

Get the status of Remote Caching for this principal.

Parameters

Parameter	Type	Required	Description
`teamId`	string	No	Team ID to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.

`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 to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.
`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 to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.
`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 Minimum: 0. Maximum: 1.
`teamId`	string	No	Team ID to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.
`requestBody`	Array<object>	Yes	Request body for this tool.

`upload_artifact`

Upload a cache artifact.

Parameters

Parameter	Type	Required	Description
`contentLength`	number	Yes	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 Minimum: 0. Maximum: 1.
`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 to use for this operation.
`slug`	string	No	Team slug to use for this operation. Use instead of teamId.
`requestBody`	string	Yes	Provide this binary value as a base64 string.

Cross-link map: Caching (/docs/agent-resources/vercel-mcp/tools/caching)

From the Vercel docs graph (built 2026-10-13T05:35:52.211Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Upload a cache artifact — PUT /v8/artifacts/{hash} — Uploads a cache artifact identified by the \hash\\ specified on the path. The cache artifact
upload_artifact — Use upload_artifact with Vercel MCP.
Download a cache artifact — GET /v8/artifacts/{hash} — Downloads a cache artifact indentified by its \hash\\ specified on the request path. The art
Check if a cache artifact exists — HEAD /v8/artifacts/{hash} — Check that a cache artifact with the given \hash\\ exists. This request returns response he
Record an artifacts cache usage event — POST /v8/artifacts/events — Records an artifacts cache usage event. The body of this request is an array of cache usage

Prerequisites

Agent Resources — Set up AI coding tools with Vercel documentation, reusable skills, and secure access to projects, deployments, and logs.

Billing and Purchases

artifact_query

Was this helpful?