35 MCP tools give Claude Desktop, Cursor, and other MCP clients direct access to HCMC listings, state land-price references, data-trust reports, planning signals, risk checks, and scoped listing chat.
Model Context Protocol (MCP) is an open standard that lets AI assistants connect directly to external data sources. With bds.chat's MCP server, Claude can search listings, compare prices against NQ 87/2025 state land-price references, check planning/zoning signals, and review risk indicators — grounded in structured data with cited sources.
1Install the bds-mcp binary from the bds-chat releases.
2Add to your Claude Desktop MCP configuration:
{
"mcpServers": {
"bds-chat": {
"command": "bds-mcp",
"args": ["--api-url", "https://api.bds.chat"],
"env": {
"BDS_API_KEY": "your-api-key-here"
}
}
}
}For Claude Code, Cursor, and MCP clients that support remote servers:
{
"mcpServers": {
"bds-chat": {
"url": "https://api.bds.chat/mcp",
"headers": {
"Authorization": "Bearer your-api-key-here"
}
}
}
}35 tools across 7 categories. Read-only tools are available on all tiers. Management tools require pro or partner tier.
| Tool | Description |
|---|---|
search_listings | Search HCMC listings with filters for price, area, district, legal-document status, road access, and property type |
get_listing_detail | Full listing details: price, area, location, legal-document status, and images |
get_trust_report | Data-trust report: data coverage, risk signals, and trust grade (A–F) |
get_spatial_context | Spatial context: zoning data, administrative boundaries, and nearby features |
chat_about_listing | Ask a scoped question about a listing, grounded in structured data and cited sources |
| Tool | Description |
|---|---|
get_gov_land_price | State land-price reference for a street (NQ 87/2025 benchmark, not market valuation) |
get_gov_land_price_ward | Ward-level state land-price summary |
get_gov_land_price_district | District-level state land-price summary |
compare_gov_land_price | Compare asking price against state land-price reference — ratio and context |
check_location_risk | Location risk signals: planning conflicts, road setbacks, and data flags |
get_zoning | Planning/zoning data from available source layers |
get_zoning_report | Detailed planning report with overlays and road setback data |
check_listing_zoning | Check planning/zoning signals for a specific listing |
resolve_ward | Resolve ward reform status (HCMC 312→102 wards, effective 01/07/2025 per NQ 1685) |
search_reform_knowledge | Search ward reform knowledge base |
get_legal_refs | Legal references for land price, zoning, and construction regulations |
get_boundaries | Administrative boundary polygons for HCMC districts and wards |
get_boundary_contains | Find which district/ward contains a coordinate |
| Tool | Description |
|---|---|
create_listing | Create a new listing with property details |
update_listing | Update an existing listing |
delete_listing | Delete a listing |
update_listing_status | Change listing status (active, sold, expired, withdrawn) |
batch_upsert_listings | Batch upsert multiple listings (partner tier only) |
| Tool | Description |
|---|---|
submit_document | Submit legal documents for a listing |
get_listing_documents | Get documents associated with a listing |
upload_document_image | Upload document images (land title scans, permits) |
| Tool | Description |
|---|---|
register_api_key | Register for an API key |
get_profile | View your API key profile, tier, and limits |
update_profile | Update profile information |
get_usage | Check API usage statistics |
rotate_key | Rotate your API key |
| Tool | Description |
|---|---|
get_platform_stats | Live platform statistics: listings, districts, data quality |
submit_partner_interest | Express interest in becoming a platform partner |
get_data_quality | Data quality metrics: coverage, freshness, trust grade distribution |
| Tool | Description |
|---|---|
upload_image | Upload a listing photo (returns encrypted image token) |
Register for an API key through the API or use the register_api_key MCP tool directly. Include your key in the MCP configuration — the server handles authentication automatically.
bds.chat is a data intelligence API, not a brokerage or legal advisor. State land-price records are cited reference data, not market valuations. Verify legal status, ownership, planning, and price with the seller and competent authority.