Skip to main content

Site Settings

Tableau MCP supports configuration on a per-site basis via REST API. When a Tableau MCP user is authenticated to a given site, the site's configuration is fetched and applied to their session such that each setting will override any current value set by the Tableau MCP server.

In order to use site settings:

  • Only available in Tableau versions 2026.2 or higher.
  • Site settings must be enabled by the Tableau MCP server, see ENABLE_MCP_SITE_SETTINGS.

Configuring Site Settings​

Only site and server administrators are able to configure Tableau MCP site settings. Not every Tableau MCP configuration variable is overridable with site settings, only the ones listed as Site Overridable Variables.

When creating or updating site settings via REST API:

  • To use a variable's default value or clear limits and bounds set by the Tableau MCP server, you can provide an empty string as the override value.
  • To remove an override variable from the list of site settings and restore its value back to what is set by the Tableau MCP server, you can POST the current list of site settings minus the variable you want to remove or include the variable in a PUT request with a null value or omit the value property entirely.
warning

When configuring site settings, make sure to validate your overrides have been applied successfully. Tableau MCP will ignore any overrides if it does not recognize the variable being overriden, or if the override value is invalid.

You might not see changes take immediate effect due to caching, see MCP_SITE_SETTINGS_CHECK_INTERVAL_IN_MINUTES.

Site Overridable Variables​