If your AI client (Cursor, Claude, ChatGPT, or another MCP client) can't reach RealtyPad, find your symptom below.

The MCP URL is always:

`https://app.realtypad.ai/mcp`

## The browser never opens, or authorization fails

* Remove the RealtyPad server from your client and add it again, then connect. This clears stored OAuth state.

* When the browser opens **Authorize agent access**, sign in if asked and click **Authorize**. Clicking **Deny** stops the connection.

* In Cursor, fully quit the app (Cmd+Q on macOS) and reconnect, or click **Needs authentication** again.

* If you see "Protected resource … does not match expected", remove and re-add the server using the URL above exactly.

## "Agent Connection limit reached"

Each MCP client you authorize, and each agent token you mint, counts as one **Agent Connection**. Your plan includes a set number of them.

To free one up, a workspace owner or admin opens **Account → Billing**, finds the connection under **Seats, agents & automation**, and clicks **Remove**. Or click **Upgrade plan** to get more.

## "This Agent Connection is missing, revoked, or exceeds the workspace plan limit"

The connection was removed, or the workspace is over its limit. Reconnect with OAuth (re-add the server), or mint a new token at **Agent & API** → **Mint agent token** and replace the old one in your client config.

## My agent sees the wrong deals, or no deals

Connections are tied to one workspace.

* With OAuth, pick the right workspace under **Workspace for this agent** on the **Authorize agent access** page (shown when you belong to more than one).

* With an agent token, switch to the right workspace in the app first, then mint a new token.

## Connection refused or TLS errors

RealtyPad only accepts HTTPS. Check your network, VPN, or proxy.

Use the MCP URL exactly as shown: `https://app.realtypad.ai/mcp`.

## Still stuck?

Full setup guide: [docs.realtypad.ai](https://docs.realtypad.ai)

When contacting support, send: your workspace name, which AI client you use, and the exact error message.
