diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7fbaec0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# FAQ Bot Assignment
+
+## Структура
+- `data/faq.md` – локальные конспекты.
+- `meta.json` – статический JSON, имитирующий MCP‑tool.
+- `main.py` – скрипт с загрузкой в Chroma, поиском и простым агентом.
+
+## Запуск
+```bash
+pip install -r requirements.txt
+python main.py
+```
+
+## MCP‑tool
+В продакшене `fetch_course_meta` был бы HTTP‑запрос к MCP‑серверу. Для демонстрации используется статический JSON.