diff --git a/README.md b/README.md
index 7e43e18..a8c9399 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
-# task-69f8e929da860fb4533faa2a
+# Memory MCP Server
 
-BroJS homework task 69f8e929da860fb4533faa2a: MCP-сервер для управления памятью агента
\ No newline at end of file
+This repository contains a standalone MCP server built with `fastmcp` and a small async client for smoke testing.
+
+## Files
+
+- `memory_server.py` - MCP server with six memory tools.
+- `memory_client.py` - async client that demonstrates remote tool calls over stdio.
+- `requirements.txt` - runtime dependencies for the assignment.
+
+## Install
+
+```bash
+pip install -r requirements.txt
+```
+
+## Run the client demo
+
+```bash
+python memory_client.py
+```
+
+The server stores data in `memory_data.json` and includes timestamps for every saved record.