Upload README.md

README.md

@@ -1,55 +1,56 @@
 ---
-title: PokeAPI-MCP
-emoji: 🐾
-colorFrom: red
-colorTo: yellow
+title: Pokémon Card Analyzer MCP
+emoji: 🧠
+colorFrom: blue
+colorTo: green
 sdk: gradio
 sdk_version: 5.32.1
 app_file: app.py
 pinned: false
 license: mit
-short_description: Expose full access to PokéAPI as MCP.
-tags: [mcp-server-track, pokeapi, pokemon, agent, api-wrapper]
+short_description: Get info from pokemon.
+tags: [mcp-server-track, pokemon, ocr, api, agent, card-recognition, battle-simulation]
 ---
 
-# 🐾 PokeAPI-MCP – Agent Access to the Entire PokéAPI
+# 🧠 Pokémon Card Analyzer MCP
 
-**PokeAPI-MCP** is a modular Gradio-based agent toolset that exposes nearly all major endpoints of the [PokéAPI v2](https://pokeapi.co/docs/v2) via a Multi-Component Protocol (MCP) interface. It allows agents to query real-time Pokémon data like species, stats, types, evolutions, and much more — without writing a single line of API code.
+**Pokémon Card Analyzer MCP** is a Multi-Component Program (MCP) built with Gradio that combines OCR, PokéAPI data, and AI-driven logic to analyze Pokémon trading cards and simulate battle scenarios.
 
-## 🎥 Demo Video
+With this tool, agents can recognize physical cards from images, retrieve stats, estimate levels from HP, and generate detailed info sheets. It also supports manual input — and even lets agents simulate Pokémon fights!
 
-▶️ [Watch the demo](https://youtu.be/Hyovc5FYOYo)
+## 🎥 Demo Video
 
+▶️ [Watch the full demo](https://youtu.be/h6TefG1tILs)
 
-## 🎯 What This App Does
+## 🎯 Features
 
-- Wraps all key PokéAPI endpoints (species, evolution, moves, items, abilities, etc.)
-- Exposes each endpoint as a Gradio `Interface`, usable via MCP
-- Dynamically generates JSON outputs for agent-friendly consumption
-- Supports queries by both name and numeric ID
-- Provides automatic error handling and clean descriptions for each tool
+- 🖼️ **Image OCR Recognition** – Detect Pokémon name and HP from real-world card scans or webcam images
+- 🌍 **Multi-language Support** – Translate card names (e.g., French → English) using a custom dictionary
+- 📊 **Level Estimation** – Estimate Pokémon level from observed HP based on official stat formulas
+- 📘 **PokéAPI Integration** – Retrieve evolution chains, base stats, move sets, descriptions, and more
+- ✍️ **Manual Entry Mode** – Input name + level or HP manually to simulate virtual Pokémon sheets
+- ⚔️ **Battle Simulation Ready** – Export usable stats to plug into AI battle logic (Claude, etc.)
 
 ## ✨ Available Tools
 
-- 🔍 `get_pokemon` — full data about a Pokémon
-- 📖 `get_pokemon_species` — flavor text, gender rate, evolution chain
-- 🧠 `get_ability`, `get_stat`, `get_type` — detailed mechanics
-- 🎒 `get_item`, `get_berry` — held/useable item details
-- 🧬 `get_evolution_chain` — structured evolution trees
-- 🌍 `get_region`, `get_location` — geographical data
-- 🗺️ `get_pokedex`, `get_generation`, `get_version`, `get_version_group`
-- 🧬 `get_egg_group`, `get_pokemon_form`, `get_pokemon_shape`, `get_pokemon_color`, `get_pokemon_habitat`
+- `manual_mcp_hp` – Estimate Pokémon level based on HP
+- `manual_mcp_level` – View Pokémon sheet by entering level directly
+- `ocr_mcp` – Upload or scan a card to auto-extract data and get a full PokéAPI-powered report
 
-...and more.
+Each tool is accessible via an individual Gradio `Interface`, MCP-compatible and agent-friendly.
 
-## 🔧 Tech Stack
+## 🛠 Tech Stack
 
-- **Gradio** – for exposing interfaces and MCP support
-- **requests** – lightweight HTTP client for API access
-- **PokéAPI v2** – the full public REST API of the Pokémon world
+- **Gradio MCP** – Modular agent interface with multi-function routing
+- **EasyOCR** – Lightweight text recognition from images
+- **PokéAPI v2** – Official Pokémon REST API
+- **ChromaDB + OpenCLIP** *(optional)* – Vector database for reverse image search
+- **Claude/OpenAI** *(demo)* – Battle simulation logic for agent-based combat
 
-## 💻 Run Locally
+## 📦 Run Locally
 
 ```bash
+git clone https://github.com/your-username/pokemon-mcp
+cd pokemon-mcp
 pip install -r requirements.txt
 python app.py