stellar · JFWooten4 · Aug 6, 2026
diff --git a/docs/build/agentic-payments/README.mdx b/docs/build/agentic-payments/README.mdx
@@ -20,9 +20,6 @@ keywords:
 
 import DocCardList from "@theme/DocCardList";
 
-Agentic payments enable programmatic, per-request payments over HTTP — designed for AI agents, APIs, and machine-to-machine interactions. These protocols extend the `402 Payment Required` HTTP status code into a machine-readable payment negotiation layer, allowing clients to pay for API requests natively on Stellar.
-
-- **[x402 on Stellar](./x402/README.mdx)** — An open protocol from the Coinbase Developer Platform for per-request payments using Soroban authorization entries, with facilitator-based verification and settlement.
-- **[MPP on Stellar](./mpp/README.mdx)** — The Machine Payments Protocol for direct on-chain settlement via Soroban SAC transfers, with support for both one-time charge payments and high-frequency off-chain payment channels.
+Agentic payments enable programmatic, per-request payments over HTTP — designed for AI agents, APIs, and machine-to-machine interactions. Two protocols extend the `402 Payment Required` HTTP status code into a machine-readable payment negotiation layer, allowing clients to pay for API requests natively:
 
 <DocCardList />
diff --git a/docs/build/agentic-payments/mpp/_category_.json b/docs/build/agentic-payments/mpp/_category_.json
@@ -1,4 +1,5 @@
 {
   "collapsed": false,
-  "position": 20
+  "position": 20,
+  "description": "The Machine Payments Protocol for direct on-chain settlement via Soroban SAC transfers, with support for both one-time charge payments and high-frequency off-chain payment channels."
 }
diff --git a/docs/build/agentic-payments/x402/_category_.json b/docs/build/agentic-payments/x402/_category_.json
@@ -1,4 +1,5 @@
 {
   "collapsed": false,
-  "position": 10
+  "position": 10,
+  "description": "An open protocol from the Coinbase Developer Platform for per-request payments using Soroban authorization entries, with facilitator-based verification and settlement."
 }
diff --git a/docs/tools/sdks/README.mdx b/docs/tools/sdks/README.mdx
@@ -11,8 +11,4 @@ import DocCardList from "@theme/DocCardList";
 
 The SDK section is split into three categories:
 
-- [Contract SDKs](./contract-sdks.mdx) that are used to build smart contracts that will be deployed to the Stellar network;
-- [Client & XDR SDKs](./client-sdks.mdx) that are used by applications to interact with the network;
-- [Build your own SDK](./build-your-own.mdx) that details the minimum requirements for building your own SDK.
-
 <DocCardList />
diff --git a/docs/tools/sdks/build-your-own.mdx b/docs/tools/sdks/build-your-own.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Build Your Own Contract SDK"
 sidebar_position: 30
+description: "Learn the minimum requirements for building your own contract SDK."
 ---
 
 :::note

diff --git a/docs/tools/sdks/client-sdks.mdx b/docs/tools/sdks/client-sdks.mdx
@@ -2,7 +2,7 @@
 title: "Simplify Blockchain Development with SDKs for Java, Python, and More"
 sidebar_label: "Client & XDR SDKs"
 sidebar_position: 20
-description: "Explore the Stellar SDK library to simplify blockchain development. Leverage Rust, JavaScript, Python, and more to build on and integrate with the network."
+description: "Use Client and XDR SDKs in applications to interact with the Stellar network."
 ---
 
 # Client & XDR SDKs

diff --git a/docs/tools/sdks/contract-sdks.mdx b/docs/tools/sdks/contract-sdks.mdx
@@ -2,6 +2,7 @@
 title: "Build smart contracts that will be deployed to the Stellar network"
 sidebar_label: Contract SDKs
 sidebar_position: 10
+description: "Build smart contracts that will be deployed to the Stellar network."
 ---
 
 # Contract SDKs