Platfone - Receive SMS & Virtual Numbers MCP

Máy chủ MCP Platfone

Platfone cung cấp số điện thoại ảo cho việc xác minh tài khoản, thử nghiệm và các quy trình tự động hóa. Máy chủ MCP Platfone cho phép các tác nhân AI nhận số tạm thời và nhận tin nhắn SMS từ các ứng dụng khách tương thích MCP như Claude, VS Code Copilot, Codex, v.v.

📖 Tài liệu · 🔧 Hướng dẫn Cài đặt · 🔑 Lấy Khóa API · 📦 npm

Tại sao MCP?

Thay vì tích hợp API thủ công, các tác nhân AI có thể:

• Tự động đặt số theo quốc gia và tên dịch vụ
• Chờ mã SMS
• Thử lại hoặc hủy kích hoạt

Tất cả thông qua các lệnh gọi công cụ có cấu trúc — không cần backend tùy chỉnh.

Tính năng

• Vòng đời kích hoạt đầy đủ — từ đặt số đến nhận SMS
• Danh mục được lưu bộ nhớ đệm ETag — quốc gia và dịch vụ được lưu trong bộ nhớ với TTL 5 phút và làm mới có điều kiện dựa trên ETag — không bao giờ gửi đến tác nhân
• Đầu vào thân thiện với người dùng — sử dụng "Israel" hoặc "Telegram" thay vì ID; tên được tự động phân giải phía máy chủ
• Vận chuyển kép — stdio và http từ một cơ sở mã duy nhất
• Xác thực khóa API — hoạt động với khóa API Platfone hiện có của bạn

Cài đặt

Xem Hướng dẫn Cài đặt đầy đủ để biết hướng dẫn chi tiết.

Bắt đầu Nhanh

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Hướng dẫn cho Tác nhân

• Luôn gọi check_price trước để xác minh chi phí và tính khả dụng
• Sau đó gọi order_number để thuê số
• Gọi check_sms cho đến khi nhận được SMS hoặc hết hạn
• Sử dụng retry_activation nếu không có SMS nào đến
• Sử dụng cancel_activation để giải phóng tiền nếu không còn cần thiết

Công cụ

Công cụ	Mô tả
get_balance	Kiểm tra số dư tài khoản: tổng, đã đặt trước và khả dụng.
check_price	Kiểm tra giá và tính khả dụng cho cặp quốc gia + dịch vụ trước khi đặt hàng.
order_number	Đặt một số điện thoại ảo. Chấp nhận tên ("Israel") hoặc ID ("il"). Trả về activation_id + phone.
check_sms	Thăm dò trạng thái kích hoạt. Trả về mã SMS khi nhận được, hoặc trạng thái hiện tại với hướng dẫn thăm dò.
retry_activation	Yêu cầu một SMS khác trên cùng một số. Miễn phí.
cancel_activation	Hủy kích hoạt đang hoạt động trước khi nhận SMS. Hoàn lại số tiền đã đặt trước.

Lưu ý: Danh mục quốc gia và dịch vụ được lưu bộ nhớ đệm phía máy chủ và tự động phân giải từ tên dễ đọc. Tác nhân không bao giờ nhận được toàn bộ danh mục — chỉ ID đã phân giải hoặc gợi ý phân biệt.

Luồng Tác nhân AI Điển hình

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Các bước tùy chọn:

• retry_activation — yêu cầu một SMS khác trên cùng một số (miễn phí)
• cancel_activation — hủy trước khi SMS đến (hoàn lại số dư)

Phát triển

Đọc Hướng dẫn Phát triển đầy đủ để biết hướng dẫn thiết lập và mẹo kiểm thử.

Khắc phục sự cố

Lỗi	Giải pháp
UnauthorizedException	Kiểm tra PLATFONE_API_KEY của bạn có hợp lệ không
PaymentRequiredException	Nạp tiền vào số dư Platfone của bạn
NoNumbersAvailableException	Thử quốc gia hoặc dịch vụ khác
TooManyRequestsException	Bị giới hạn tốc độ — chờ và thử lại
MaxPriceExceededException	Thử lại order_number với max_price được đề xuất và order_id đã trả về
TooManyActivationsException	Đã đạt đến số lượng kích hoạt đồng thời tối đa — hủy hoặc chờ hết hạn

Giấy phép

Xem LICENSE.md. Được cấp phép theo Giấy phép MIT.

Việc sử dụng API Platfone tuân theo Điều khoản Dịch vụ và Chính sách Bảo mật.