Bounty Api

io.github.vncent786由 GitHub 帳號 vncent786 發布v1.8.0更新於 Oct 25, 2026

Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.

已驗證Streamable HTTP可網頁執行位置與生活金融

概覽

AI 產生的概覽

BountyAPI MCP 伺服器，為 AI 助理提供新加坡房產與金融資料工具，付費端點可選用 USDC 微支付自動結算。

可以做什麼
依買方身分計算新加坡房產印花稅（BSD 與 ABSD），並提供分級明細，資料來源為 IRAS（免費）。將新加坡郵遞區號查詢對應到 28 個郵區（免費）。計算租金投資指標，如毛收益率、淨收益率、資本化率、租售比與現金流（付費）。依城鎮與房型取得組屋轉售中位價，並依城鎮、房型與價格區間搜尋單筆組屋轉售交易（付費）。設定錢包金鑰後，付費呼叫會在 Base 上以 USDC 自動結算。
適用情境
適合需要新加坡房產資料的情境：印花稅估算、郵區查詢、租金收益率計算或組屋轉售價格研究。免費工具無需錢包即可使用；付費工具適合希望按次自動購買資料的使用者。
執行需求
可作為遠端端點使用，也可透過 npx 以本機 npm 套件（bountyapi-mcp）執行，需要 Node.js。需要能連線至該 API 的網路。付費端點需要 Base 上存有 USDC 的錢包及環境變數 EVM_PRIVATE_KEY；MAX_SPEND_USD 限制單次請求花費（預設 1.00），BOUNTY_API_URL 可覆寫基礎位址。
安裝前請注意
付費端點會花費真實資金：每次呼叫約一美分 USDC，並由所設定的錢包自動簽署付款。EVM_PRIVATE_KEY 是錢包私鑰；README 建議使用僅存少量資金的專用一次性錢包，切勿使用主錢包。請設定 MAX_SPEND_USD 以限制支出。免費工具無需金鑰。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Bounty Api，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.vncent786%2Fbounty-api/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "bounty-api": {
      "type": "http",
      "url": "https://bountyapi.com/mcp"
    }
  }
}

README

bountyapi-mcp

MCP server for BountyAPI — specialist data APIs for AI agents with x402 micropayment support.

Connect AI agents (Claude Desktop, Cursor, etc.) to BountyAPI endpoints at https://bountyapi.com. Free endpoints work out of the box. Paid endpoints require a funded wallet — the agent pays automatically per request.

Quick Start

Free tools only (no wallet needed)

json
{  "mcpServers": {    "bounty": {      "command": "npx",      "args": ["bountyapi-mcp"]    }  }}

With payment support (paid endpoints auto-pay)

  1. Create a burner wallet on Base with $2-5 of USDC
  2. Export the private key
  3. Configure:
json
{  "mcpServers": {    "bounty": {      "command": "npx",      "args": ["bountyapi-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0xyour_private_key_here",        "MAX_SPEND_USD": "1.00"      }    }  }}

Or via CLI:

bash
EVM_PRIVATE_KEY=0x... MAX_SPEND_USD=1.00 npx bountyapi-mcp

Then ask your AI:

"What's the stamp duty for a $1.5M property in Singapore for a Singapore Citizen buying their first home?"

"Search for recent HDB resale transactions in Tampines, 4 ROOM only"

"What's the rental yield on a $1.2M condo renting at $4,200/month?"

How Payments Work

When an agent calls a paid endpoint:

  1. Server returns 402 Payment Required with payment instructions
  2. MCP server reads the price and checks against MAX_SPEND_USD
  3. If within limit, it signs a USDC transfer on Base and retries
  4. Server verifies payment via facilitator and returns data
  5. Settlement is logged with a Basescan transaction link

The agent never sees the payment — it just gets the data. Cost: ~$0.01 per paid call.

Available Tools

sg_stamp_duty (FREE)

Calculate Singapore property stamp duty (BSD + ABSD).

  • Buyer profiles: SC, SPR, FR, entity, developer, trustee
  • Returns total duty, effective rate, and tier-by-tier breakdown
  • Source: IRAS (iras.gov.sg)

sg_postal_lookup (FREE)

Look up Singapore postal code to district.

  • All 28 postal districts with area names
  • Returns district number, name, and areas

sg_rental_yield (PAID)

Calculate rental investment metrics.

  • Gross yield, net yield, cap rate
  • Price-to-rent ratio, monthly cashflow, years to break even

hdb_resale_median (PAID)

Get HDB resale price data by town.

  • All 26 HDB towns
  • Median prices by flat type (2 ROOM through EXECUTIVE)
  • Sampled transaction aggregates from data.gov.sg

hdb_resale_search (PAID)

Search HDB resale transactions with filters.

  • Filter by town, flat type, price range
  • Returns individual transaction records

Environment Variables

VariableDefaultDescription
EVM_PRIVATE_KEY(none)Base wallet private key for automatic payments
MAX_SPEND_USD1.00Max USDC to spend per single request
BOUNTY_API_URLhttps://bountyapi.comAPI base URL

Safety

  • Never use your main wallet. Create a dedicated burner wallet with only a few dollars of USDC on Base.
  • The MAX_SPEND_USD limit prevents unexpected charges — each request is checked before payment.
  • Private keys are never logged or transmitted to the API server. They only sign local payment authorizations.

Development

bash
npm installnpm run buildnode dist/index.js

License

MIT

來源：mcp-server/README.md，提交 b318241

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.8.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。