docs: update README with comprehensive project documentation

- Add detailed project description and features overview
- Document available MCP tools with parameters and return values
- List supported audio/video file formats and size limits
- Provide MCP integration examples for different client types (SSE, stdio)
- Include YAML configuration for ContinueDev extension
- Add authentication methods and usage example
- Organize with clear sections and emoji icons for readability

README.md

@@ -1,8 +1,7 @@
 ---
 title: Transcript Generator
+author: Enrique Cardoza
 emoji: 💻
-colorFrom: green
-colorTo: indigo
 sdk: gradio
 sdk_version: 5.33.0
 app_file: app.py
@@ -15,4 +14,121 @@ tags:
   - api
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Transcript Generator
+
+A powerful MCP (Model Context Protocol) server that transcribes audio and video files into text using Groq's Whisper model. This tool enables AI assistants to process audio content, making multimedia data accessible for analysis and understanding.
+
+## 🔍 Project Description
+
+Transcript Generator is an AI-powered transcription service built for the Gradio Agents & MCP Hackathon 2025. It leverages Groq's implementation of the Whisper Large V3 Turbo model to accurately convert spoken content from audio and video files into written text.
+
+The service supports:
+- File uploads (up to 25MB)
+- Direct URL transcription
+- Various audio/video formats
+- Integration with MCP clients
+
+## 🛠️ Available MCP Tools
+
+### 1. `transcript_generator_transcribe_audio`
+
+Transcribes audio/video files uploaded directly to the service (runs in local).
+
+**Parameters:**
+- `audio_file` (string): Path to an audio or video file to transcribe
+- `api_key` (string): Your Groq API key, required for authentication
+
+**Returns:** A text transcript of the spoken content in the audio file
+
+### 2. `transcript_generator_transcribe_audio_from_url`
+
+Transcribes audio/video files from a URL.
+
+**Parameters:**
+- `audio_url` (string): URL to an audio or video file to transcribe (http or https)
+- `api_key` (string): Your Groq API key, required for authentication
+
+**Returns:** A text transcript of the spoken content in the audio file
+
+## 📋 Supported File Formats
+
+- **Audio formats:** MP3, MPGA, M4A, WAV, FLAC, OGG, AAC
+- **Video formats:** MP4, MPEG, WebM
+- **Maximum file size:** 25MB
+
+## 🔌 MCP Integration
+
+### SSE Configuration (Cursor, Windsurf, Cline)
+
+To add this MCP to clients that support SSE, add the following to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "url": "https://agents-mcp-hackathon-transcript-generator.hf.space/gradio_api/mcp/sse"
+    }
+  }
+}
+```
+
+### Stdio Configuration (Node.js required)
+
+For clients that only support stdio:
+
+```json
+{
+  "mcpServers": {
+    "gradio": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://agents-mcp-hackathon-transcript-generator.hf.space/gradio_api/mcp/sse",
+        "--transport",
+        "sse-only"
+      ]
+    }
+  }
+}
+```
+
+### YAML Configuration (ContinueDev extension)
+
+```yaml
+name: Transcript MCP Server
+description: A new MCP server for handling transcripts.
+version: 0.0.1
+schema: v1
+mcpServers:
+  - name: Transcript MCP server
+    command: npx
+    args:
+      - mcp-remote
+      - https://agents-mcp-hackathon-transcript-generator.hf.space/gradio_api/mcp/sse
+      - --transport
+      - sse-only
+```
+
+## 🔑 Authentication
+
+You'll need a Groq API key to use this service. You can obtain one from the [Groq Console](https://console.groq.com/).
+
+The API key can be provided in several ways:
+1. As a parameter in the tool call
+2. Set as an environment variable (`GROQ_API_KEY`)
+3. In the request headers (for certain clients)
+
+## 💡 Usage Example
+
+When using with an AI assistant that supports MCP, you can request transcriptions with prompts like:
+
+> "Please generate the transcript for this audio file: https://huggingface.co/spaces/anewryzm/transcript-generator-client/resolve/main/test_files/this%20people%203.m4a"
+
+The assistant will use the appropriate MCP tool to fetch and return the transcript.
+
+## 🔗 Useful Links
+
+- [Get your Groq API key](https://console.groq.com/)
+- [Groq Documentation](https://console.groq.com/docs)
+- [Supported audio formats](https://platform.openai.com/docs/guides/speech-to-text)
+- [Hugging Face Spaces Configuration](https://huggingface.co/docs/hub/spaces-config-reference)