nft-farm-mcp — bản tóm tắt tiếng Việt

Tài liệu đầy đủ (tham số từng tool, cách đọc số, xử lý lỗi) nằm ở README.md — viết tiếng Anh vì đối tượng đọc chính là AI agent và npm chỉ hiển thị file đó.

Công cụ tìm bộ NFT free-mint có lãi và ví đang farm chúng, xếp hạng bằng PnL secondary đọc thẳng on-chain. Chạy được trên mọi EVM chain có Seaport, mặc định Robinhood.

Không cần API key, không cần ví, không gửi giao dịch. Cần Node ≥ 20.

Cài

claude mcp add nft-farm -- npx -y nft-farm-mcp@latest

Bốn tool

list_chains → scan_collections → job_status → scan_wallets.

Luôn truyền async: true trừ khi cửa sổ rất nhỏ — scan mặc định (7 ngày, probe: 80) mất vài phút, chạy inline sẽ timeout ở phía client.

Ba điều dễ đọc sai nhất

1. athEth / floorEth chỉ tính trong cửa sổ đã quét — không phải đỉnh mọi thời đại, cũng không phải floor listing đang treo. Quét 1 ngày thì "ATH" chỉ là giá bán cao nhất trong ngày đó.
2. realizedPnlEth là tiền bán gộp, chưa trừ gas/royalty/phí sàn, và chỉ tính lệnh bán dạng listing trên các bộ được seed. Đây là con số duy nhất dựa trên giao dịch thật; estUnrealizedAvgEth chỉ là mark-to-market phần chưa bán.
3. freeMint: null nghĩa là chưa xác định, không phải "mint trả phí" — hết ngân sách mintProbeCalls. Verdict free/paid lấy mẫu tối đa 8 giao dịch mint, free khi ≥80% có value == 0, nên mint trả bằng ERC-20 hoặc qua router sẽ bị đọc nhầm thành free.

Tất cả field *Eth là chuỗi thập phân, không phải số — parse trước khi so sánh. Đơn vị là native token của chain (POL trên Polygon, APE trên ApeChain…), dù tên field có hậu tố Eth.

CLI

npx -y -p nft-farm-mcp nft-farm scan --days 7 --top 20
npx -y -p nft-farm-mcp nft-farm chains
nft-farm --help

Không phải lời khuyên tài chính; tự verify on-chain trước khi copy ví.