Bounty API

Official27 toolsLive

by vncent786 · Python

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

Topics

ai-agentsapi-marketplacebasefastapimcpmicropaymentsmodel-context-protocolusdcx402

Captured live from the server via tools/list.

sg_stamp_duty

Calculate Singapore property stamp duty (BSD + ABSD). buyer_profile: SC (citizen), SPR (PR), FR (foreigner), entity, developer. Returns total duty, tier breakdown, and effective rate.

Parameters4

price	number	required
property_type	string	optional
buyer_profile	string	optional
property_count	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "price": {
      "title": "Price",
      "type": "number"
    },
    "property_type": {
      "default": "residential",
      "title": "Property Type",
      "type": "string"
    },
    "buyer_profile": {
      "default": "SC",
      "title": "Buyer Profile",
      "type": "string"
    },
    "property_count": {
      "default": 1,
      "title": "Property Count",
      "type": "integer"
    }
  },
  "required": [
    "price"
  ],
  "title": "sg_stamp_dutyArguments"
}

sg_postal_lookup

Look up a Singapore 6-digit postal code to find its district number, district name, and area classification (CCR/RCR/OCR).

Parameters1

postal_code

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "postal_code": {
      "title": "Postal Code",
      "type": "string"
    }
  },
  "required": [
    "postal_code"
  ],
  "title": "sg_postal_lookupArguments"
}

sg_address_intel

Full address intelligence: district, planning area, CCR/RCR/OCR region, HDB town, approximate coordinates, and 5 nearest MRT stations with walking distance.

Parameters1

postal_code

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "postal_code": {
      "title": "Postal Code",
      "type": "string"
    }
  },
  "required": [
    "postal_code"
  ],
  "title": "sg_address_intelArguments"
}

sg_mrt_near

Find nearest MRT stations to a Singapore postal code. Returns station name, lines, distance, and walking time.

Parameters2

postal_code	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "postal_code": {
      "title": "Postal Code",
      "type": "string"
    },
    "limit": {
      "default": 5,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "postal_code"
  ],
  "title": "sg_mrt_nearArguments"
}

sg_mrt_search

Search MRT stations by name. Returns all matching stations with line codes.

Parameters2

q	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "title": "Q",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "q"
  ],
  "title": "sg_mrt_searchArguments"
}

sg_affordability

Calculate MAS TDSR/MSR affordability. Checks if a property is affordable under Singapore's mortgage regulations. Returns max loan and property price.

Parameters7

monthly_income	number	required
property_price	number	required
loan_type	string	optional
existing_monthly_debt	number	optional
loan_tenure_years	integer	optional
borrower_age	integer	optional
housing_loan_count	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "monthly_income": {
      "title": "Monthly Income",
      "type": "number"
    },
    "property_price": {
      "title": "Property Price",
      "type": "number"
    },
    "loan_type": {
      "default": "bank_private",
      "title": "Loan Type",
      "type": "string"
    },
    "existing_monthly_debt": {
      "default": 0,
      "title": "Existing Monthly Debt",
      "type": "number"
    },
    "loan_tenure_years": {
      "default": 30,
      "title": "Loan Tenure Years",
      "type": "integer"
    },
    "borrower_age": {
      "default": 35,
      "title": "Borrower Age",
      "type": "integer"
    },
    "housing_loan_count": {
      "default": 1,
      "title": "Housing Loan Count",
      "type": "integer"
    }
  },
  "required": [
    "monthly_income",
    "property_price"
  ],
  "title": "sg_affordabilityArguments"
}

sg_property_analyze

Complete property investment analysis: stamp duty, comparables, yield, affordability, and location in one call. The most comprehensive SG property API.

Parameters13

property_price	number	required
property_type	string	optional
region	string	optional
town	string	optional
flat_type	string	optional
postal_code	string	optional
monthly_rent	number	optional
buyer_profile	string	optional
property_count	integer	optional
monthly_income	number	optional
existing_monthly_debt	number	optional
loan_tenure_years	integer	optional
borrower_age	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "property_price": {
      "title": "Property Price",
      "type": "number"
    },
    "property_type": {
      "default": "hdb",
      "title": "Property Type",
      "type": "string"
    },
    "region": {
      "default": "SG",
      "title": "Region",
      "type": "string"
    },
    "town": {
      "default": "",
      "title": "Town",
      "type": "string"
    },
    "flat_type": {
      "default": "",
      "title": "Flat Type",
      "type": "string"
    },
    "postal_code": {
      "default": "",
      "title": "Postal Code",
      "type": "string"
    },
    "monthly_rent": {
      "default": 0,
      "title": "Monthly Rent",
      "type": "number"
    },
    "buyer_profile": {
      "default": "SC",
      "title": "Buyer Profile",
      "type": "string"
    },
    "property_count": {
      "default": 1,
      "title": "Property Count",
      "type": "integer"
    },
    "monthly_income": {
      "default": 0,
      "title": "Monthly Income",
      "type": "number"
    },
    "existing_monthly_debt": {
      "default": 0,
      "title": "Existing Monthly Debt",
      "type": "number"
    },
    "loan_tenure_years": {
      "default": 30,
      "title": "Loan Tenure Years",
      "type": "integer"
    },
    "borrower_age": {
      "default": 35,
      "title": "Borrower Age",
      "type": "integer"
    }
  },
  "required": [
    "property_price"
  ],
  "title": "sg_property_analyzeArguments"
}

sg_property_rank

Rank candidate Singapore properties by investment value. Accepts properties from any source, then scores value vs comps, yield, affordability, and location. Region-ready: SG live, HK/AE/AU/JP planned.

Parameters5

candidates	array	required
region	string	optional
buyer_profile	string	optional
monthly_income	number	optional
existing_monthly_debt	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "candidates": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Candidates",
      "type": "array"
    },
    "region": {
      "default": "SG",
      "title": "Region",
      "type": "string"
    },
    "buyer_profile": {
      "default": "SC",
      "title": "Buyer Profile",
      "type": "string"
    },
    "monthly_income": {
      "default": 0,
      "title": "Monthly Income",
      "type": "number"
    },
    "existing_monthly_debt": {
      "default": 0,
      "title": "Existing Monthly Debt",
      "type": "number"
    }
  },
  "required": [
    "candidates"
  ],
  "title": "sg_property_rankArguments"
}

sg_property_pitch

Generate a complete property investment pitch — the kind of one-page analysis a property agent presents to a client. Includes price fairness, stamp duty, affordability, yield, location, tenure risk, and verdict.

Parameters15

property_price	number	required
property_type	string	optional
town	string	optional
flat_type	string	optional
project_name	string	optional
postal_code	string	optional
sqft	number	optional
monthly_rent	number	optional
tenure	string	optional
top_year	integer	optional
buyer_profile	string	optional
property_count	integer	optional
monthly_income	number	optional
existing_monthly_debt	number	optional
buyer_notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "property_price": {
      "title": "Property Price",
      "type": "number"
    },
    "property_type": {
      "default": "hdb",
      "title": "Property Type",
      "type": "string"
    },
    "town": {
      "default": "",
      "title": "Town",
      "type": "string"
    },
    "flat_type": {
      "default": "",
      "title": "Flat Type",
      "type": "string"
    },
    "project_name": {
      "default": "",
      "title": "Project Name",
      "type": "string"
    },
    "postal_code": {
      "default": "",
      "title": "Postal Code",
      "type": "string"
    },
    "sqft": {
      "default": 0,
      "title": "Sqft",
      "type": "number"
    },
    "monthly_rent": {
      "default": 0,
      "title": "Monthly Rent",
      "type": "number"
    },
    "tenure": {
      "default": "",
      "title": "Tenure",
      "type": "string"
    },
    "top_year": {
      "default": 0,
      "title": "Top Year",
      "type": "integer"
    },
    "buyer_profile": {
      "default": "SC",
      "title": "Buyer Profile",
      "type": "string"
    },
    "property_count": {
      "default": 1,
      "title": "Property Count",
      "type": "integer"
    },
    "monthly_income": {
      "default": 0,
      "title": "Monthly Income",
      "type": "number"
    },
    "existing_monthly_debt": {
      "default": 0,
      "title": "Existing Monthly Debt",
      "type": "number"
    },
    "buyer_notes": {
      "default": "",
      "title": "Buyer Notes",
      "type": "string"
    }
  },
  "required": [
    "property_price"
  ],
  "title": "sg_property_pitchArguments"
}

sg_rental_yield

Calculate rental investment metrics: gross yield, net yield, cap rate, price-to-rent ratio, and monthly cashflow.

Parameters3

property_price	number	required
monthly_rent	number	required
annual_expenses	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "property_price": {
      "title": "Property Price",
      "type": "number"
    },
    "monthly_rent": {
      "title": "Monthly Rent",
      "type": "number"
    },
    "annual_expenses": {
      "default": 0,
      "title": "Annual Expenses",
      "type": "number"
    }
  },
  "required": [
    "property_price",
    "monthly_rent"
  ],
  "title": "sg_rental_yieldArguments"
}

sg_income_tax

Calculate Singapore individual income tax. Resident progressive rates (YA 2024+): 0-22% marginal. Non-residents: 15% flat or progressive, whichever higher. Free.

Parameters4

annual_income	number	required
deductions	number	optional
reliefs	number	optional
is_resident	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "annual_income": {
      "title": "Annual Income",
      "type": "number"
    },
    "deductions": {
      "default": 0,
      "title": "Deductions",
      "type": "number"
    },
    "reliefs": {
      "default": 0,
      "title": "Reliefs",
      "type": "number"
    },
    "is_resident": {
      "default": true,
      "title": "Is Resident",
      "type": "boolean"
    }
  },
  "required": [
    "annual_income"
  ],
  "title": "sg_income_taxArguments"
}

sg_gst

Add or remove Singapore GST (9% from 1 Jan 2024). mode='add': calculate GST on a GST-exclusive price. mode='remove': extract GST component from a GST-inclusive price. Free.

Parameters2

amount	number	required
mode	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "title": "Amount",
      "type": "number"
    },
    "mode": {
      "default": "add",
      "title": "Mode",
      "type": "string"
    }
  },
  "required": [
    "amount"
  ],
  "title": "sg_gstArguments"
}

sg_property_commission

Estimate Singapore property agent commission. transaction_type: 'sale' or 'rental'. property_type: 'hdb', 'private', 'landed'. Rates are market norms (CEA), not legally fixed. Free.

Parameters4

transaction_type	string	required
property_type	string	optional
price	number	optional
is_seller_landlord	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "transaction_type": {
      "title": "Transaction Type",
      "type": "string"
    },
    "property_type": {
      "default": "hdb",
      "title": "Property Type",
      "type": "string"
    },
    "price": {
      "default": 0,
      "title": "Price",
      "type": "number"
    },
    "is_seller_landlord": {
      "default": true,
      "title": "Is Seller Landlord",
      "type": "boolean"
    }
  },
  "required": [
    "transaction_type"
  ],
  "title": "sg_property_commissionArguments"
}

sg_cpf_housing

Estimate CPF Ordinary Account accumulation for housing use. Shows monthly OA contribution, 3-year and 5-year projected balances. Free.

Parameters3

monthly_income	number	required
age	integer	required
existing_oa_balance	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "monthly_income": {
      "title": "Monthly Income",
      "type": "number"
    },
    "age": {
      "title": "Age",
      "type": "integer"
    },
    "existing_oa_balance": {
      "default": 0,
      "title": "Existing Oa Balance",
      "type": "number"
    }
  },
  "required": [
    "monthly_income",
    "age"
  ],
  "title": "sg_cpf_housingArguments"
}

sg_salary_benchmark

Benchmark salary for a Singapore role using live MyCareersFuture job postings. Returns median, percentile ranges, and annual equivalents from real employer-posted salary data. Free.

Parameters2

role	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "role": {
      "title": "Role",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "role"
  ],
  "title": "sg_salary_benchmarkArguments"
}

sg_property_tax

Calculate Singapore property tax. Owner-occupier progressive 0-32%, non-owner-occupied 10-20%, non-residential flat 10%. Free.

Parameters3

annual_value	number	required
property_type	string	optional
is_owner_occupied	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "annual_value": {
      "title": "Annual Value",
      "type": "number"
    },
    "property_type": {
      "default": "residential",
      "title": "Property Type",
      "type": "string"
    },
    "is_owner_occupied": {
      "default": true,
      "title": "Is Owner Occupied",
      "type": "boolean"
    }
  },
  "required": [
    "annual_value"
  ],
  "title": "sg_property_taxArguments"
}

sg_buy_vs_rent

Buy-vs-rent analysis: total cost of buying vs renting over a holding period. Includes mortgage, stamp duty, property tax, maintenance, opportunity cost. Returns net cost comparison and recommendation. Free.

Parameters5

property_price	number	required
monthly_rent	number	required
holding_period_years	integer	optional
mortgage_rate	number	optional
down_payment_pct	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "property_price": {
      "title": "Property Price",
      "type": "number"
    },
    "monthly_rent": {
      "title": "Monthly Rent",
      "type": "number"
    },
    "holding_period_years": {
      "default": 10,
      "title": "Holding Period Years",
      "type": "integer"
    },
    "mortgage_rate": {
      "default": 2.6,
      "title": "Mortgage Rate",
      "type": "number"
    },
    "down_payment_pct": {
      "default": 25,
      "title": "Down Payment Pct",
      "type": "number"
    }
  },
  "required": [
    "property_price",
    "monthly_rent"
  ],
  "title": "sg_buy_vs_rentArguments"
}

sg_school_proximity

Find primary/secondary schools near a Singapore postal code. Splits schools within 1km and 1-2km for Primary 1 priority analysis. Free.

Parameters3

postal_code	string	required
radius_km	number	optional
school_type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "postal_code": {
      "title": "Postal Code",
      "type": "string"
    },
    "radius_km": {
      "default": 2,
      "title": "Radius Km",
      "type": "number"
    },
    "school_type": {
      "default": "",
      "title": "School Type",
      "type": "string"
    }
  },
  "required": [
    "postal_code"
  ],
  "title": "sg_school_proximityArguments"
}

hdb_eip_quota

Explain HDB Ethnic Integration Policy (EIP) and SPR quota limits. Real-time HDB quota requires portal verification, but this returns official quota rules and transaction risk. Free.

Parameters4

town	string	required
buyer_ethnicity	string	required
is_spr	boolean	optional
is_malaysian_spr	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "town": {
      "title": "Town",
      "type": "string"
    },
    "buyer_ethnicity": {
      "title": "Buyer Ethnicity",
      "type": "string"
    },
    "is_spr": {
      "default": false,
      "title": "Is Spr",
      "type": "boolean"
    },
    "is_malaysian_spr": {
      "default": false,
      "title": "Is Malaysian Spr",
      "type": "boolean"
    }
  },
  "required": [
    "town",
    "buyer_ethnicity"
  ],
  "title": "hdb_eip_quotaArguments"
}

hdb_lease_decay

Analyze HDB lease decay: remaining years, financing/CPF restrictions, risk thresholds, and value impact. Free.

Parameters2

lease_commencement_year	integer	required
current_value	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lease_commencement_year": {
      "title": "Lease Commencement Year",
      "type": "integer"
    },
    "current_value": {
      "default": 0,
      "title": "Current Value",
      "type": "number"
    }
  },
  "required": [
    "lease_commencement_year"
  ],
  "title": "hdb_lease_decayArguments"
}

ura_status

Check if URA private property data is connected and available. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "ura_statusArguments"
}

ura_transactions

Get private residential property transactions (caveat data) from URA. Returns project name, price, PSF, area, tenure, transaction date, sale type. Batch 1 is most recent. $0.05/call.

Parameters1

batch

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "batch": {
      "default": 1,
      "title": "Batch",
      "type": "integer"
    }
  },
  "title": "ura_transactionsArguments"
}

ura_rental_median

Get median rental rates ($psf/month) for private residential projects from URA. Filter by project name or get all. $0.05/call.

Parameters1

project_name

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_name": {
      "default": "",
      "title": "Project Name",
      "type": "string"
    }
  },
  "title": "ura_rental_medianArguments"
}

ura_developer_sales

Get developer units sold by project from URA. Units launched, sold, remaining, median price. Leave ref_period empty for latest, or use format like '2506' for Jun 2025. $0.05/call.

Parameters1

ref_period

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ref_period": {
      "default": "",
      "title": "Ref Period",
      "type": "string"
    }
  },
  "title": "ura_developer_salesArguments"
}

ura_pipeline

Get future private residential supply pipeline from URA. Upcoming projects, units planned, expected completion. Key for supply analysis. $0.05/call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "ura_pipelineArguments"
}

hdb_resale_median

Get HDB resale median prices by flat type for a Singapore town. Returns median price, count, min, max for each flat type.

Parameters1

town

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "town": {
      "title": "Town",
      "type": "string"
    }
  },
  "required": [
    "town"
  ],
  "title": "hdb_resale_medianArguments"
}

hdb_resale_search

Search HDB resale transactions with filters. Leave params empty for broad results.

Parameters5

town	string	optional
flat_type	string	optional
min_price	number	optional
max_price	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "town": {
      "default": "",
      "title": "Town",
      "type": "string"
    },
    "flat_type": {
      "default": "",
      "title": "Flat Type",
      "type": "string"
    },
    "min_price": {
      "default": 0,
      "title": "Min Price",
      "type": "number"
    },
    "max_price": {
      "default": 0,
      "title": "Max Price",
      "type": "number"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "hdb_resale_searchArguments"
}

mcp-server/README.md3 KBView on GitHub

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)

Create a burner wallet on Base with $2-5 of USDC
Export the private key
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:

Server returns 402 Payment Required with payment instructions
MCP server reads the price and checks against MAX_SPEND_USD
If within limit, it signs a USDC transfer on Base and retries
Server verifies payment via facilitator and returns data
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

Variable	Default	Description
`EVM_PRIVATE_KEY`	(none)	Base wallet private key for automatic payments
`MAX_SPEND_USD`	`1.00`	Max USDC to spend per single request
`BOUNTY_API_URL`	`https://bountyapi.com`	API 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 install
npm run build
node dist/index.js

License

MIT

Install

Tools (27)

sg_stamp_dutysg_postal_lookupsg_address_intelsg_mrt_nearsg_mrt_searchsg_affordabilitysg_property_analyzesg_property_rank

Configuration

Environment variables

EVM_PRIVATE_KEYsecret

Optional. EVM private key to enable auto-pay for paid endpoints via x402. Without it, only the 8 free endpoints are callable; paid endpoints return a 402 payment challenge. Never required to use the free tier.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bounty-api": {
      "command": "npx",
      "args": [
        "-y",
        "bountyapi-mcp@1.8.0"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>"
      }
    }
  }
}