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 Phone Numbers (ringcentral_list-phone-numbers)

List phone numbers assigned to the RingCentral account, both company-level and extension-level. Read-only.

Tool Input

pageinteger— Which results page to fetch (1-indexed). Spec default 1, documented range 1-1000; omit for the first page.
usageTypestring— Only return phone numbers with this usage type.(enum: "MainCompanyNumber", "AdditionalCompanyNumber", "CompanyNumber", "DirectNumber", "CompanyFaxNumber", "ForwardedNumber", "ForwardedCompanyNumber", "ContactCenterNumber", "ConferencingNumber", "MeetingsNumber", "BusinessMobileNumber", "PartnerBusinessMobileNumber", "IntegrationNumber")

Tool Output

uristring— Link to this list of account phone numbers.
recordsarray— The account's phone numbers, company- and extension-level.
[]object
uristring— Link to the company phone number resource.
idinteger— Internal identifier of the phone number.
countryobject— Country the phone number belongs to.
3 fields
idstring— Internal identifier of the country.
uristring— Canonical URI of the country resource.
namestring— The official name of the country.
extensionobject— The extension this phone number is assigned to, if any.
5 fields
idinteger— Internal identifier of the extension.
uristring— Canonical URI of the extension resource.
namestring— Extension name.
extensionNumberstring— Extension short number.
partnerIdstring— Partner-assigned identifier of the extension.
labelstring— Custom user-defined name of the phone number, if any.
locationstring— Location (city, state); filled for local US numbers only.
paymentTypestring— How the number's usage is billed.
phoneNumberstring— The phone number.
statusstring— Status of the phone number.(enum: "Normal", "Pending", "PortedIn", "Temporary")
typestring— Phone number type.(enum: "VoiceFax", "FaxOnly", "VoiceOnly")
usageTypestring— Usage type of the phone number.
temporaryNumberobject— Temporary phone number, present only while porting is pending.
2 fields
idstring— Temporary phone number identifier.
phoneNumberstring— Temporary phone number, E.164 format.
contactCenterProviderobject— Contact center routing provider for this number, if applicable.
2 fields
idstring— Internal identifier of the contact center provider.
namestring— Contact center provider's name.
vanityPatternstring— Vanity pattern for this number; returned only when a vanity search was requested.
primaryboolean— Whether this is the account's primary/main phone number.
callerIdNamestring— Caller ID name (CNAM) shown for this number. Live-observed on nonprod; not declared by the vendored spec's CompanyPhoneNumberInfo component.
navigationobject— Links to other pages of this result set.
firstPageobject— Link to the first page of results.
uristring— Canonical URI to retrieve this page of the result set.
nextPageobject— Link to the next page of results.
uristring— Canonical URI to retrieve this page of the result set.
previousPageobject— Link to the previous page of results.
uristring— Canonical URI to retrieve this page of the result set.
lastPageobject— Link to the last page of results.
uristring— Canonical URI to retrieve this page of the result set.
pagingobject— Pagination metadata for `records`.
perPageintegerrequired— Page size — how many items are in each page.
pageinteger— Current page number (1-indexed). Omitted if the result is empty.
pageStartinteger— Zero-based index of the first element on the current page. Omitted if empty.
pageEndinteger— Zero-based index of the last element on the current page. Omitted if empty.
totalPagesinteger— Total number of pages in the dataset. May be omitted for some resources for performance.
totalElementsinteger— Total number of elements in the dataset. May be omitted for some resources for performance.

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 Phone Numbers tool do?

This page documents the List Phone Numbers tool (ringcentral_list-phone-numbers). List phone numbers assigned to the RingCentral account, both company-level and extension-level. Read-only. It is one of the RingCentral Diagnostics 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.