Get View
Retrieves information about the specified view, including its upstream datasources, workbook information, project details, owner, tags, and usage statistics. To retrieve the view's data or an image instead of its metadata, use Get View Data or Get View Image.
APIs called
This tool talks to the Tableau REST API (Tableau Cloud or Server) to fetch the view, then
enriches it with upstream lineage from the Metadata API (GraphQL). The MCP-layer OAuth gate
requires the tableau:content:read OAuth scope plus tableau:mcp_site_settings:read to read
per-site MCP configuration overrides when MCP site settings are enabled.
- Fetch the view with usage statistics. Retrieves the view identified by
viewId. This call also serves the tool scoping bounded-context check — when tool scoping is enabled, the view must be within the allowed content or the tool refuses the request.GET /api/{version}/sites/{siteId}/views/{viewId}— retrieve the view (with usage statistics). Issued against the Tableau REST API; requires thetableau:content:readOAuth scope (the tool-scoping check also reads MCP site settings with thetableau:mcp_site_settings:readscope). Get View
- Enrich the view with lineage metadata. Looks up the view's upstream datasources to attach
datasource context. Skipped when
DISABLE_METADATA_API_REQUESTS=true; if the lookup fails, the tool logs a warning and returns the view without lineage enrichment.POST /api/metadata/graphql— query the view's upstream lineage. Issued against the Metadata API (GraphQL); requires thetableau:content:readOAuth scope. Metadata API
Required arguments
viewId
The ID of the view, potentially retrieved by the List Views or Get Workbook tool. This is the view LUID from the content URL, not the published view id.
Example: 9460abfe-a6b2-49d1-b998-39e1ebcc55ce
Example result
{
"data": {
"id": "9460abfe-a6b2-49d1-b998-39e1ebcc55ce",
"name": "Overview",
"contentUrl": "Superstore/sheets/Overview",
"createdAt": "2025-09-02T23:25:58Z",
"updatedAt": "2025-09-02T23:25:58Z",
"workbook": {
"id": "222ea993-9391-4910-a167-56b3d19b4e3b"
},
"owner": {
"id": "d2a1e1df-af8e-4f43-a4cc-34858b7f8b69"
},
"project": {
"id": "cbec32db-a4a2-4308-b5f0-4fc67322f359"
},
"tags": {},
"usage": {
"totalViewCount": 42
},
"upstreamDatasources": [
{
"luid": "2d935df8-fe7e-4fd8-bb14-35eb4ba31d45",
"name": "Superstore"
}
]
},
"url": "https://my-tableau-server.example.com/#/site/my-site/views/Superstore/Overview"
}
The upstreamDatasources array is populated from the Metadata API. It is omitted when metadata
requests are disabled, when the lineage lookup fails, or when the view has no discoverable upstream
datasources.
Related
get-view-data— retrieve the view's data as CSV instead of its metadataget-view-image— retrieve an image of the view instead of its metadatalist-views— find theviewIdfor a view on the siteget-workbook— list the views that belong to a workbook