Update overview pages

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>

Author: danbarr

docs/toolhive/guides-cli/index.mdx

@@ -10,7 +10,7 @@ import DocCardList from '@theme/DocCardList';
 ## Introduction
 
 The ToolHive CLI (`thv`) is a command-line tool that allows you to deploy and
-manage MCP servers on your local machines or in development environments. It
+manage MCP servers on your local machine or in development environments. It
 provides quick deployment of MCP servers and supports advanced features like
 custom permissions, network access filtering, and telemetry.
 

docs/toolhive/guides-registry/index.mdx

@@ -9,8 +9,8 @@ import DocCardList from '@theme/DocCardList';
 
 ## Introduction
 
-The ToolHive Registry server implements the official
-[Model Context Protocol (MCP) Registry API specification](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/api/generic-registry-api.md)
+The ToolHive Registry Server is an implementation of the official
+[Model Context Protocol (MCP) Registry API specification](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/api/generic-registry-api.md).
 It provides a standardized REST API for discovering and accessing MCP servers
 from multiple backend sources, including Kubernetes clusters, Git repositories,
 API endpoints, and local files.

docs/toolhive/index.mdx

@@ -37,17 +37,43 @@ import ThemedImage from '@theme/ThemedImage';
 
 # What is ToolHive?
 
-ToolHive simplifies the deployment and management of Model Context Protocol
-(MCP) servers. It ensures ease of use, consistency, and security by running
-containers in a locked-down environment with minimal permissions.
+ToolHive is an enterprise-grade open source (Apache 2.0) platform for running
+and managing Model Context Protocol (MCP) servers.
 
 Follow the [getting started guide](./tutorials/quickstart-ui.mdx) to install
-ToolHive and run your first MCP server.
+ToolHive locally and run your first MCP server.
 
 To learn more about the Model Context Protocol, see our
 [MCP primer](./concepts/mcp-primer.mdx).
 
-ToolHive is available in three modes to suit different use cases:
+## ToolHive components
+
+ToolHive includes everything you need to use MCP servers in production. It's
+made up of four key components: the Runtime, Registry Server, Gateway, and
+Portal.
+
+<ThemedImage
+  alt='ToolHive platform architecture overview'
+  sources={{
+    light: useBaseUrl('/img/toolhive/toolhive-platform-light.svg'),
+    dark: useBaseUrl('/img/toolhive/toolhive-platform-dark.svg'),
+  }}
+  title='ToolHive platform architecture overview'
+  width={'800px'}
+  style={{
+    paddingBottom: '1rem',
+  }}
+/>
+
+### Runtime
+
+The ToolHive Runtime is the core component that runs MCP servers in isolated
+containers. It provides a secure and scalable environment for deploying MCP
+servers, with features like fine-grained permissions, network access controls,
+and secret management.
+
+The ToolHive Runtime is available in three different editions to suit different
+use cases:
 
 - [**ToolHive UI**](./guides-ui/index.mdx): A desktop application for individual
   developers to run and manage MCP servers locally. It provides a user-friendly
@@ -56,13 +82,51 @@ ToolHive is available in three modes to suit different use cases:
 - [**ToolHive CLI**](./guides-cli/index.mdx): A command line interface to deploy
   and manage MCP servers on your local machine or in development environments.
   It allows quick deployment of MCP servers and supports advanced features like
-  custom permissions and telemetry.
+  telemetry and fine-grained authorization policies.
 
 - [**ToolHive Kubernetes Operator**](./guides-k8s/index.mdx): A Kubernetes
   operator for teams and enterprises to run and manage MCP servers in multi-user
   environments. It provides centralized management, security controls, and
   integration with existing infrastructure.
 
+### Registry Server
+
+The [**ToolHive Registry Server**](./guides-registry/index.mdx) is an
+implementation of the official
+[MCP Registry API](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/api/generic-registry-api.md).
+Curate a catalog of trusted servers from multiple backend sources for users to
+quickly discover and deploy. It can be deployed standalone or as part of the
+ToolHive Operator.
+
+### Gateway
+
+Implemented in the ToolHive Kubernetes Operator as the
+[**Virtual MCP Server (vMCP)**](./guides-vmcp/index.mdx), the ToolHive Gateway
+is a secure proxy for MCP server connectivity, aggregation, and orchestration.
+It's available as part of the ToolHive Operator for Kubernetes deployments.
+
+### Portal
+
+The ToolHive Portal is how users discover and install MCP servers. It's
+available as a cross-platform desktop app (the ToolHive UI) and an experimental
+[web-based frontend](https://github.com/stacklok/toolhive-cloud-ui) to the
+ToolHive Registry Server.
+
+### Better together
+
+ToolHive components work together to provide a seamless experience for both
+admins and users:
+
+1. **Admins** curate and organize MCP servers in the **Registry**, configuring
+   access and policies.
+2. **Users** discover and request MCP servers from the **Portal**, and ToolHive
+   orchestrates installation and access.
+3. **Runtime** securely deploys and manages MCP servers across local and cloud
+   environments, integrating seamlessly with existing SDLC workflows, exporting
+   analytics, and enforcing fine-grained access control.
+4. **Gateway** handles all inbound traffic, secures context and credentials,
+   optimizes tool selection, and applies organizational policies.
+
 ## Why ToolHive?
 
 We want to help you get real value from MCP servers. While there are plenty of
@@ -80,50 +144,45 @@ containerize the MCP server and let you use a simple CLI or Kubernetes to manage
 MCP deployments at any scale. Coordinate all your MCP servers from one place
 with sensible security controls and container-native simplicity.
 
-## Architecture overview
+## Key features
 
-ToolHive exposes an HTTP proxy to forward requests to MCP servers running in
-containers. The proxy communicates with MCP servers via standard input/output
-(stdio), server-sent events (SSE), or Streamable HTTP. The ToolHive CLI
-interacts with Docker or Podman via the Docker socket API, letting it manage
-containers and their configurations.
+ToolHive includes a range of capabilities to help you run and manage MCP servers
+effectively:
 
-<ThemedImage
-  alt='ToolHive architecture overview'
-  sources={{
-    light: useBaseUrl('/img/toolhive/toolhive-diagram-light.svg'),
-    dark: useBaseUrl('/img/toolhive/toolhive-diagram-dark.svg'),
-  }}
-  title='ToolHive architecture overview'
-/>
-<br />
+**Runtime:**
 
-## Key features
+- Run local MCP servers instantly from the built-in registry of vetted MCP
+  servers, any Docker container, or directly from package managers
+- Deploy MCP servers in the cloud via Kubernetes for enterprise scalability
+- Proxy remote MCP servers securely for unified management
+- Apply fine-grained permissions and network access filtering
+- Protect sensitive data with built-in secrets management and enterprise OAuth
+  integrations
+- Leverage OpenTelemetry and Prometheus for observability and audit logging
 
-ToolHive includes a range of features to help you run and manage MCP servers
-effectively:
+**Registry Server:**
 
-- **Streamlined deployment**: Deploy MCP servers instantly using Docker
-  containers or directly from package managers via protocol schemes (`uvx://`,
-  `npx://`, `go://`). Access a curated registry of verified MCP servers that you
-  can discover and run effortlessly.
+- Curate a catalog of trusted MCP servers from multiple sources: the official
+  MCP Registry, other public registries, and custom files
+- Group servers based on role or use case
+- Manage your registry with an API-driven interface
+- Preset configurations and permissions for a frictionless user experience
 
-- **Seamless integration**: Configure popular development tools automatically,
-  including GitHub Copilot and Cursor, to streamline your workflow with minimal
-  setup.
+**Gateway:**
 
-- **Comprehensive security**: Run MCP servers in isolated containers with
-  customizable, fine-grained permissions and network access filtering using JSON
-  profiles. Securely manage secrets and configurations using built-in encrypted
-  storage or 1Password integration, eliminating plaintext secrets in
-  configuration files.
+- Orchestrate multiple tools with a deterministic workflow engine
+- Centralize control of security policy, authentication, authorization,
+  auditing, etc.
+- Customize and filter tools and descriptions to improve performance and reduce
+  token usage
 
-- **Enterprise readiness**: Implement robust OAuth-based authorization controls
-  for enterprise environments that integrate seamlessly with existing
-  infrastructure.
+**Portal:**
 
-- **Kubernetes deployment**: Deploy and manage MCP servers in Kubernetes
-  clusters using the ToolHive operator.
+- Cross-platform [desktop app](https://github.com/stacklok/toolhive-studio) and
+  browser-based [cloud UI](https://github.com/stacklok/toolhive-cloud-ui)
+- Make it easy for end users to discover and deploy MCP servers
+- Install MCP servers with a single click
+- Connect with local clients like Claude Desktop, Cursor, VS Code, and many more
 
 ## Additional resources
 
@@ -132,9 +191,15 @@ with other ToolHive users, ask questions, and share your experiences.
 
 Source code and issue tracking:
 
-- ToolHive UI
-  - [GitHub repository](https://github.com/stacklok/toolhive-studio)
-  - [Issue tracker](https://github.com/stacklok/toolhive-studio/issues)
 - ToolHive CLI & K8s Operator
   - [GitHub repository](https://github.com/stacklok/toolhive)
   - [Issue tracker](https://github.com/stacklok/toolhive/issues)
+- ToolHive UI
+  - [GitHub repository](https://github.com/stacklok/toolhive-studio)
+  - [Issue tracker](https://github.com/stacklok/toolhive-studio/issues)
+- ToolHive Registry Server
+  - [GitHub repository](https://github.com/stacklok/toolhive-registry-server)
+  - [Issue tracker](https://github.com/stacklok/toolhive-registry-server/issues)
+- ToolHive Cloud UI (experimental)
+  - [GitHub repository](https://github.com/stacklok/toolhive-cloud-ui)
+  - [Issue tracker](https://github.com/stacklok/toolhive-cloud-ui/issues)

src/pages/index.tsx

@@ -61,7 +61,6 @@ export default function Home(): ReactNode {
                 maxWidth: '40%',
               }}
             />
-            {/* TODO: update description */}
             ToolHive simplifies the deployment and management of Model Context
             Protocol (MCP) servers, ensuring ease of use, consistency, and
             security. It's available as a standalone tool or as a