diff --git a/README.md b/README.md
index 9401cccd..2175d513 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,17 @@
-# akeyless-java
+# Akeyless Java SDK
 
-Akeyless API
-- API version: 3.0
-  - Generator version: 7.22.0
+The official Java client for the [Akeyless](https://www.akeyless.io) secrets management platform.
+
+Akeyless helps teams protect secrets, machine identities, and AI agents in one zero-trust platform, securing API keys, passwords, certificates, and encryption keys without ever exposing them in applications, config files, or agent code. This SDK lets you do all of that from Java, so your apps and automation pipelines receive short-lived credentials just in time, while AI agents and MCP servers get brokered access that never puts credentials in their hands, with every request governed by policy and fully audited.
+
+## About this package
 
-The purpose of this application is to provide access to Akeyless API.
+This SDK is generated automatically from the Akeyless OpenAPI specification using [OpenAPI Generator](https://openapi-generator.tech), so it stays in sync with the latest API.
+
+- API version: 3.0
+- Generator version: 7.22.0
 
-  For more information, please visit [http://akeyless.io](http://akeyless.io)
+For more information, visit [akeyless.io](https://www.akeyless.io), the [Akeyless documentation](https://docs.akeyless.io), or the [Java SDK guide](https://docs.akeyless.io/docs/java-sdk-1).
 
 *Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*