MCP troubleshooting: authorization, connection limits, and the wrong workspace

D

Diego Alejos

Last updated on Oct 12, 2026

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

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