blaxel-ai · mintlify · May 27, 2026
diff --git a/Agents.mdx b/Agents.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Agents section index"
-description: "Index of Blaxel agent documentation pages including hosting overview, quickstart, development guides, deployment options, and integrations."
+title: "Build and deploy AI agents on Blaxel"
+description: "Browse documentation for hosting AI agents on Blaxel, including quickstart guides, TypeScript and Python development, deployment, and app integration."
 ---
 
 [Overview](Agents/Overview)

diff --git a/Functions.mdx b/Functions.mdx
@@ -1,6 +1,6 @@
 ---
-title: "MCP servers section index"
-description: "Index of Blaxel MCP server documentation pages including overview, creating and adapting servers, deployment, invocation, and OAuth flows."
+title: "Host MCP servers on Blaxel"
+description: "Browse Blaxel MCP server documentation covering creating and adapting servers, deploying as serverless endpoints, querying tools, and OAuth flows."
 ---
 
 [Overview](Functions/Overview)

diff --git a/Infrastructure.mdx b/Infrastructure.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Infrastructure section index"
-description: "Index of Blaxel infrastructure documentation including the Global Inference Network, regions, generations, and custom domains for workloads."
+title: "Blaxel infrastructure: network, regions, and domains"
+description: "Browse Blaxel infrastructure documentation covering the Global Agentics Network, available regions, generations, egress gateways, and custom domains."
 ---
 
 [Global-Inference-Network](Infrastructure/Global-Inference-Network)

diff --git a/Jobs.mdx b/Jobs.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Jobs section index"
-description: "Index of Blaxel batch job documentation including overview, development workflow, deployment options, Dockerfile support, and execution management."
+title: "Run batch jobs on Blaxel"
+description: "Browse Blaxel batch job documentation covering development workflow, deploying jobs from source or Dockerfile, mono-repos, and execution management."
 ---
 
 [Overview](Jobs/Overview)

diff --git a/Model-Governance.mdx b/Model-Governance.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Model governance section index"
-description: "Index of Blaxel model governance documentation including policies, environments, dev and prod lifecycle, and workload deployment controls."
+title: "Model governance, policies, and environments"
+description: "Browse Blaxel model governance documentation covering deployment policies, environments, the dev and prod lifecycle, and workload-level routing controls."
 ---
 
 [Policies](Model-Governance/Policies)

diff --git a/Models.mdx b/Models.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Models section index"
-description: "Index of Blaxel model documentation including overview, external model APIs, querying models, and deploying custom AI models to Blaxel."
+title: "Model APIs and custom model deployment"
+description: "Browse Blaxel model documentation covering external model APIs, querying hosted LLM endpoints, and deploying custom AI models to the Blaxel platform."
 ---
 
 [Overview](Models/Overview)

diff --git a/Observability.mdx b/Observability.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Observability section index"
-description: "Index of Blaxel observability documentation covering logs, distributed traces, and real-time metrics for agents and other deployed workloads."
+title: "Logs, traces, and metrics for Blaxel workloads"
+description: "Browse Blaxel observability documentation covering logs, distributed traces, and real-time metrics for deployed agents, MCP servers, jobs, and sandboxes."
 ---
 
 [Overview](Observability/Overview)
diff --git a/Overview.mdx b/Overview.mdx
@@ -2,7 +2,7 @@
 
 title: 'Blaxel platform overview: sandboxes, agents, MCP, and jobs'
 
-description: 'Explore the Blaxel platform: persistent sandboxes, hosted AI agents, MCP servers, batch jobs, model APIs, and the developer tooling that ties them together.'
+description: 'Blaxel is the perpetual sandbox platform for AI agents. Spin up cloud sandboxes, host agents and MCP servers, run jobs, and query model APIs from one place.'
 
 sidebarTitle: "Overview"
 

diff --git a/Sandboxes.mdx b/Sandboxes.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Sandboxes section index"
-description: "Index of Blaxel sandbox documentation covering processes, file system, codegen tools, ports, preview URLs, sessions, proxy, volumes, and templates."
+title: "Cloud sandboxes for AI agents and code execution"
+description: "Browse Blaxel sandbox documentation covering processes, file system, ports, preview URLs, sessions, proxies, volumes, and reusable sandbox templates."
 ---
 
 [Overview](Sandboxes/Overview)

diff --git a/Security.mdx b/Security.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Security section index"
-description: "Index of Blaxel security documentation covering workspace access control, roles, service accounts, access tokens, SSO, and data privacy options."
+title: "Blaxel security, access control, and privacy"
+description: "Browse Blaxel security documentation covering workspace roles, service accounts, access tokens, SSO and SAML, data privacy, quotas, and domain capture."
 ---
 
 [Workspace-access-control](Security/Workspace-access-control)

diff --git a/api-reference.mdx b/api-reference.mdx
@@ -1,6 +1,6 @@
 ---
-title: "API reference index"
-description: "Index of Blaxel API reference pages covering authentication, the inference API for deployed workloads, and the Billing Explorer API endpoints."
+title: "Blaxel REST API reference"
+description: "Reference for the Blaxel REST APIs, including authentication, the inference API for deployed workloads, and the Billing Explorer API endpoint catalog."
 ---
 
 [introduction](api-reference/introduction)

diff --git a/cli-reference.mdx b/cli-reference.mdx
@@ -1,6 +1,6 @@
 ---
-title: "CLI reference index"
-description: "Index of the Blaxel CLI reference covering installation, authentication, and the full set of bl commands for managing Blaxel workspace resources."
+title: "Blaxel CLI (bl) command reference"
+description: "Reference for the Blaxel CLI, covering installation, authentication, and the full set of bl commands for managing workspaces, agents, sandboxes, and jobs."
 ---
 
 [introduction](cli-reference/introduction)
diff --git a/sdk-reference.mdx b/sdk-reference.mdx
@@ -1,6 +1,6 @@
 ---
-title: "SDK reference index"
-description: "Index of the Blaxel SDK reference covering the TypeScript, Python, and Go SDKs for programmatically managing Blaxel workspace resources."
+title: "Blaxel SDKs for TypeScript, Python, and Go"
+description: "Reference for the Blaxel SDKs in TypeScript, Python, and Go, used to programmatically manage agents, sandboxes, MCP servers, jobs, and workspace resources."
 ---
 
 [introduction](sdk-reference/introduction)