# List Blocked Numbers

`ringcentral_list-blocked-numbers` · RingCentral MCP tool · Diagnostics

List the blocked and allowed phone numbers configured for a RingCentral extension. Read-only.

## RingCentral Frequently Asked Questions

**What does the List Blocked Numbers tool do?**

This page documents the List Blocked Numbers tool (`ringcentral_list-blocked-numbers`). List the blocked and allowed phone numbers configured for a RingCentral extension. 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.

## Input

- **extensionId** `string` (required, min length: 1) — Internal identifier of the extension whose blocked/allowed numbers to list; pass '~' for the extension associated with the current authorization session.
- **status** `string` (enum: "Blocked", "Allowed") — Only return numbers with this status (Blocked or Allowed).

## Output

- **uri** `string` — Link to this list of blocked/allowed phone numbers.
- **records** `array` — The blocked/allowed phone numbers for this extension.
  - **[]** `object`
    - **uri** `string` — Link to the blocked/allowed phone number resource.
    - **id** `string` — Internal identifier of the blocked/allowed phone number.
    - **phoneNumber** `string` — The blocked/allowed phone number, E.164 format.
    - **label** `string` — Custom name of the blocked/allowed phone number.
    - **status** `string` (enum: "Blocked", "Allowed") — Whether this number is blocked or allowed.
- **navigation** `object` — Links to other pages of this result set.
  - **firstPage** `object` — Link to the first page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **nextPage** `object` — Link to the next page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **previousPage** `object` — Link to the previous page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **lastPage** `object` — Link to the last page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
- **paging** `object` — Pagination metadata for `records`.
  - **perPage** `integer` (required) — Page size — how many items are in each page.
  - **page** `integer` — Current page number (1-indexed). Omitted if the result is empty.
  - **pageStart** `integer` — Zero-based index of the first element on the current page. Omitted if empty.
  - **pageEnd** `integer` — Zero-based index of the last element on the current page. Omitted if empty.
  - **totalPages** `integer` — Total number of pages in the dataset. May be omitted for some resources for performance.
  - **totalElements** `integer` — Total number of elements in the dataset. May be omitted for some resources for performance.