RingEX Admin¶

Endpointhttps://mcp.labs.ringcentral.com/ringex/admin

StatusExperimental

TransportSSE over HTTPS

AuthOAuth2

About¶

Experimental

This server is experimental. Its endpoint, tool names, and input schemas may change, and the server may be withdrawn, without the notice periods described in the deprecation policy.

RingEX Admin gives your AI assistant the ability to administer a RingEX account: users and extensions, roles and permissions, sites, phone numbers, call queues, IVR menus and prompts, call routing and business hours, emergency call redirect, and the admin audit log. It joins RingEX Phone, RingEX Chat, and RingEX Meetings in the RingEX family, which replaced the original monolithic RingCentral MCP server — this one covers account- and admin-level tools.

Most tools are action-based: they take an action argument that selects a strict argument variant. Read tools return configuration; write tools change it.

Write tools require a two-step confirmation

Tools that change configuration return status: "confirmation_required" with a plan and a single-use confirmationToken on the first call, without changing anything. The assistant must show you the plan and only repeat the call — identical arguments plus the token — after you approve. Tokens expire after about five minutes.

Connecting¶

See the RingEX Admin Setup guide for step-by-step instructions for Claude, ChatGPT, and Codex.

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¶

31 tools are available on this server, grouped by the area of the account they administer. See the Tools reference for the full action and parameter breakdown per tool.

Account

Tool	Access	Description
`get_admin_setup_status`	Read	First-run checklist for a new account — site, main number, users, business hours, inbound routing
`search_admin_audit_log`	Read	Search the account's admin change history by actor, date range, and category

Users and roles

Tool	Access	Description
`read_users`	Read	List, search, or get users and extensions, and read a user's role and group assignments
`manage_users`	Write	Create, bulk-create, template-provision, or update users
`disable_user`	Destructive	Disable a user extension, recording the reason
`bulk_move_users`	Write	Preview, execute, or check the status of a bulk move of users between sites
`read_roles`	Read	List roles and permissions, get a role, or list assignable roles
`manage_roles`	Write	Create or update a role, assign it to users, or set the account default
`delete_role`	Destructive	Delete a custom role, reassigning or clearing its holders

Sites and phone numbers

Tool	Access	Description
`read_sites`	Read	List or get sites, list members, read a site IVR, or recommend an extension prefix
`manage_sites`	Write	Create or update a site, assign members or an admin, or set the site IVR
`delete_site`	Destructive	Delete a site
`read_phone_numbers`	Read	List or get account phone numbers by usage type and status
`assign_phone_number`	Write	Assign a number to an extension or as a company number, or replace an assignment
`release_phone_number`	Destructive	Release an unassigned number back to RingCentral

Company calls and recording

Tool	Access	Description
`read_company_call_log`	Read	List, get, or sync the company's call history
`read_company_active_calls`	Read	Snapshot of the calls in progress across the company right now
`read_company_call_analytics`	Read	Aggregate or timeline call counts, durations, and queue service levels
`read_company_call_recordings`	Read	Get a recording's metadata or download its audio
`read_call_recording_settings`	Read	Read recording settings, auto-recorded extensions, and recording greetings

Call queues

Tool	Access	Description
`read_call_queues`	Read	List or get call queues, members, overflow settings, and agent presence
`manage_call_queues`	Write	Create or update a queue, set its members, overflow, or agent presence
`delete_call_queue`	Destructive	Delete a call queue

IVR and call routing

Tool	Access	Description
`read_call_routing`	Read	Read IVR menus, business hours, company and extension rules, forward-all, or routing for a number
`manage_routing_rules`	Write	Create or update company, interaction, and state routing rules, and set business hours
`delete_routing_rule`	Destructive	Delete a company or extension routing rule
`manage_ivr`	Write	Create or update an IVR menu, add a destination, or attach a prompt
`read_ivr_media`	Read	List or get IVR greeting prompts
`manage_ivr_media`	Write	Upload, replace, or rename an IVR prompt
`delete_ivr_prompt`	Destructive	Delete an IVR prompt
`set_emergency_call_redirect`	Write	Enable or disable the account-wide emergency call redirect

Getting started¶

Connect — Add the server URL above to your AI client.
Verify — Run read_users with action: "list" to confirm your RingCentral identity resolves and that you hold the admin permissions these tools require. On a brand-new account, run get_admin_setup_status for a first-run checklist of what still needs configuring.
Use — Ask your AI assistant to look up a user, audit who changed what last week, add a member to a call queue, or walk an IVR menu's key actions.

Tool discovery¶

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