Tableau MCP Methods


Using the Tableau MCP methods of the REST API you can:

  • Get Tableau MCP Site Settings
  • Create or update Tableau MCP Site Settings

The functionality in these methods relates to Tableau MCP Site Settings concepts described at: Configurating Tableau MCP - Site Settings(Link opens in a new window).

Create Tableau MCP Settings for Site

Replaces the current list of Tableau MCP settings to override for a given site.

Version: Available in API 3.29 (Tableau Cloud June 2026 / Server 2026.2) and later.

License: No additional license required.

Permissions: Server administrators and site administrators.

Access Scope: tableau:mcp_site_settings:create

For more information, see Versions(Link opens in a new window), Permissions(Link opens in a new window), Access scopes for UATs(Link opens in a new window) (Cloud), and access scopes for Cloud(Link opens in a new window), Server-Windows,(Link opens in a new window) or Server-Linux(Link opens in a new window).

For more information about configuring the Tableau MCP settings for a site, see Site settings for Tableau MCP(Link opens in a new window).

URI

POST /api/api-version/sites/site-id/settings/mcp

URI Parameter Values

api-version The version of the API to use, such as 3.29. For more information, see REST API and Resource Versions.
site-id The ID of the site.

Request Body

<tsRequest>
    <mcpSiteSettings>
        <settings>
            <key>mcp-setting-key</key>
            <value>mcp-setting-value</value>
        </settings>
    </mcpSiteSettings>
</tsRequest>
{
  "mcpSiteSettings": {
    "settings": [
      {
        "key": "mcp-setting-key",
        "value": "mcp-setting-value"
      }
    ]
  }
}

Attribute Values

mcp-setting-key (Required) String. Specifies the setting to assign a value to.

mcp-setting-value

(Required) String. Provides the value for the associated key.

Response Code

200

Response Body

<tsResponse>
    <mcpSiteSettings>
        <settings>
            <key>EXCLUDE_TOOLS</key>
            <value>search-content</value>
        </settings>
    </mcpSiteSettings>
</tsResponse>
{
  "mcpSiteSettings": {
    "settings": [
      {
        "key": "EXCLUDE_TOOLS",
        "value": "search-content"
      }
    ]
  }
}

Errors

HTTP status error Code Condition Details
400 409004 Invalid parameter The mcpSiteSettings entity is empty; the settings key is null, missing, or invalid; or site LUID format is invalid.
401 401002 Invalid authentication credentials Missing or invalid authentication credentials.
401 403001 Missing authentication token Authentication token not provided.
403 403000 Insufficient permissions User isn't an administrator.
403 403010 Site mismatch Authenticated user's site does not match the site LUID in the request.
403 403157 Feature disabled Feature not enabled.
403 N/A Insufficient OAuth scope The user lacks the required OAuth scope.
404 404000 Site not found A site with the specified LUID does not exist.
500 500000 Internal server error Unknown server error.

For more information, see Handling Errors.

Get Tableau MCP Settings for Site

Gets the list of Tableau MCP settings for a specified site.

Version: Available in API 3.29 (Tableau Cloud June 2026 / Server 2026.2) and later.

License: No additional license required.

Permissions: Any authenticated user.

Access Scope: tableau:mcp_site_settings:read

For more information, see Versions(Link opens in a new window), Permissions(Link opens in a new window), Access scopes for UATs(Link opens in a new window) (Cloud), and access scopes for Cloud(Link opens in a new window), Server-Windows,(Link opens in a new window) or Server-Linux(Link opens in a new window).

For more information about configuring the Tableau MCP settings for a site, see Site settings for Tableau MCP(Link opens in a new window).

URI

GET /api/api-version/sites/site-id/settings/mcp

URI Parameter Values

api-version The version of the API to use, such as 3.29. For more information, see REST API and Resource Versions.
site-id The ID of the site.

Request Body

None

Response Code

200

Response Body

<tsResponse>
    <mcpSiteSettings>
        <settings>
            <key>INCLUDE_TOOLS</key>
            <value>datasource,search-content</value>
        </settings>
        <settings>
            <key>INCLUDE_TAGS</key>
            <value>sales,marketing</value>
        </settings>
        <settings>
            <key>MAX_RESULT_LIMIT</key>
            <value>50</value>
        </settings>
        <settings>
            <key>MAX_RESULT_LIMITS</key>
            <value>query-datasource:1000</value>
        </settings>
    </mcpSiteSettings>
</tsResponse>
{
  "mcpSiteSettings": {
    "settings": [
      {
        "key": "INCLUDE_TOOLS",
        "value": "datasource,search-content"
      },
      {
        "key": "INCLUDE_TAGS",
        "value": "sales,marketing"
      },
      {
        "key": "MAX_RESULT_LIMIT",
        "value": "50"
      },
      {
        "key": "MAX_RESULT_LIMITS",
        "value": "query-datasource:1000"
      }
    ]
  }
}

Errors

HTTP status error Code Condition Details
400 409004 Invalid parameter The site LUID format is invalid.
401 401002 Invalid authentication credentials Missing or invalid authentication credentials.
401 403001 Missing authentication token Authentication token not provided.
403 403010 Site mismatch Authenticated user's site does not match the site LUID in the request.
403 403157 Feature disabled Feature not enabled.
403 N/A Insufficient OAuth scope The user lacks the required OAuth scope.
404 404000 Site not found A site with the specified LUID does not exist.
500 500000 Internal server error Unknown server error.

For more information, see Handling Errors.

Update Tableau MCP Settings for Site

Updates the current list of Tableau MCP settings for a specified site.

Version: Available in API 3.29 (Tableau Cloud June 2026 / Server 2026.2) and later.

License: No additional license required.

Permissions: Server administrators and site administrators.

Access Scope: tableau:mcp_site_settings:update

For more information, see Versions(Link opens in a new window), Permissions(Link opens in a new window), Access scopes for UATs(Link opens in a new window) (Cloud), and access scopes for Cloud(Link opens in a new window), Server-Windows,(Link opens in a new window) or Server-Linux(Link opens in a new window).

For more information about configuring the Tableau MCP settings for a site, see Site settings for Tableau MCP(Link opens in a new window).

URI

PUT /api/api-version/sites/site-id/settings/mcp

URI Parameter Values

api-version The version of the API to use, such as 3.29. For more information, see REST API and Resource Versions.
site-id The ID of the site.

Request Body

<tsRequest>
    <mcpSiteSettings>
        <settings>
            <key>mcp-settings-key</key>
            <value>mcp-settings-value</value>
        </settings>
        <settings>
            <key>mcp-settings-key</key>
        </settings>
        <settings>
            <key>mcp-settings-key</key>
            <value>mcp-settings-value</value>
        </settings>
    </mcpSiteSettings>
</tsRequest>
{
  "mcpSiteSettings": {
    "settings": [
      {
        "key": "mcp-settings-key",
        "value": "mcp-settings-value"
      },
      {
        "key": "mcp-settings-key"
      },
      {
        "key": "mcp-settings-key",
        "value": "mcp-settings-value"
      }
    ]
  }
}

Attribute Values

key (Required) String. Specifies which setting to add, modify, or remove.
value (Optional) String. Provides the value associated with the key. If this property is omitted, then the associated key will be removed from the current Tableau MCP settings for the given site.

Response Code

200

Response Body

<tsResponse>
    <mcpSiteSettings>
        <settings>
            <key>INCLUDE_TOOLS</key>
            <value>datasource,search-content</value>
        </settings>
        <settings>
            <key>INCLUDE_TAGS</key>
            <value>sales,marketing,reviews</value>
        </settings>
        <settings>
            <key>DISABLE_METADATA_API_REQUESTS</key>
            <value>true</value>
        </settings>
        <settings>
            <key>MAX_RESULT_LIMITS</key>
            <value>query-datasource:1000</value>
        </settings>
    </mcpSiteSettings>
</tsResponse>
{
  "mcpSiteSettings": {
    "settings": [
      {
        "key": "INCLUDE_TOOLS",
        "value": "datasource,search-content"
      },
      {
        "key": "INCLUDE_TAGS",
        "value": "sales,marketing,reviews"
      },
      {
        "key": "DISABLE_METADATA_API_REQUESTS",
        "value": "true"
      },
      {
        "key": "MAX_RESULT_LIMITS",
        "value": "query-datasource:1000"
      }
    ]
  }
}

Errors

HTTP status error Code Condition Details
400 409004 Invalid parameter The mcpSiteSettings entity is empty; the settings key is null, missing, or invalid; or site LUID format is invalid.
401 401002 Invalid authentication credentials Missing or invalid authentication credentials.
401 403001 Missing authentication token Authentication token not provided.
403 403000 Insufficient permissions User isn't an administrator
403 403010 Site mismatch Authenticated user's site does not match the site LUID in the request.
403 403157 Feature disabled Feature not enabled.
403 N/A Insufficient OAuth scope The user lacks the required OAuth scope.
404 404000 Site not found A site with the specified LUID does not exist.
500 500000 Internal server error Unknown server error.

For more information, see Handling Errors.


Back to top
Thanks for your feedback!Your feedback has been successfully submitted. Thank you!