diff --git a/README.md b/README.md
index c4bcbf2..2a23537 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
+## ⚠️ Deprecation Announcement for Mozilla HTTP Observatory
+
+Dear Mozilla Observatory Users,
+
+This code repository is now deprecated There is a [Node/Javascript based rewrite available](https://github.com/mdn/mdn-http-observatory/), that has updated scoring and backs the [public HTTP Observatory service on MDN](https://developer.mozilla.org/en-US/observatory).
+
+### 🛠️ What This Means
+
+* No Further Updates: We will no longer be providing updates, bug fixes, or new features for this repository. 
+* Limited Support: Official support will be discontinued. 
+* Archival: The repository will be archived soon, making it read-only.
+
+🔍 Alternatives and Recommendations
+
+We recommend transitioning to [HTTP Observatory](https://github.com/mdn/mdn-http-observatory/), maintained by [MDN](https://developer.mozilla.org).
+
+📦 Migration Guide
+
+To assist you in transitioning, we have prepared a [Migration Guide](https://github.com/mdn/mdn-http-observatory/blob/main/README.md#migrating-from-the-public-v1-api-to-the-v2-api) that covers steps to migrate your existing setup to the alternative.
+
 # Mozilla HTTP Observatory
 
 The Mozilla HTTP Observatory is a set of tools to analyze your website and inform you if you are utilizing the many available methods to secure it.