# Valeria Store MCP Server

MCP Server đóng gói toàn bộ REST API nội bộ của Valeria Store (`valeriastore.top`) để các Agent (Codex, Hermes, Claude, Cursor) dễ dàng gọi tool quản lý mua thẻ VCC, kiểm tra số dư và theo dõi đơn hàng.

## 🛠️ Danh sách Tool (10 Tools)
- `get_valeria_account_info`: Kiểm tra số dư ví USD, avatar, quyền hạn.
- `list_valeria_cards`: Phân trang & lọc danh sách thẻ VCC đang bán.
- `get_valeria_cart`: Xem danh sách giỏ hàng.
- `add_valeria_card_to_cart`: Thêm thẻ VCC theo `cardId`.
- `quick_buy_valeria_random`: Mua nhanh VCC ngẫu nhiên.
- `quick_buy_valeria_by_base`: Mua nhanh VCC theo loại Base/BIN.
- `remove_valeria_cart_item`: Xóa thẻ khỏi giỏ.
- `clear_valeria_cart`: Xóa sạch giỏ hàng.
- `get_valeria_order_detail`: Chi tiết đơn hàng (Card Number, CVV, Exp).
- `get_valeria_wallet_history`: Xem lịch sử nạp tiền/biến động số dư.

## ⚙️ Cấu hình

Tạo file `.env` từ `.env.example` và điền `VALERIA_TOKEN`:
```env
VALERIA_BASE_URL=https://valeriastore.top/prod-api
VALERIA_TOKEN=your_jwt_bearer_token_here
VALERIA_USERNAME=Thangterter
```

## 🚀 Đăng ký vào MCP Client (Codex / Claude Desktop)

Thêm đoạn sau vào `config.toml` hoặc `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "valeria-store": {
      "command": "C:/Users/thang/HermesAI/.venv/Scripts/python.exe",
      "args": ["C:/Users/thang/valeria-mcp/server.py"],
      "env": {
        "VALERIA_TOKEN": "<dien_jwt_token_sau_khi_login>"
      }
    }
  }
}
```