Style updates to dbt-ai directory (#8081)

Author: matthewshaver

website/docs/docs/dbt-ai/about-mcp.md

@@ -32,8 +32,7 @@ You can install dbt MCP locally or remotely:
 ## Available Tools
 
 ### Supported
-The dbt MCP server has access to many parts of the dbt experience related to development, deployment, and discovery.
-Here are the categories of tools supported based on what form of the MCP Server you connect to as well as detailed information on exact commands or queries available to the LLM.
+The dbt MCP server has access to many parts of the dbt experience related to development, deployment, and discovery. Here are the categories of tools supported based on what form of the MCP server you connect to as well as detailed information on exact commands or queries available to the LLM.
 
 | Tools | Local | Remote |
 | --- | --- | --- |
@@ -108,7 +107,7 @@ To learn more about the dbt Administrative API, click [here](/docs/dbt-cloud-api
 
 ### Codegen tools
 
-These tools help automate boilerplate code generation for dbt projects files. To use them, install the [dbt-codegen](https://hub.getdbt.com/dbt-labs/codegen/latest/) in your dbt project. These tools are disabled by default. To enable them, set the `DISABLE_DBT_CODEGEN` environment variable to `false`.
+These tools help automate boilerplate code generation for dbt project files. To use them, install the [dbt-codegen](https://hub.getdbt.com/dbt-labs/codegen/latest/) in your dbt project. These tools are disabled by default. To enable them, set the `DISABLE_DBT_CODEGEN` environment variable to `false`.
 
 - `generate_source`: Creates source YAML definitions from database schemas.
 - `generate_model_yaml`: Generates documentation YAML for existing dbt models, including column names, data types, and description placeholders.
@@ -125,10 +124,10 @@ import MCPCreditUsage from '/snippets/_mcp-credit-usage.md';
 
 <MCPCreditUsage />
 
-### Fusion tools (Local)
+### Fusion tools (local)
 A set of tools that leverage the <Constant name="fusion" /> engine through a locally running <Constant name="fusion" /> Language Server Protocol (LSP) in VS Code or Cursor with the dbt VS Code extension.
 
-- `get_column_lineage`: <Constant name="fusion" /> exclusive! Gets column lineage information across a project DAG for a specific column.
+- `get_column_lineage`: <Constant name="fusion" /> exclusive! Get column lineage information across a project DAG for a specific column.
 
 ## MCP integrations
 
@@ -144,4 +143,4 @@ We have also created integration guides for the following clients:
 - Some MCP clients may be unable to find `uvx` from the JSON config. This will result in error messages like `Could not connect to MCP server dbt-mcp`. If this happens, try finding the full path to `uvx` with `which uvx` on Unix systems and placing this full path in the JSON. For instance: `"command": "/the/full/path/to/uvx"`.
 
 ## Resources
-- Refer to our blog on [Introducing the dbt MCP Server](/blog/introducing-dbt-mcp-server#getting-started) for more information.
+- For more information, refer to our blog on [Introducing the dbt MCP Server](/blog/introducing-dbt-mcp-server#getting-started).

website/docs/docs/dbt-ai/integrate-mcp-claude.md

@@ -8,8 +8,8 @@ id: "integrate-mcp-claude"
 import MCPExample from '/snippets/_mcp-config-files.md';
 
 Claude is an AI assistant from Anthropic with two primary interfaces: 
-- [Claude Code](https://www.anthropic.com/claude-code): a terminal/IDE tool for development
-- [Claude for desktop](https://claude.ai/download): a GUI with MCP support for file access and commands as well as basic coding features 
+- [Claude Code](https://www.anthropic.com/claude-code): A terminal/IDE tool for development
+- [Claude for desktop](https://claude.ai/download): A GUI with MCP support for file access and commands as well as basic coding features 
 
 ## Claude Code
 
@@ -18,7 +18,7 @@ You can set up Claude Code with both the local and remote `dbt-mcp` server. We r
 ### Setup with local dbt MCP server
 
 Prerequisites:
-- Have an .env file with your environment variables 
+- Have an `.env` file with your environment variables 
 - Local dbt-mcp setup
 
 1. Run the following command to add the MCP server to Claude Code:
@@ -41,7 +41,7 @@ To install it in the project scope, run the following and commit the `.mcp.json`
 claude mcp add dbt -s project -- uvx --env-file <path-to-.env-file> dbt-mcp
 ```
 
-More info on scopes [here](https://docs.anthropic.com/en/docs/claude-code/mcp#understanding-mcp-server-scopes)
+For more information on scopes, refer to [Understanding MCP server scopes](https://docs.anthropic.com/en/docs/claude-code/mcp#understanding-mcp-server-scopes).
 
 
 ## Claude for desktop
@@ -82,3 +82,4 @@ For debugging, you can find the Claude desktop logs at `~/Library/Logs/Claude` f
 
 - Claude desktop may return errors such as `Error: spawn uvx ENOENT` or `Could not connect to MCP server dbt-mcp`. Try replacing the command
 and environment variables file path with the full path. For `ux`, find the full path to `uvx` by running `which uvx` on Unix systems and placing this full path in the JSON. For instance: `"command": "/the/full/path/to/uvx"`.
+

website/docs/docs/dbt-ai/integrate-mcp-cursor.md

@@ -19,7 +19,7 @@ After setting up your MCP server, you connect it to Cursor. Log in to Cursor and
 3. Update inputs in the template. 
 4. Save, and now you have access to the dbt-mcp!
 
-#### Set up with dbt platform authentication <Lifecycle status="managed, managed_plus" />
+### Set up with dbt platform authentication <Lifecycle status="managed, managed_plus" />
 You can configure the local MCP server for use with the dbt platform via OAuth: 
 
 1. Click one of the following application links with Cursor open:

website/docs/docs/dbt-ai/integrate-mcp-vscode.md

@@ -45,7 +45,7 @@ These instructions are for integrating dbt MCP and VS Code. To get started, in V
     }
     ```
 
-    `<path-to-.env-file>` is where you saved the `.env` file from the Setup step
+    `<path-to-.env-file>` is where you saved the `.env` file from the setup step.
 
     </TabItem>
 
@@ -72,7 +72,7 @@ These instructions are for integrating dbt MCP and VS Code. To get started, in V
 
     #### Local MCP with dbt platform authentication <Lifecycle status="managed, managed_plus" />
 
-    Additionally, you can configure the local MCP server to authenticate against your dbt platform environment using OAuth. Substitute the previous local MCP JSON with one of the following::
+    Additionally, you can configure the local MCP server to authenticate against your dbt platform environment using OAuth. Substitute the previous local MCP JSON with one of the following:
 
     <MCPExample />
 
@@ -86,4 +86,4 @@ Now you will be able to access the local dbt MCP server on VS Code through inter
 
 ## Resources
 
-- Microsoft VS Code MCP [docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+- [Microsoft VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)

website/docs/docs/dbt-ai/setup-local-mcp.md

@@ -34,10 +34,10 @@ import MCPExample from '/snippets/_mcp-config-files.md';
     <TabItem value="API and SQL tool settings">
       | Environment Variable | Required | Description |
       | --- | --- | --- |
-      | DBT_HOST | Required | Your dbt platform [instance hostname](/docs/cloud/about-cloud/access-regions-ip-addresses). If you're using Multi-cell, exclude the `ACCOUNT_PREFIX` from the hostname. The default is `cloud.getdbt.com`  |
-      | MULTICELL_ACCOUNT_PREFIX | Only required for Multi-cell instances | Set your Multi-cell  `ACCOUNT_PREFIX`. If you are not using Multi-cell, don't set this value. You can learn more about regions and hosting [here](https://docs.getdbt.com/docs/cloud/about-cloud/access-regions-ip-addresses).  |
+      | DBT_HOST | Required | Your dbt platform [instance hostname](/docs/cloud/about-cloud/access-regions-ip-addresses). If you're using Multi-cell, exclude the `ACCOUNT_PREFIX` from the hostname. The default is `cloud.getdbt.com`.  |
+      | MULTICELL_ACCOUNT_PREFIX | Only required for Multi-cell instances | Set your Multi-cell `ACCOUNT_PREFIX`. If you are not using Multi-cell, don't set this value. You can learn more about regions and hosting [here](https://docs.getdbt.com/docs/cloud/about-cloud/access-regions-ip-addresses).  |
       | DBT_TOKEN | Required | Your personal access token or service token from the dbt platform. <br/>**Note**: When using the Semantic Layer, it is recommended to use a personal access token. If you're using a service token, make sure that it has at least `Semantic Layer Only`, `Metadata Only`, and `Developer` permissions.  |
-      | DBT_ACCOUNT_ID | Required for Admininstrative API tools | Your [dbt account ID](https://docs.getdbt.com/faqs/Accounts/find-user-id) |
+      | DBT_ACCOUNT_ID | Required for Administrative API tools | Your [dbt account ID](https://docs.getdbt.com/faqs/Accounts/find-user-id) |
       | DBT_PROD_ENV_ID | Required | Your dbt Cloud production environment ID |
       | DBT_DEV_ENV_ID | Optional | Your dbt Cloud development environment ID |
       | DBT_USER_ID | Optional | Your dbt Cloud user ID ([docs](https://docs.getdbt.com/faqs/Accounts/find-user-id)) |
@@ -66,7 +66,7 @@ import MCPExample from '/snippets/_mcp-config-files.md';
       | `DISABLE_DBT_CLI`        | `false` | Set this to `true` to disable dbt Core, dbt Cloud CLI, and dbt Fusion MCP tools |
       | `DISABLE_SEMANTIC_LAYER` | `false` | Set this to `true` to disable dbt Semantic Layer MCP tools                    |
       | `DISABLE_DISCOVERY`      | `false` | Set this to `true` to disable dbt Discovery API MCP tools                     |
-      | `DISABLE_ADMIN_API`      | `false` | Set this to `true` to disable dbt Admininistrative API MCP tools                         |
+      | `DISABLE_ADMIN_API`      | `false` | Set this to `true` to disable dbt Administrative API MCP tools                         |
       | `DISABLE_SQL`            | `true`  | Set this to `false` to enable SQL MCP tools                                |
       | `DISABLE_DBT_CODEGEN`    | `true`  | Set this to `false` to enable [dbt codegen MCP tools](/docs/dbt-ai/about-mcp#codegen-tools) (requires dbt-codegen package) |
       | `DISABLE_TOOLS`          | ""      | Set this to a list of tool names delimited by a `,` to disable specific tools    |
@@ -85,7 +85,7 @@ import MCPExample from '/snippets/_mcp-config-files.md';
 
 4. Set up your MCP client:
 
-    After creating your `.env` file, you can move on to our guides on connecting dbt-mcp to tools like Claude Desktop or Cursor or to creating aconfiguration file. This is dependent on what tools you want to integrate with.
+    After creating your `.env` file, you can move on to our guides on connecting dbt-mcp to tools like Claude Desktop or Cursor or to creating a configuration file. This is dependent on what tools you want to integrate with.
 
 
     #### Example configuration
@@ -107,15 +107,15 @@ import MCPExample from '/snippets/_mcp-config-files.md';
     }
     ```
 
-    `<path-to-.env-file>` is where you saved the `.env` file from the Setup step.
+    `<path-to-.env-file>` is where you saved the `.env` file from the setup step.
 
 ## dbt platform authentication
 
 The local MCP server integrates with your existing cloud-based dbt platform OAuth integration with a simple configuration file in the client. Reference the following sample configurations (configs may vary depending on the client):
 
-:::info static subdomains
+:::info Static subdomains
 
-Only accounts with static subdomains (for example, abc123.us1.dbt.com) can use OAuth with MCP servers. All accounts are in the process of being migrated to static subdomains by Dec 2025. Please contact support for more information.
+Only accounts with static subdomains (for example, abc123.us1.dbt.com) can use OAuth with MCP servers. All accounts are in the process of being migrated to static subdomains by December 2025. Please contact support for more information.
 
 :::
 

website/docs/docs/dbt-ai/setup-remote-mcp.md

@@ -11,12 +11,12 @@ import MCPCreditUsage from '/snippets/_mcp-credit-usage.md';
 
 <MCPCreditUsage />
 
-1. Ensure that you have [AI Features](https://docs.getdbt.com/docs/cloud/enable-dbt-copilot) turned on.
-2. Obtain the following information from dbt Platform:
+1. Ensure that you have [AI features](https://docs.getdbt.com/docs/cloud/enable-dbt-copilot) turned on.
+2. Obtain the following information from dbt platform:
 
-  - **dbt Cloud host**: Use this to form the full URL. For example, replace `<host>` here: `https://<host>/api/ai/v1/mcp/`. It may look like: `https://cloud.getdbt.com/api/ai/v1/mcp/`. If you have a multi-cell account, the host URL will be in the `<ACCOUNT_PREFIX>.us1.dbt.com` format. For more information, [check out our docs.](/docs/cloud/about-cloud/access-regions-ip-addresses)
-  - **Production environment ID**: This can be found on the `Orchestration` page of dbt Cloud. Use this to set an `x-dbt-prod-environment-id` header.
-  - **Token**: Please generate either a personal access token or a service token. In terms of permissions, to fully utilize remote MCP, it must be configured with Semantic Layer and Developer permissions.
+  - **dbt Cloud host**: Use this to form the full URL. For example, replace `<host>` here: `https://<host>/api/ai/v1/mcp/`. It may look like: `https://cloud.getdbt.com/api/ai/v1/mcp/`. If you have a multi-cell account, the host URL will be in the `<ACCOUNT_PREFIX>.us1.dbt.com` format. For more information, refer to [Access, Regions, & IP addresses](/docs/cloud/about-cloud/access-regions-ip-addresses).
+  - **Production environment ID**: This can be found on the **Orchestration** page of dbt Cloud. Use this to set an `x-dbt-prod-environment-id` header.
+  - **Token**: Generate either a personal access token or a service token. In terms of permissions, to fully utilize remote MCP, it must be configured with Semantic Layer and Developer permissions.
 
 3. For the remote MCP, you will pass on headers through the JSON blob to configure required fields:
 
@@ -50,7 +50,7 @@ Fusion tools, by default, defer to the environment provided via `x-dbt-prod-envi
   | x-dbt-disable-tools | Optional | A comma-separated list of tools to disable. For instance: `get_all_models,text_to_sql,list_entities` |
   | x-dbt-disable-toolsets | Optional | A comma-separated list of toolsets to disable. For instance: `semantic_layer,sql,discovery` |
 
-4. After establishing which headers you need, you can follow the examples [here](https://github.com/dbt-labs/dbt-mcp/tree/main/examples) to create your own agent. 
+4. After establishing which headers you need, you can follow the [examples](https://github.com/dbt-labs/dbt-mcp/tree/main/examples) to create your own agent. 
 
 The MCP protocol is programming language and framework agnostic, so use whatever helps you build agents. Alternatively, you can connect the remote dbt MCP server to MCP clients that support header-based authentication. You can use this example Cursor configuration, replacing `<host>`, `<token>`, `<prod-id>`, `<user-id>`, and `<dev-id>` with your information: