From 41da980888245e8f27432f090a30a315c053cf2f Mon Sep 17 00:00:00 2001
From: Hugh Nimmo-Smith <hughns@matrix.org>
Date: Mon, 11 Sep 2023 14:38:11 +0100
Subject: [PATCH] Notes on capabilities

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index a82200088..d4eac0a6f 100644
--- a/README.md
+++ b/README.md
@@ -7,3 +7,24 @@ It has been created to support the migration of Matrix to an OpenID Connect (OID
 See the [Documentation](https://matrix-org.github.io/matrix-authentication-service/index.html) for information on installation and use.
 
 You can learn more about Matrix and OIDC at [areweoidcyet.com](https://areweoidcyet.com/).
+
+## Features
+
+- Supported homeservers
+  - ✅ Synapse
+- Authentication methods:
+  - ✅ OIDC
+  - 🚧 Local password
+- Migration support
+  - ✅ Compatibility layer for legacy Matrix authentication
+  - 🚧 Advisor on migration readiness
+  - 🚧 Import users from Synapse
+  - 🚧 Import of external subject IDs from upstream identity providers
+
+## Upstream Identity Providers
+
+MAS is known to work with the following upstream IdPs via OIDC:
+
+- Keycloak
+- Dex
+- Google