Update README.md

README.md

@@ -19,8 +19,6 @@ tags:
 
 # 𓀀 Egyptian Hieroglyph Detector (MCP Server)
 
-Welcome to our submission for the ​**MCP Hackathon (Track 1: Building MCP)** !
-
 This project bridges the gap between ancient history and modern AI Agents. It provides an **MCP Server** that allows Ai Agents to "see" and identify Hieroglyphs in any image.
 
 ## 👥 Team
@@ -34,9 +32,6 @@ This project bridges the gap between ancient history and modern AI Agents. It pr
 | :---: | :---: | :---: |
 | [![Gradio App V2](https://img.youtube.com/vi/nnQnNfJtSWM/hqdefault.jpg)](https://youtu.be/nnQnNfJtSWM) | [![Mobile Camera Test](https://img.youtube.com/vi/wZKBVYAZwZ4/hqdefault.jpg)](https://youtu.be/wZKBVYAZwZ4) | [![MCP Server](https://img.youtube.com/vi/Vvlu6sDzsBE/hqdefault.jpg)](https://youtu.be/Vvlu6sDzsBE) |
 
-## 🚨🌍 IMPORTANT NOTICE FOR HACKATHON 🤖
-
-We are participating in the **Creative Track** (`building-mcp-track-creative`) because this tool unlocks new cultural and educational capabilities for AI agents.
 
 🔗 **Social Media Post:**  
 [[Gradio App - V2](https://www.linkedin.com/posts/youkii-xr_our-hieroglyphic-ai-detector-just-got-a-major-activity-7400855950632411136-5Z9Y?utm_source=social_share_send&utm_medium=member_desktop_web&rcm=ACoAADSn0yMBo1MdVldbeoL5OxUZo2-CMJKUKOM)]<br>
@@ -46,18 +41,44 @@ We are participating in the **Creative Track** (`building-mcp-track-creative`) b
 
 ## 🗂️ Capabilities & Tools
 
-When connected to Claude, this server exposes two powerful tools:
+#### Hieroglyphs Detection:
+* trained on 400+ different glyphs
+* able to detect with high confidence
+
+#### Translation
+* **Mystical prophecy** : translates for tourists and non-academics as a story
+* **Academic Translation** : a linguistics breakdown of symbols and their meaning and how they fit together
+
+#### Analytics
+* **Spatial Heatmaps** : visualizes where glyphs are clustered on the wall / papyrus
+* **Confidence Charts** : Shows how sure the AI is about every symbol
+* **Frequency Analysis** : Counts the occurrence of distinguished symbols
+
+#### Digital Encyclopedia
+* Includes a searchable database of supported Gardiner Codes with descriptions and transliteration
+
+#### Downloadable Results
+* Download the detection result with bounding boxes surrounding each glyph on the wall / papyrus
+* Download glyphs gallery as a zip containing all glyphs detected individually cropped
+
+## 🔌Available MCP Tools
+When connected to Claude Desktop, this server exposes **4 specific tools** that allow the Agent to perform the full archaeological pipeline:
 
-### 1. `detect_hieroglyphs` (The AI Eye)
+#### `detect glyphs`
+* **Description:** Scans an input image to find hieroglyphs.
+* **Returns:** A path to the annotated image (boxes drawn) and a JSON object containing the list of found codes and confidence scores.
 
-- **Purpose:**  Takes an image input and performs object detection for Egyptian Hieroglyphs.
-- **Output:**  Returns an annotated image with bounding boxes drawn around symbols, plus a JSON summary of symbol counts (e.g., "3x Owl", "1x Water").
-- **Model:**  Powered by a finetuned YOLOv8 model specialized on the Gardiner Sign List with over 18,249 image.
+#### `translate story`
+* **Description:** Takes a list of Gardiner codes or keywords and interprets them.
+* **Returns:** Two distinct texts: a "Mystical Story" (creative interpretation) and an "Academic Translation" (scientific interpretation).
 
-### 2. `upload_file` (The Bridge)
+#### `get stats`
+* **Description:** Takes the detection data and generates visual reports.
+* **Returns:** A path to an image file containing charts for Symbol Frequency, Confidence Levels, and Spatial Heatmaps.
 
-- **Purpose:**  Solves the "Local vs. Cloud" problem. Since the server runs in the cloud, it cannot see your `C:` drive.
-- **Function:**  Claude uses this tool to upload a specific local image to the secure temporary storage of the Space, returning a valid URL for the AI Eye to process.
+#### `list codes`
+* **Description:** Provides access to the full internal database of Egyptian hieroglyphs.
+* **Returns:** The complete dictionary of supported Gardiner codes, descriptions, and categories.
 
 ## 🚀 How to Use (Claude Desktop)