diff --git a/src/langsmith/agent-builder-mcp-framework.mdx b/src/langsmith/agent-builder-mcp-framework.mdx
index c0461cae13..2ab82ceb08 100644
--- a/src/langsmith/agent-builder-mcp-framework.mdx
+++ b/src/langsmith/agent-builder-mcp-framework.mdx
@@ -1,6 +1,5 @@
 ---
 title: LangSmith Tool Server
-sidebarTitle: MCP framework
 ---
 
 The LangSmith Tool Server is our MCP Framework that powers the tools available in the LangSmith Agent Builder. This framework enables you to build and deploy custom tools that can be integrated with your agents. It provides a standardized way to create, deploy, and manage tools with built-in authentication and authorization.
@@ -169,25 +168,3 @@ async def authenticate(authorization: str = None) -> dict:
 ```
 
 The handler runs on every request and must return a dict with `identity` (and optionally `permissions`).
-
-## Using remote MCP servers
-
-Agent Builder can discover and use tools from remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers. This lets you connect to external MCP servers and use their tools in your agents.
-
-### Configuration
-
-Configure remote MCP servers in your LangSmith [workspace](/langsmith/administration-overview#workspaces):
-
-1. Navigate to your workspace settings in the [LangSmith UI](https://smith.langchain.com).
-2. Add your MCP server URL and any required headers (for example, `Authorization: Bearer {{MCP_TOKEN}}`).
-3. Agent Builder automatically discovers tools from the server and applies the configured headers when calling tools.
-
-<Note>
-Use workspace secret placeholders like `{{MCP_TOKEN}}` in headers. The platform resolves these from your workspace secrets at runtime.
-</Note>
-
-### How it works
-
-- Agent Builder discovers tools from remote MCP servers via the standard MCP protocol.
-- Headers configured in your workspace are automatically attached when fetching tools or calling them.
-- Tools from remote servers are available alongside built-in tools in Agent Builder.
diff --git a/src/langsmith/agent-builder-tools.mdx b/src/langsmith/agent-builder-tools.mdx
index 756e4ccd4a..36b76e3454 100644
--- a/src/langsmith/agent-builder-tools.mdx
+++ b/src/langsmith/agent-builder-tools.mdx
@@ -1,7 +1,8 @@
 ---
-title: Supported tools
+title: Tools
 sidebarTitle: Tools
 ---
+## Built-in Tools
 
 Use these built-in tools to give your agents access to email, calendars, chat, project management, code hosting, spreadsheets/BI, search, social, and general web utilities.
 
@@ -132,3 +133,25 @@ Use these built-in tools to give your agents access to email, calendars, chat, p
     </ul>
   </Card>
 </CardGroup>
+
+## Using remote MCP servers
+
+Agent Builder can discover and use tools from remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers. This lets you connect to external MCP servers and use their tools in your agents.
+
+### Configuration
+
+Configure remote MCP servers in your LangSmith [workspace](/langsmith/administration-overview#workspaces):
+
+1. Navigate to your workspace settings in the [LangSmith UI](https://smith.langchain.com).
+2. Add your MCP server URL and any required headers (for example, `Authorization: Bearer {{MCP_TOKEN}}`).
+3. Agent Builder automatically discovers tools from the server and applies the configured headers when calling tools.
+
+<Note>
+Use workspace secret placeholders like `{{MCP_TOKEN}}` in headers. The platform resolves these from your workspace secrets at runtime.
+</Note>
+
+### How it works
+
+- Agent Builder discovers tools from remote MCP servers via the standard MCP protocol.
+- Headers configured in your workspace are automatically attached when fetching tools or calling them.
+- Tools from remote servers are available alongside built-in tools in Agent Builder.