View as .md ↗
RingCentral

RingCentral

MCP server · Communications · ringcentral.com · 5 categories · 17 tools

RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level.

List Extension Phone Numbers (ringcentral_list-extension-phone-numbers)

List phone numbers used by a particular RingCentral extension: directly-mapped numbers plus company-level numbers usable on the extension's behalf.

Tool Input

idstringrequired— Internal identifier of the extension to list phone numbers for (or '~' for the currently authorized extension).(min length: 1)

Tool Output

uristring— Link to the user phone number list resource.
recordsarrayrequired— Phone numbers used by the extension.
[]object
uristring— Link to the user phone number resource.
idinteger— Internal identifier of the phone number.
countryobject— The phone number's country.
3 fields
idstring— Internal identifier of the country.
uristring— Canonical URI of the country resource.
namestring— Official name of the country.
contactCenterProviderobject— CCRN provider, when applicable.
2 fields
idstring— Internal identifier of the CCRN provider.
namestring— Name of the CCRN provider.
extensionobject— The extension this phone number is assigned to.
7 fields
idinteger— Internal identifier of the extension.
uristring— Canonical URI of the extension.
extensionNumberstring— Extension short number.
partnerIdstring— Partner-assigned identifier of the extension.
typestring— Extension type (open string — same extension-type taxonomy as list/get-extension; read-widened defensively).
contactCenterProviderobject— CCRN provider, when applicable.
2 fields
idstring— Internal identifier of the CCRN provider.
namestring— Name of the CCRN provider.
namestring— Extension name.
labelstring— Custom user-assigned name of the phone number, if any.
locationstring— Location (city, state); filled for local US numbers.
paymentTypestring— Payment type of the phone number.
phoneNumberstring— The phone number.
primaryboolean— Whether this is the primary number (displayed as 'main number', called by default).
statusstring— Status of the phone number. 'Normal' means ready to use; otherwise an external number not yet ported to RingCentral.(enum: "Normal", "Pending", "PortedIn", "Temporary")
typestring— Phone number type.(enum: "VoiceFax", "FaxOnly", "VoiceOnly")
subTypestring— Extension subtype, if applicable.(enum: "Unknown", "VideoPro", "VideoProPlus", "DigitalSignage", "Emergency")
usageTypestring— Usage type of the phone number (open string; RC may extend this usage-type taxonomy; 'NumberPool' is never returned by this endpoint).
featuresarray— Features enabled on this phone number.
1 field
[]string
callerIdNamestring— Caller ID name shown for this phone number (live-observed, undocumented field).
navigationobjectrequired— Links to other pages of the result set.
firstPageobject— Link to the first page.
uristring— Canonical URI to retrieve this particular page.
nextPageobject— Link to the next page.
uristring— Canonical URI to retrieve this particular page.
previousPageobject— Link to the previous page.
uristring— Canonical URI to retrieve this particular page.
lastPageobject— Link to the last page.
uristring— Canonical URI to retrieve this particular page.
pagingobjectrequired— Pagination metadata for `records`.
perPageintegerrequired— Page size — how many items are in each page.
pageinteger— 1-based current page number; omitted if the result is empty.
pageStartinteger— 0-based index of the first element on the current page.
pageEndinteger— 0-based index of the last element on the current page.
totalPagesinteger— Total number of pages in the dataset (may be omitted for performance reasons).
totalElementsinteger— Total number of elements in the dataset (may be omitted for performance reasons).

We're Adding More RingCentral Tools Constantly!

Don't see a specific RingCentral tool you need? Email [email protected] and we can add it.

RingCentral Frequently Asked Questions

What does the List Extension Phone Numbers tool do?

This page documents the List Extension Phone Numbers tool (ringcentral_list-extension-phone-numbers). List phone numbers used by a particular RingCentral extension: directly-mapped numbers plus company-level numbers usable on the extension's behalf. It is one of the RingCentral Identity tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

What is the RingCentral integration?

The RingCentral integration connects your firm's RingCentral account to Weave. RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level. It groups 17 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.