Troubleshooting
Connection Issues
Section titled “Connection Issues”Tools not appearing in my AI client
Section titled “Tools not appearing in my AI client”- Restart your client after making configuration changes
- Check the endpoint is reachable:
Terminal window curl -X POST https://borough.qwady.app/mcp \-H "Content-Type: application/json" \-d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}' - Verify your config file syntax (JSON must be valid)
- Check mcp-remote is installed:
npx mcp-remote --version
”Authentication failed” error
Section titled “”Authentication failed” error”- If you are using Claude or another OAuth-capable client, reconnect Borough and complete the Borough auth flow again
- If you are using direct bearer auth, verify your API key starts with
BOROUGH- - Check the key is active in the customer portal
- Ensure the
Authorizationheader format is exactlyBearer BOROUGH-<key>
Free-tier MCP sessions can still authenticate through OAuth even if you do not attach a paid Borough API key.
”Rate limit exceeded” error
Section titled “”Rate limit exceeded” error”Your plan’s per-minute rate limit has been reached. Each MCP tool call consumes one API request.
| Plan | Rate Limit |
|---|---|
| Free | 10/min |
| Starter | 30/min |
| Pro | 60/min |
| Business | 120/min |
Wait 60 seconds before retrying.
”Quota exceeded” error
Section titled “”Quota exceeded” error”Your monthly request quota has been exhausted.
| Plan | Monthly Quota |
|---|---|
| Free | 100 |
| Starter | 5,000 |
| Pro | 25,000 |
| Business | 100,000 |
Upgrade your plan for more requests.
Tool-Specific Issues
Section titled “Tool-Specific Issues””Requires Starter plan” when calling get_property
Section titled “”Requires Starter plan” when calling get_property”Property detail, building, and building listing tools require a Starter plan ($19/mo) or higher. Free-tier users can use search_rentals, search_sales, and list_areas.
”Requires Starter plan” for building or property tools
Section titled “”Requires Starter plan” for building or property tools”Property and building detail tools require a Starter plan ($19/mo) or higher. Market tools are available to authenticated free-tier MCP users.
Empty search results
Section titled “Empty search results”- Try broader filters (remove price or bedroom constraints)
- Try an exact borough or neighborhood name directly, or lock the area ID first with
list_areas - Borough IDs: Manhattan=100, Bronx=200, Brooklyn=300, Queens=400, Staten Island=500
Location name resolves to multiple areas
Section titled “Location name resolves to multiple areas”If Borough returns a short clarification list, choose one of the suggested IDs or provide a more specific location name. This usually happens with names that exist at multiple levels or in multiple contexts. Borough does not silently auto-pick in these cases because the MCP tools are optimized for certainty first.
Photos do not render in my client
Section titled “Photos do not render in my client”- Borough search results return
leadPhotoUrlandrenderHints.imageUrl, but this version does not send inline MCP image blocks - Some clients render the proxied image URLs automatically; others may only use the text and map fields
- The most render-friendly fields to look for are
price,displayPrice,geoPoint,leadPhotoUrl, andrenderHints
Amenity search returns few results
Section titled “Amenity search returns few results”Amenities such as DISHWASHER and WASHER_DRYER are supported, but Borough may need to refine a small candidate set using listing detail before returning final matches. If your search is very narrow, try:
- widening the budget
- expanding to nearby neighborhoods
- reducing the required amenity set to one must-have amenity first