Toàn bộ bảng tin, qua một lệnh gọi công cụ

MCP

Một endpoint JSON-RPC không trạng thái. Bản giao thức 2026-07-28, nên không có bước bắt tay initialize và không có phiên nào phải giữ.

https://helprentdanang.com/mcp/

Bốn công cụ, tất cả đều chỉ đọc:

• search_listings — Search long-term rental listings in Da Nang by city, district, type, bedrooms and price. Returns listing URLs; contact details are not included, send the person to the URL.
• get_listing — One listing in full, including its description.
• find_buildings — Apartment buildings with a manager, by district.
• market_stats — Median rents by size and district, the middle half of asking prices with the sample behind each figure, and how many listings are on the board. Recomputed nightly.

Không có công cụ ghi. Ở đây không có gì tạo lead, lưu tìm kiếm hay đưa ra thông tin liên hệ, nên không có lệnh gọi nào mà agent thực hiện thay người khác cần được phê duyệt.

HTTP thuần

Cùng dữ liệu đó, nếu bạn không muốn dùng MCP. Mô tả OpenAPI ở dòng cuối.

• GET /api/v1/listings/ — tìm và phân trang qua các tin đăng
• GET /api/v1/listings/<slug>/ — một tin đăng đầy đủ
• GET /api/v1/buildings/ — các tòa căn hộ có người quản lý
• GET /api/v1/districts/ — các quận và số tin trong mỗi quận
• GET /api/v1/market/ — giá thuê trung vị, tính lại hằng đêm
• GET /api/v1/openapi.json — mô tả của tất cả những thứ trên

Giới hạn

600 calls a day per address, counted across MCP and REST together. That is a server-cost ceiling, not a secret — it is set generously enough that an agent working through the city's inventory never meets it. Nothing is ever banned.

Vượt qua mức đó, cả hai bề mặt đều trả 402 kèm yêu cầu thanh toán, mô tả bên dưới. Mọi phản hồi đều kèm phần hạn mức miễn phí còn lại, nên bạn không cần dò trần bằng cách đâm vào nó:

• X-RateLimit-Limit — hạn mức mỗi ngày
• X-RateLimit-Remaining — còn lại bao nhiêu
• X-RateLimit-Reset — thời điểm unix khi hạn mức được nạp lại

Phản hồi có header cache năm phút. Xin hãy tôn trọng nó — đó là phần lớn lý do dịch vụ này còn miễn phí.

Dữ liệu gồm những gì

Tin đăng được thu thập từ các bài công khai trên Telegram, Facebook và Chợ Tốt, cùng với chủ nhà đăng trực tiếp tại đây. Mỗi tin có giá nếu bài gốc nêu giá, có quận, và có liên kết về nguồn. Thông tin liên hệ cố ý không nằm trong API — hãy đưa người dùng tới URL của tin đăng.

Chúng tôi là bảng tin, không phải môi giới. Chúng tôi không xác minh chủ nhà tại chỗ, không giữ tiền cọc, không bảo lãnh cho ai. Agent chuyển dữ liệu của chúng tôi cho người dùng nên chuyển cả điều này.

Vượt mức miễn phí

Vượt hạn mức hằng ngày, các endpoint trả về 402 kèm yêu cầu thanh toán x402 thay vì từ chối thẳng. Thanh toán xong thì chính yêu cầu đó đi qua.

Đó là x402, giao thức thanh toán HTTP 402, scheme "exact". Một yêu cầu thanh toán mang ba mục trong mảng accepts, USDC trên Base, USDC trên Solana và USDC trên Arc, và client của bạn chọn chuỗi mà nó đang có tiền. Ba header, đều là JSON mã hóa base64:

• PAYMENT-REQUIRED — phản hồi 402 của chúng tôi mang header này: JSON mã hóa base64 ghi rõ số tiền, token và địa chỉ
• PAYMENT-SIGNATURE — gửi lại yêu cầu với header này: ủy quyền EIP-3009 đã ký trên Base hoặc Arc, hoặc giao dịch đã ký một phần trên Solana
• PAYMENT-RESPONSE — phản hồi 200 tiếp theo trả lại cho bạn mã giao dịch

Trên Arc, thanh toán đi qua nanopayments của Circle Gateway: nạp USDC vào Gateway một lần, sau đó ký ủy quyền EIP-3009 cho hợp đồng GatewayWallet ghi trong mục đó, có hiệu lực ít nhất bảy ngày. Không có giao dịch on-chain nào cho từng lần gọi, và PAYMENT-RESPONSE trả về mã chuyển khoản của Gateway thay cho mã giao dịch.

Lưu ý tên header không có tiền tố X- — đó là phiên bản 1, và client viết theo nó sẽ hoàn toàn không thấy yêu cầu thanh toán của chúng tôi.

One payment buys 5000 calls, not one — settling on chain per request would put a blockchain write between you and every listing you read.

Lượt gọi đã mua được ghi có cho địa chỉ gọi, không phải cho ví đã trả, vì API này không có tài khoản và không có khóa — ở request ngay sau khi thanh toán, không còn gì khác gắn bạn với ví đó. Nếu địa chỉ ra ngoài của bạn thay đổi, phần còn lại không đi theo bạn.

Chúng tôi nhận gì

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0xf68bc1098469356eb57e70db9fed0bb524707132",
    "maxTimeoutSeconds": 60,
    "extra": {
      "name": "USD Coin",
      "version": "2"
    }
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "amount": "10000",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "payTo": "6J7dpvZu4f3vYcRd3TY7dpjXZSYCRdLVfXkxtv3Ycz3j",
    "maxTimeoutSeconds": 60,
    "extra": {
      "feePayer": "CjNFTjvBhbJJd2B5ePPMHRLx1ELZpa8dwQgGL727eKww"
    }
  },
  {
    "scheme": "exact",
    "network": "eip155:5042",
    "amount": "10000",
    "asset": "0x3600000000000000000000000000000000000000",
    "payTo": "0xf68bc1098469356eb57e70db9fed0bb524707132",
    "maxTimeoutSeconds": 604900,
    "extra": {
      "name": "GatewayWalletBatched",
      "version": "1",
      "verifyingContract": "0x77777777dcc4d5a8b6e418fd04d8997ef11000ee"
    }
  }
]

Mảng accepts đúng như 402 gửi đi, dựng từ chính hàm đó, nên trang này không thể tụt lại sau yêu cầu thanh toán. Chọn một mục và trả tiền; bản thân yêu cầu đã đủ đầy đủ để trả mà không cần đọc trang này.

Một phản hồi 402 thật, từ đầu đến cuối

# 1. over the free line, no payment attached
curl -i https://helprentdanang.com/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQQVlNRU5U...
cache-control: no-store

# 2. decode the header to see what is being asked for
echo '<that value>' | base64 -d | jq .

# 3. sign what your chosen entry describes (EIP-3009 on Base, a partially
#    signed transaction on Solana, EIP-3009 for Circle Gateway on Arc), then repeat the SAME request
curl -i https://helprentdanang.com/mcp/ \
  -H 'Content-Type: application/json' \
  -H 'PAYMENT-SIGNATURE: <base64 of your PaymentPayload>' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP/2 200
payment-response: eyJzdWNjZXNzIjp0cnVlLCJ0cmFuc2FjdGlvbiI6IjB4...

Chỉ đọc, và đó là một quyết định

Không có công cụ ghi nào và chưa từng có. Không có gì ở đây tạo lead, lưu tìm kiếm, gửi tin nhắn hay tiêu tiền thay ai, nên không có lệnh gọi nào trên máy chủ này cần người phê duyệt. Mọi công cụ đều mang readOnlyHint và destructiveHint trong annotations, để host của bạn biết điều đó mà không cần tin lời chúng tôi.

Thông tin liên hệ không bao giờ được trả về — không số điện thoại, không liên kết WhatsApp, không URL nguồn dẫn tới chúng, và cũng không nằm trong mô tả tin đăng. Agent có thể đọc mọi thứ về một chỗ ở và đưa người dùng tới trang của chúng tôi để liên hệ người đăng. Trang đó có giới hạn tần suất, có ghi log, và mang cảnh báo hãy xem trước khi trả tiền; một liên hệ phát qua API thì không kèm theo bất kỳ thứ nào trong số đó.

Văn bản tự do đã lưu được coi là không đáng tin khi đi ra: mô tả tin đăng là bài viết do người lạ soạn, và phục vụ nó nguyên bản sẽ biến chúng tôi thành phương tiện đưa một injection vào agent của bạn.