diff --git a/docs/build/agentic-payments/README.mdx b/docs/build/agentic-payments/README.mdx
index 6737716821..7c0817d6df 100644
--- 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:
diff --git a/docs/build/agentic-payments/mpp/_category_.json b/docs/build/agentic-payments/mpp/_category_.json
index 5b7ae0833e..fee3d0ec24 100644
--- 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
index 2d0269b1e1..4796415ba2 100644
--- 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
index 998232e885..fb964a10b0 100644
--- 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.
-
diff --git a/docs/tools/sdks/build-your-own.mdx b/docs/tools/sdks/build-your-own.mdx
index 811f140fac..bdc22e1890 100644
--- 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
index 7b01bec0cf..f406e2f524 100644
--- 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
index 07c50304f9..e2f7c507ec 100644
--- 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