@borough/mcp

MCP server for the Borough NYC Real Estate API. Query NYC rental and sales listings, property details, building data, and neighborhood market statistics via AI agents.

Quick Start

Remote (recommended)

Connect directly to the hosted MCP endpoint — no installation needed:

https://borough.qwady.app/mcp

Pass your API key via the Authorization header: Bearer BOROUGH-<your_key>

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "borough": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://borough.qwady.app/mcp",
        "--header", "Authorization:Bearer BOROUGH-<your_key>"
      ]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "borough": {
      "url": "https://borough.qwady.app/mcp",
      "headers": {
        "Authorization": "Bearer BOROUGH-<your_key>"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "borough": {
      "type": "http",
      "url": "https://borough.qwady.app/mcp",
      "headers": {
        "Authorization": "Bearer BOROUGH-<your_key>"
      }
    }
  }
}

ChatGPT

Use the remote URL directly: https://borough.qwady.app/mcp

Via npx (stdio bridge)

BOROUGH_API_KEY=BOROUGH-<your_key> npx @borough/mcp

Available Tools

Free Tier

| Tool | Description | |------|-------------| | search_rentals | Search active rental listings across all five NYC boroughs | | search_sales | Search active for-sale listings across all five NYC boroughs | | list_areas | List all 349 NYC neighborhoods and areas with their IDs |

Starter ($19/mo)

| Tool | Description | |------|-------------| | get_property | Get full details for a specific listing by ID (50+ fields) | | get_property_by_url | Look up a listing by its URL path | | get_building | Get detailed building information (amenities, policies, scores) | | get_building_listings | Get all listings within a specific building |

Pro ($49/mo)

| Tool | Description | |------|-------------| | get_market_snapshot | Current market stats for a neighborhood (inventory, median rent) | | get_market_trends | Historical price trends for a neighborhood (up to 365 days) | | compare_neighborhoods | Side-by-side comparison of 1-5 neighborhoods |

Example Queries

Ask your AI agent:

• "Find me 2-bedroom apartments in Williamsburg under $4,000/month"
• "Show me no-fee rentals in Manhattan with a doorman"
• "What's the median rent for a 1-bedroom in the East Village?"
• "Compare rents between Park Slope, Williamsburg, and Astoria"
• "Get details on property 4961849"
• "What buildings have the most listings in the Upper West Side?"

Get an API Key

Get a free API key (100 requests/month) at borough.qwady.app/pricing

Documentation

Full API docs: docs.qwady.app