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ư.

Related MCP server: AgentCard MCP Server

⚙️ Cấu hình

Tạo file .env từ .env.example và điền VALERIA_TOKEN:

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:

{
  "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>"
      }
    }
  }
}