diff --git a/README.md b/README.md
index 785bed0..2c0331f 100644
--- a/README.md
+++ b/README.md
@@ -5,8 +5,12 @@ mxisd is an implementation of the Matrix Identity Server which aims to provide a
 to [sydent](https://github.com/matrix-org/sydent) and an external validation implementation of the
 [Identity Service API](http://matrix.org/docs/spec/identity_service/unstable.html).
 
-mxisd is currently in read-only mode and use a priority lookup strategy with several providers.
+## Contact
+If you need help, want to report a bug or just say hi, you can reach us at [#mxisd:kamax.io](https://matrix.to/#/#mxisd:kamax.io)
 
+For more high-level discussion about the Identity Server architecture/API, go to [#matrix-identity:matrix.org](https://matrix.to/#/#matrix-identity:matrix.org)
+
+## How does it work
 Given the 3PID `john.doe@example.org`, the following could be performed until a mapping is found:
 - LDAP: lookup the Matrix ID (partial or complete) from a configurable attribute.
 - DNS: lookup another Identity Server using the domain part of an e-mail and: