Bounty Api

bountyapi-mcp

BountyAPI 用の MCP サーバー — x402 の少額決済に対応した、AI エージェント向けの専門データ API です。

AI エージェント（Claude Desktop、Cursor など）を、https://bountyapi.com の BountyAPI エンドポイントに接続します。無料のエンドポイントはそのまま利用できます。有料のエンドポイントには、チャージ済みのウォレットが必要です。エージェントがリクエストごとに自動で支払います。

クイックスタート

無料ツールのみ（ウォレット不要）

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

決済に対応する場合（有料エンドポイントは自動決済）

1. $2～5 相当の USDC を入れた Base の使い捨てウォレットを作成します
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 に質問します：

「シンガポール市民が初めて自宅を購入する場合、シンガポールで価格が 150 万ドルの物件にかかる印紙税はいくらですか？」

「Tampines の最近の HDB 中古物件取引を検索してください。4 ROOM のみでお願いします」

「月額 4,200 ドルで賃貸する 120 万ドルのコンドミニアムの賃貸利回りはいくらですか？」

決済の仕組み

エージェントが有料エンドポイントを呼び出すと：

1. サーバーが支払い手順とともに 402 Payment Required を返します
2. MCP サーバーが料金を読み取り、MAX_SPEND_USD と照合します
3. 上限以内であれば、Base 上で USDC の送金に署名し、再試行します
4. ファシリテーターが支払いを検証し、サーバーがデータを返します
5. 決済記録には Basescan のトランザクションリンクが記録されます

エージェントに支払いが表示されることはなく、データを受け取るだけです。費用は有料リクエスト 1 回あたり約 $0.01 です。

利用可能なツール

sg_stamp_duty（無料）

シンガポールの不動産印紙税（BSD + ABSD）を計算します。

• 購入者の区分：SC、SPR、FR、法人、デベロッパー、受託者
• 税額合計、実効税率、税率区分ごとの内訳を返します
• データソース：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	1 回のリクエストで支出できる 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