Skip to content

RingEX Phone

Endpointhttps://mcp.labs.ringcentral.com/ringex/phone
StatusPreview
TransportSSE over HTTPS
AuthOAuth2

About

RingEX Phone gives your AI assistant access to telephony data: call activity and AI-generated call insights, messages (SMS, voicemail, and fax) from the message store, directory/contact lookup, and the user's own phone profile. It's one of three servers that replace the original monolithic RingCentral MCP server — this one covers the phone and messaging side.

See the Changelog for what's changed across versions.

Connecting

ChatGPT users: the fastest way to get started is the official RingCentral Phone plugin — install it and authorize with RingCentral, no manual server setup needed.

See the RingEX Phone Setup guide for step-by-step instructions for Claude, ChatGPT, and Codex (including how to side-load the server manually if you can't use the plugin).

For other MCP clients (Cursor, etc.), add this server the same way you'd add any remote MCP server, using the endpoint above.

Available tools

12 tools are available on this server — down from 24 prior to v1.1.0. All tools operate on the authenticated user's own data; see the Tools reference for full parameter details.

Tool Access Description
about_ringcentral_mcp_tools Read List all available tools and permissions for this server
get_my_phone Read Get my extension number, phone numbers, presence, business hours, and call-handling rules
resolve_directory_person Read Resolve a person in the company directory by name, department, or job title
search_my_contacts Read Search my personal address book by name or phone number
get_my_call_activity Read Get my call activity for a date range — recent/missed/returned calls, talk time, callbacks
get_my_call_insight Read Get AI notes and transcript text for one of my calls
get_my_call_recording_metadata Read Check whether one of my calls has recording metadata
search_my_call_insights Read Search my calls by person, topic, and date window
get_my_communication_inbox Read Get my SMS, voicemail, and fax records for a date window
get_my_message_detail Read Read one SMS, voicemail, or fax record
get_my_sms_thread Read Get a bounded window of one SMS conversation
send_sms Write Send one SMS from a number I own

Company directory management moved

platform_list_directory_entries, platform_read_directory_entry, and search_directory_entries are replaced by resolve_directory_person, which is read-only lookup/resolution scoped to finding a person to call or text — not directory administration. team_messaging_get_person is no longer exposed here; use RingEX Chat's find_person for Team Chat person resolution.

Getting started

  1. Connect — Add the server URL above to your AI client.
  2. Verify — Ask your assistant to show your recent call log to confirm the connection is active.
  3. Use — Ask your AI assistant to look up calls, voicemails, SMS, or AI-generated call notes.

Deprecated tools

Some tools on this server may return deprecation warnings in their responses. These tools are still available during a transition period but will be fully removed in a future update. Tools marked with a deprecation_warning field in their schema should be migrated away from to avoid service disruption.

Tools removed in v1.1.0

The following tools are no longer available and will return tool_not_found errors:

  • platform_list_directory_entries → use resolve_directory_person
  • platform_read_directory_entry → use resolve_directory_person
  • search_directory_entries → use resolve_directory_person
  • platform_list_extension_phone_numbers → phone numbers now in get_my_phone
  • platform_read_user_presence_status → presence now in get_my_phone and resolve_directory_person
  • platform_read_account_info → use about_ringcentral_mcp_tools
  • read_extension_profile → profile info now in get_my_phone
  • list_user_call_log → use get_my_call_activity
  • platform_read_user_call_record → use get_my_call_insight
  • list_message_store_records → use get_my_communication_inbox
  • read_message_store_record → use get_my_message_detail
  • read_message_store_content → merged into get_my_message_detail
  • team_messaging_get_person → use RingEX Chat's find_person
  • All platform_call_* and platform_list_* dispatch tools — replaced by dedicated, purpose-named tools

Why: The old tools required managing account, extension, and pagination selectors. The new surface is scoped to the authenticated user only, making them simpler and more secure.

Tool discovery

curl https://mcp.labs.ringcentral.com/ringex/phone \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'