# RingCentral MCP

> RingCentral MCP handles all your business communications right where you work. Send SMS texts, audit detailed call logs, check real-time status, and manage your entire message history—all through a natural conversation with your AI agent.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** telephony, sms, call-logs, presence, webhooks

## Description

Connecting RingCentral to your agent means you never have to jump between platforms for basic comms tasks. You can send an immediate follow-up text or check if the contact left a voicemail without leaving your workspace. Need to audit communication patterns? Just ask, and your agent pulls detailed call logs filtered by date or type. It also tracks who's available right now, so you know when it’s safe to call. All of this capability is housed within Vinkius, making RingCentral accessible instantly from any MCP-compatible client you already use.

## Tools

### list_call_logs
Retrieves a list of calls made to or from the authenticated extension, filterable by date and call type.

### create_subscription
Sets up a new webhook subscription to ensure your system gets notified about specific events.

### list_subscriptions
Provides an overview of all active and registered event subscriptions.

### list_message_store
Pulls together a list of historical messages from your combined message store.

### get_presence
Checks and reports the real-time availability status of the authenticated extension.

### renew_subscription
Renews an existing webhook subscription to keep your system updated on incoming events.

### send_sms
Initiates and sends a text message directly from the authenticated RingCentral number.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +1234567890 from my number +1098765432 saying 'Hello from AI agent!'
```

**Response:** 
```
I've sent the SMS. The message ID is 12345678 and the status is currently 'Sent'.
```

**Prompt:** 
```
Show me my call logs from the last 24 hours.
```

**Response:** 
```
I found 3 calls in the last 24 hours: two inbound voice calls from +15550102 and one outbound fax. Would you like the detailed view for any of these?
```

**Prompt:** 
```
Check my current presence status and tell me if I'm on a call.
```

**Response:** 
```
Your current status is 'Available' and your telephony state is 'Idle'. You are not currently on an active call.
```

## Capabilities

### Sending SMS Texts
Your agent sends text messages directly through your connected RingCentral number.

### Auditing Call Records
You retrieve detailed lists of past calls, filtering results by date range or call type for auditing purposes.

### Checking Availability
Your agent determines the current online status and telephony state of an extension in real time.

### Reviewing Message History
You access a unified view of past interactions, including SMS, fax, and voicemail transcriptions.

### Managing Event Notifications
Your agent handles the setup and renewal of webhooks to notify your system about incoming messages or calls.

## Use Cases

### A sales rep needs to follow up after a demo.
The agent finds out the prospect left an unread message; then, using `send_sms`, it sends a quick thank-you text confirming the next steps. This keeps the momentum going without opening their phone app.

### A support team needs to check a client's history.
The agent uses `list_message_store` and `list_call_logs` to pull up every interaction—the voicemail from last week, the call summary today—and gives it all to the agent for review.

### An operations team needs system monitoring.
The manager asks the agent to check if a critical webhook subscription is active. The agent uses `list_subscriptions` and `renew_subscription`, ensuring continuity without manual intervention in the developer console.

### A user wants to know if an employee can take calls.
The user asks, 'Is Sarah available right now?' The agent immediately runs `get_presence` and replies with her current status (Available/Busy), saving the user time.

## Benefits

- Stop switching apps to check who called. You can ask your agent for call logs and get a filtered report instantly, letting you audit communication patterns without clicking through dashboards.
- Need to follow up? Use the `send_sms` tool to send texts directly from your primary AI interface. It's faster than opening the texting app and manually typing in numbers.
- Know if someone is available before calling them. The agent runs `get_presence` to confirm the real-time status of an extension, preventing wasted calls.
- Get a single view of everything. Instead of checking separate folders for voicemail, faxes, and texts, you use `list_message_store` to access all past interactions together.
- Keep your integrations running smoothly by managing webhooks. You can `create_subscription`, `list_subscriptions`, or `renew_subscription` without needing the developer portal.

## How It Works

The bottom line is that you use natural language prompts instead of complex UI navigation to manage all your communications.

1. First, you subscribe to this MCP and provide your RingCentral Access Token.
2. Next, you talk to your AI agent, asking it to perform a specific communication task—like checking call logs or sending an SMS.
3. The agent executes the request via RingCentral and reports back with the requested data or confirms the action.

## Frequently Asked Questions

**How do I check my current availability using RingCentral MCP?**
You run `get_presence` through your agent. It instantly tells you the extension’s real-time status and telephony state, so you know immediately if calling is appropriate.

**Can I use RingCentral MCP to send texts from my AI client?**
Yes. You prompt your agent to `send_sms`, and it sends the message using your connected RingCentral number. This works just like sending a text through any native messaging app.

**Does RingCentral MCP help with call logging?**
Absolutely. The `list_call_logs` tool lets you pull comprehensive reports of all calls, and you can filter those logs by specific date ranges or types for auditing purposes.

**What if my webhook subscription expires? Can RingCentral MCP fix it?**
Yes. You can use `list_subscriptions` to see what's active, and then use `renew_subscription` to keep your system connected without needing developer access.

**Does this MCP cover voicemail transcripts?**
The message store includes voicemails. By using the list_message_store tool, you can retrieve and review past voice messages along with text and fax history in one place.