From f862220a0451f7f4f1e84dce143a36d287db6a8c Mon Sep 17 00:00:00 2001
From: Tien Nguyen Minh <tiennm99@outlook.com>
Date: Mon, 11 May 2026 20:15:34 +0700
Subject: [PATCH] docs: flesh out README

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

diff --git a/README.md b/README.md
index f08a2e6..db9f6d1 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,22 @@
 # telegram-mcp
-Telegram MCP server to use bot. Can be hosted on Cloudflare Worker
+
+Telegram MCP server exposing a bot via the [Model Context Protocol](https://modelcontextprotocol.io). Can be hosted on Cloudflare Workers.
+
+## Quick start
+
+```bash
+npm install
+# Set secrets:
+wrangler secret put TELEGRAM_TOKEN
+wrangler secret put TELEGRAM_CHAT_ID
+wrangler secret put MCP_SECRET   # optional auth token
+
+# Deploy
+wrangler deploy
+```
+
+Local dev: `wrangler dev`
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE).