Get View Image
Retrieves an image of the specified view in a Tableau workbook. Optional width and height in
pixels control the render size, and optional view filters narrow the data shown. For custom views,
use get-custom-view-image instead.
APIs called
The tool renders the requested view through the Tableau REST API (Tableau Cloud or Server). The
MCP-layer OAuth scope is tableau:mcp:view:download; across the calls below it needs the
tableau:views:download, tableau:content:read, and tableau:mcp_site_settings:read OAuth scopes.
- Render the specified view as an image at the requested size, format, and filters.
GET /api/{version}/sites/{siteId}/views/{viewId}/image— return the rendered image. Issued against the Tableau REST API; requires thetableau:views:downloadOAuth scope. Query View Image
- When tool scoping (bounded context) is enabled,
verify the requested view is within the allowed set before rendering.
GET /api/{version}/sites/{siteId}/views/{viewId}— fetch the view's workbook, project, and tags for the access check. Issued against the Tableau REST API; requires thetableau:content:readandtableau:mcp_site_settings:readOAuth scopes. Get View
Required arguments
viewId
The ID of the view, potentially retrieved by the List Views or Get Workbook tool.
Example: 9460abfe-a6b2-49d1-b998-39e1ebcc55ce
Optional arguments
width
The width of the rendered image in pixels that, along with the value of height, determines its
resolution and aspect ratio.
Example: 1600
height
The height of the rendered image in pixels that, along with the value of width, determines its
resolution and aspect ratio.
Example: 1200
format
The format of the image. Defaults to PNG.
PNG(default): Raster image format. Works with all Tableau Server versions.SVG: Vector graphics format. Scalable and smaller file size. Requires Tableau Server 2026.2.0+ (REST API v3.29+).
Example: SVG
Choosing a format
- Prefer
PNGwhen the image will be analyzed or interpreted (e.g. answering questions about the data in the viz). - Prefer
SVGwhen the image will be displayed to the user (e.g. embedding or rendering the viz in a response).
Requesting SVG against a Tableau Server older than 2026.2.0 is rejected with a validation error:
SVG format requires Tableau Server 2026.2.0 or later. Current version: the message includes the
connected server's product version. If the image-format feature is disabled on the Tableau Server,
the tool reports that the feature is unavailable.
viewFilters
Map of view filter field names to values. The vf_ prefix for field names is optional and will be
added automatically when building the view filter query.
Example: { "year": "2017" }
Example result
- When
formatisPNG, the MCP result will contain the PNG image content (MCP result withtype=imageandmimeType=image/png). - When
formatisSVG, the MCP result will contain both the SVG XML (type=text) and the SVG image content (type=imageandmimeType=image/svg+xml).

Related
get-view-data— retrieve the specified view's underlying data as CSVget-custom-view-image— render an image of a custom viewlist-views— find theviewIdfor a view on the site
Response behavior
The tool returns one of two result shapes:
MCP_S3_BUCKETunset (default): returns the rendered image inline, base64-encoded.MCP_S3_BUCKETset: returns aresource_linkwith a short-lived presigned URL to the rendered image in S3 (withmimeTypematchingformat), instead of inlining the image data.
Example result (S3 mode)
{
"type": "resource_link",
"uri": "https://example-bucket.s3.amazonaws.com/...presigned...",
"name": "view-image.png",
"mimeType": "image/png",
"description": "Rendered view image stored in S3. This is a short-lived presigned URL."
}