Bounty Api

bountyapi-mcp

BountyAPI 的 MCP 服务——为 AI Agent 提供专业数据 API，并支持 x402 小额支付。

将 AI Agent（Claude Desktop、Cursor 等）连接到 https://bountyapi.com 上的 BountyAPI 端点。免费端点开箱即用。付费端点需要已充值的钱包——Agent 会按请求自动付款。

快速开始

仅使用免费工具（无需钱包）

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

启用支付支持（付费端点自动付款）

1. 在 Base 上创建一个临时钱包，并存入价值 $2-5 的 USDC
2. 导出私钥
3. 配置：

{
  "mcpServers": {
    "bounty": {
      "command": "npx",
      "args": ["bountyapi-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xyour_private_key_here",
        "MAX_SPEND_USD": "1.00"
      }
    }
  }
}

或通过 CLI：

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

然后向 AI 提问：

“新加坡公民首次购房，在新加坡购买价值 $1.5M 的房产，需要缴纳多少印花税？”

“搜索 Tampines 最近的 HDB 转售交易，仅限 4 ROOM”

“一套价值 $1.2M 的公寓，月租 $4,200，租金收益率是多少？”

支付工作原理

当 Agent 调用付费端点时：

1. 服务返回包含支付说明的 402 Payment Required
2. MCP 服务读取价格，并与 MAX_SPEND_USD 进行核对
3. 如果未超出限额，则在 Base 上签署 USDC 转账并重试
4. 服务通过 facilitator 验证支付并返回数据
5. 结算记录会附上 Basescan 交易链接

Agent 不会看到支付过程——它只会收到数据。费用：每次付费调用约 $0.01。

可用工具

sg_stamp_duty（免费）

计算新加坡房产印花税（BSD + ABSD）。

• 买家类型：SC、SPR、FR、entity、developer、trustee
• 返回税费总额、实际税率以及逐档明细
• 来源：IRAS（iras.gov.sg）

sg_postal_lookup（免费）

查询新加坡邮政编码对应的地区。

• 涵盖全部 28 个邮区及地区名称
• 返回邮区编号、名称和区域

sg_rental_yield（付费）

计算租赁投资指标。

• 毛收益率、净收益率、资本化率
• 房价租金比、月现金流、回本年限

hdb_resale_median（付费）

按城镇获取 HDB 转售价格数据。

• 涵盖全部 26 个 HDB 城镇
• 按户型划分的中位数价格（2 ROOM 至 EXECUTIVE）
• 来自 data.gov.sg 的抽样交易汇总数据

hdb_resale_search（付费）

按筛选条件搜索 HDB 转售交易。

• 按城镇、户型和价格范围筛选
• 返回单笔交易记录

环境变量

变量	默认值	描述
EVM_PRIVATE_KEY	(none)	用于自动支付的 Base 钱包私钥
MAX_SPEND_USD	1.00	单次请求的 USDC 最高支出
BOUNTY_API_URL	https://bountyapi.com	API 基础 URL

安全

• 切勿使用主钱包。 在 Base 上创建专用临时钱包，只存入少量 USDC。
• MAX_SPEND_USD 限额可防止意外扣费——每次请求都会在支付前进行检查。
• 私钥绝不会被记录，也不会传输到 API 服务端。私钥只用于在本地签署支付授权。

开发

npm install
npm run build
node dist/index.js

许可证

MIT