Add Borough to Claude

What You Need

A Borough account if you want paid tools
Optional: a Borough API key for Starter, Pro, Business, or Internal access
Claude web or Claude Desktop

Connector URL

Use this remote MCP server URL:

https://borough.qwady.app/mcp

Claude discovers Borough’s OAuth metadata automatically from:

https://borough.qwady.app/.well-known/mcp/server.json

Add Borough In Claude

Pro, Max, or Free individual plans

Open Settings → Connectors
In the Connectors section, click Add custom connector
Paste:
```
https://borough.qwady.app/mcp
```
Click Add
Claude will open Borough’s OAuth flow
On the Borough consent screen:
- enter a Borough API key to unlock your paid tier, or
- continue without a key to use the free MCP tool set
Finish authorization
In chat, open Search and tools and enable Borough

Team and Enterprise plans

Owners add the connector first:

Open Organization settings → Connectors
Click Add custom connector
Paste:
```
https://borough.qwady.app/mcp
```
Save the connector

Then individual users:

Open Settings → Connectors
Find Borough
Click Connect
Complete the Borough OAuth flow
Enable Borough from Search and tools in chat

What Auth Does In Borough

Borough’s MCP server is tier-aware.

If you authorize with no Borough API key, Claude gets the free tool set:
- search_rentals
- search_sales
- list_areas
- market tools
If you authorize with a paid Borough API key, Borough maps your tier and exposes the matching tools
Property and building detail tools are only exposed for non-free Borough tiers

This means Claude only sees the tools your Borough configuration is allowed to use.

Troubleshooting

The icon does not update

Claude may cache connector icons. If Borough’s icon looks stale:

Remove the connector from Settings → Connectors
Add it again with:
```
https://borough.qwady.app/mcp
```
Reconnect auth

Anthropic’s current directory FAQ also notes that connector icons may come from the connector’s favicon or a provided icon URL, so updates can lag if the client or icon source is cached.

Borough shows too many results in chat

Borough’s MCP tools now use smaller MCP-facing defaults than the REST API. If a conversation still gets too large:

ask for a smaller page
use narrower area filters
prefer exact area IDs instead of borough-level IDs when possible

Example:

Search rentals in area IDs 410 and 488, max 10 results, under $4,500

Claude says Borough has no tools

Check:

The connector URL is exactly https://borough.qwady.app/mcp
The auth flow completed successfully
Borough is enabled from Search and tools
Your current Borough tier actually includes the tool you are asking for

Example Prompts

“Search rentals in Williamsburg and Greenpoint under $4,500”
“List neighborhoods in Queens”
“Compare market snapshot data for Astoria and Long Island City”
“Get details for property 4961849”