diff --git a/README.md b/README.md
index 19440f418112fcaef89f90c7025830e4cffef8a2..17cdb7e4d17dc8f3b847dbff8af89ecbd6636d43 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,19 @@
 This repository contains tools to parse contacts from eduGAIN metadata and from 
 the eduGAIN APIs published on https://technical.edugain.org/api.php.
 
+## Identity federations contacts
+
+Script name :`identity_federations_security_contacts.py`
+
+This script consume the eduGAIN API to retrieve the details of all the eduGAIN identity 
+federations and parse it to create a list of contacts per each federation in CSV format. This list will be printed to stdout.
+
+CSV Format:
+
+```
+FEDERATION,COUNTRIES,SECURITY CONTACT,FEDERATION CONTACT
+```
+
 ## Identity federations security contacts
 
 Script name :`identity_federations_security_contacts.py`