Skip to main content

​
Prerequisites

  1. An MCP-compatible AI client
  2. Optional: a Borough API key from a paid plan if you want paid-tier tools. Clients that support MCP OAuth (such as Claude) can use the free tools (search, areas, and market data) without one: choose Continue without key on the consent screen. Keyless free usage is counted per connecting IP address, so with a hosted client it may be shared with other users; see MCP Server
If you are connecting from Claude or Claude Desktop, use the dedicated guide: Most MCP clients support connecting to remote servers directly. Use the Borough MCP endpoint:
For clients without OAuth support, pass your Borough API key via the Authorization header. This needs a key from a paid plan; the keyless free tier is only available through the OAuth consent flow.

​
Client Setup

Borough supports an OAuth-based connector flow for Claude custom connectors.
  1. In Claude, go to Settings → Connectors
  2. Click Add custom connector
  3. Enter the URL: https://borough.qwady.app/mcp
  4. Claude auto-discovers the OAuth flow and opens the consent page
  5. Enter your Borough API key to enable paid tools, or continue without a key for the free Borough MCP tool set
  6. Click Authorize
Claude can now query NYC real estate data directly.
See Add Borough to Claude for the exact current flow, including free-plan and team/org setup.

​
ChatGPT (GPT Actions)

ChatGPT does not support MCP natively. Instead, you can create a custom GPT with an Action that calls the Borough REST API directly using the Borough OpenAPI spec:
  1. Go to ChatGPT GPT Builder
  2. Under Actions, click Create new action
  3. Import the OpenAPI spec from the URL above (or paste the YAML)
  4. Under Authentication, select API Key with header Authorization and prefix Bearer
  5. Enter your Borough API key (from a paid plan) as the value

​
Test It

Once connected, try asking your AI agent:
  • “Search for no-fee 1-bedroom apartments in Manhattan under $3,500”
  • “List all Brooklyn neighborhoods”
  • “What’s the median rent in the East Village?”
The agent will automatically select the right Borough tools and return formatted results.

​
Troubleshooting

If tools aren’t showing up:
  1. If you connected with an API key, verify your subscription is active in the customer portal
  2. Check that the MCP endpoint is reachable: curl https://borough.qwady.app/mcp (a 401 response is expected and confirms it’s up; the endpoint requires authentication)
  3. Restart your AI client after configuration changes
  4. See the troubleshooting guide for more help