> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Add MCP tools to Sigma

> Connect MCP servers to Sigma agents to add context, retrieve ad hoc data, and enable actions in third-party tools.

You can use MCP servers with [Sigma agents](/docs/create-sigma-agents) to add context to your conversation, retrieve ad hoc data, or permit the agent to take action in third-party tools.

The use of AI features is subject to the following [disclaimer](/docs/notice-for-enabling-ai-enabled-features-in-sigma).

To allow a Sigma agent to use an MCP server:

1. [Add the server to Sigma as an MCP tool](#add-an-mcp-server-to-sigma-as-an-mcp-tool).
2. [Grant access to the MCP tool](#grant-access-to-the-mcp-tool).
3. [Add the MCP tool to a Sigma agent](#add-an-mcp-tool-to-a-sigma-agent).

## Requirements

* To add an MCP server as an MCP tool and grant access to the MCP tool, you must be assigned the Admin account type.
* To add an MCP tool to a Sigma agent, you must have **Can edit** access to the workbook that contains the agent, and you must be granted **Can use** access to the MCP tool.

## Add an MCP server to Sigma as an MCP tool

To add an MCP server to Sigma for agents to use as a tool:

1. Go to **Administration** > **MCP tools**.
2. Click **Add MCP tool**.
3. For **Name**, enter a name for the MCP tool. For example, "Sigma documentation". The agent uses the name of the tool as guidance to determine whether to use the tool.
4. For **Description**, enter a description about the MCP tool. Sigma agents use the description to determine whether to use the tool. For example, "Use this tool to answer questions about Sigma's features, functionality, and documentation. Consult it when users ask how to perform a task in Sigma, need troubleshooting help, or want to learn about a specific Sigma feature."
5. For **Base URL**, enter the URL for the MCP server. For example, `https://help.sigmacomputing.com/mcp`.
6. For **Prompt**, enter additional instructions to share with the Sigma agent when using the MCP server, such as guidance for using specific tools. For example, "Use the search tool to search documentation pages and fetch to return details about documentation pages returned by search. Summarize responses to less than 500 characters and provide links to learn more and cite your sources every time."
7. For **Authentication credential**, choose the relevant option for the MCP server:

   * If the MCP server does not require authentication, leave the default of **No authentication** selected. For example, the Sigma documentation MCP server does not require authentication.
   * If the MCP server uses authentication, add an authentication credential. See [Add a new API credential to Sigma](/docs/configure-api-credentials-and-connectors-in-sigma#add-a-new-api-credential-to-sigma) for instructions.
8. Click **Submit**.

   You can test the MCP tool to confirm the definition and authentication work successfully, and list the available tools for the MCP server that you added.

## Grant access to the MCP tool

After adding an MCP tool, grant access to allow other users in Sigma to use the tool:

1. Go to **Administration** > **MCP tools**.

2. Select the MCP tool to which you want to grant access. For example, "Sigma documentation".

3. In the **Connector access** section, click **Grant access**.

4. Search for and select users and teams to which you want to grant access:

   * To grant a user or team access to manage the MCP tool, such as updating the instructions or description, grant **Can edit** access.
   * To grant a user or team access to use the MCP tool, such as by adding the MCP tool to a Sigma agent, grant **Can use** access.

5. (Optional) Add a message to include with an email notification, or deselect the checkbox to skip sending an email.

6. Click **Save**.

## Add an MCP tool to a Sigma agent

To add an MCP tool to a Sigma agent, do the following:

1. Open a workbook for editing.
2. In the editor panel, select **Agents**.
3. For the relevant agent, select <img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/more.svg" alt="" /> **More** > **Edit**.
4. For **MCP tools**, click **Add MCP tool** (**+**).
5. Search for and select the relevant MCP tool.
6. Update the instructions for the agent with guidance for using the MCP tool.
7. (Optional) Select **Preview** and enter a prompt to test the agent's ability to use the new MCP tool.
8. Click **Save**.

For more details about setting up Sigma agents, see [Create and manage Sigma agents](/docs/create-sigma-agents).

## Related resources

* [Create and manage Sigma agents](/docs/create-sigma-agents)