Bounty Api

io.github.vncent786Published by GitHub account vncent786v1.8.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

BountyAPI MCP server giving AI assistants Singapore property and financial data tools, with optional automatic USDC micropayments for paid endpoints.

What you can do
Calculate Singapore property stamp duty (BSD and ABSD) by buyer profile, with tier-by-tier breakdowns sourced from IRAS data, and look up postal codes to the 28 districts (free tools). Calculate rental investment metrics such as gross and net yield, cap rate, price-to-rent ratio and cashflow (paid). Retrieve HDB resale median prices by town and flat type, and search individual HDB resale transactions by town, flat type and price range (paid). Paid calls are settled automatically in USDC on Base when a wallet key is configured.
When to use it
Useful when an assistant needs Singapore property figures: stamp duty estimates, postal district lookups, rental yield calculations, or HDB resale price research. The free tools work without any wallet; paid tools suit users who want automated per-request data purchases.
Requirements
Runs as a remote endpoint or as a local npm package (bountyapi-mcp) via npx, needing Node.js. Network access to the API is required. Paid endpoints need a funded Base wallet with USDC and the EVM_PRIVATE_KEY environment variable; MAX_SPEND_USD caps spend per request (default 1.00) and BOUNTY_API_URL overrides the base URL.
Before you install
Paid endpoints spend real money: each call costs about one cent in USDC and is signed automatically from the configured wallet. EVM_PRIVATE_KEY is a wallet private key; the README advises using a dedicated burner wallet with only a few dollars, never a main wallet. Set MAX_SPEND_USD to limit charges. Free tools need no key.

Installation

In SourceWeft

  1. Open Bounty Api in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.vncent786%2Fbounty-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: mcp-server/README.md at commit b318241

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.8.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.