Summary

Ruby's MCP connector lets Claude, ChatGPT and other AI assistants work inside your Ruby workspace. It offers 17 tools: 13 read your CRM and 4 make changes. The assistant acts as you and sees only what your Ruby account already sees.


Quick Reference

Server URL: https://mcp-server.rubycrm.ai/mcp

Tool Area Type What it does
get_my_context Orientation Read Who you are connected as, your workspace, timezone, currency, and what the connection can and cannot do
list_team_members Orientation Read Colleagues' names, roles and teams (no contact details)
list_property_types Orientation Read Property types such as apartment, villa, office
search_locations Orientation Read Dubai areas and communities by name
search_leads Leads Read Find leads by status, budget, area, follow-ups, WhatsApp activity and more
get_lead Leads Read One lead's full record, requirements and AI summary
update_lead Leads Write Change a lead's status or recorded requirements
add_lead_note Leads Write Add a note to a lead
get_suggested_properties Leads Read Listings that match a lead's brief
list_follow_ups Follow-ups Read Your follow-ups: today, overdue, by lead
create_follow_up Follow-ups Write Book the next call, meeting or viewing
complete_follow_up Follow-ups Write Mark a follow-up done and record the outcome
search_listings Listings Read Search your inventory by price, beds, type, portal status and more
get_listing Listings Read One listing's full details
list_whatsapp_conversations WhatsApp Read Who is waiting on a reply
get_whatsapp_conversation WhatsApp Read The message history with one lead
get_whatsapp_send_link WhatsApp Read A wa.me link with a drafted message, for you to send

Usage Guide

Connecting

  1. In Claude (claude.ai or Claude Desktop), open Settings → Connectors → Add custom connector. In ChatGPT, use Settings → Connectors → Create. Other MCP clients that support remote servers with OAuth work the same way.
  2. Paste https://mcp-server.rubycrm.ai/mcp as the URL. No API key is needed.
  3. Your client opens Ruby's consent screen. Sign in with your normal Ruby account (including 2FA or OTP if you use it).
  4. Review what the connection can and cannot do, then click Connect.

Each connection belongs to one person and acts as them. If you connect Ruby in both Claude and ChatGPT, those are two separate connections you can revoke separately. Access stays signed in for up to 90 days of inactivity; after that, your client asks you to approve again.

Ground rules