POST
/api.php?action=create
Tạo email mới (ngẫu nhiên hoặc tự chọn). Nếu email đã tồn tại sẽ trả về HTTP 409 Conflict.
// Payload (JSON hoặc Form-data)
{
"username": "user123", // Không truyền để sinh ngẫu nhiên
"domain": "mcpvietnam.com"
}
// Phản hồi thành công (HTTP 201)
{
"success": true,
"message": "Khởi tạo email tạm thời thành công",
"data": {
"id": 15,
"email": "user123@mcpvietnam.com",
"username": "user123",
"domain": "mcpvietnam.com",
"token": "a1b2c3d4e5f6...",
"created_at": "2026-10-15 18:30:00",
"expires_at": "2026-10-16 18:30:00"
}
}
// Khi email đã có trong hệ thống (HTTP 409)
{
"success": false,
"error": "MAILBOX_ALREADY_EXISTS",
"message": "Email [user123@mcpvietnam.com] đã tồn tại trong hệ thống! Không được phép tạo lại."
}
GET
/api.php?action=messages&email=user123@mcpvietnam.com&token=YOUR_TOKEN
Lấy danh sách các bức thư đã nhận trong hộp thư.
{
"success": true,
"email": "user123@mcpvietnam.com",
"count": 1,
"messages": [
{
"id": 88,
"sender": "no-reply@facebook.com",
"sender_name": "Facebook",
"subject": "Mã xác thực của bạn là 492104",
"snippet": "Chào bạn, mã xác nhận đăng ký tài khoản của bạn là 492104...",
"is_read": 0,
"created_at": "2026-10-15 18:32:10",
"attachments_count": 0
}
]
}
GET / POST
/get_code.php?email=user@mcpvietnam.com&pass=123456
Endpoint chuyên dụng tự động kiểm tra tài khoản, quét email nhận được trong 3 phút gần nhất theo mẫu Use code 900254 to log in và chỉ xuất ra mỗi mã code (Plain Text).
✔ Khi tìm thấy mã code:
900254
✖ Các trường hợp phản hồi lỗi:
- • Không có thư/code trong 3p:
error_notfound_code
- • Email không tồn tại:
error_account_notfound
- • Mật khẩu sai:
error_wrong_password
- • Thiếu email hoặc pass:
error_missing_params
Code mẫu Python (Dành cho Tool Reg Mail):
import requests
import time
BASE_URL = "https://mcpvietnam.com"
# 1. Tạo email ngẫu nhiên
res = requests.post(f"{BASE_URL}/api.php?action=create", json={"domain": "mcpvietnam.com"})
data = res.json()
if not data.get("success"):
print("Lỗi:", data.get("message"))
exit()
email = data["data"]["email"]
token = data["data"]["token"]
print(f"[*] Đã tạo email: {email}")
# 2. Vòng lặp chờ nhận mã OTP
print("[*] Đang chờ thư gửi tới...")
for _ in range(30):
check = requests.get(f"{BASE_URL}/api.php?action=messages&email={email}&token={token}").json()
if check.get("count", 0) > 0:
latest = check["messages"][0]
print(f"[+] Nhận được email từ {latest['sender']} | Tiêu đề: {latest['subject']}")
# Đọc chi tiết nội dung thư để lấy mã OTP
detail = requests.get(f"{BASE_URL}/api.php?action=message&id={latest['id']}&token={token}").json()
print(f"[+] Nội dung text: {detail['data']['body_text']}")
break
time.sleep(3)