What is Ringotel MCP?
Ringotel MCP Server is a connector that links Claude AI to your Ringotel account. Once connected, you can manage your entire Ringotel account through natural conversation, no admin portal, no API calls needed.
With Ringotel MCP connected, you can ask Claude things like:
“List all users in the Dublin organisation”
“Show me all calls made yesterday in org ABC”
"Pull call activity for all organisations over the last 90 days. Give me a summary I can use for a monthly review."
“Disable the Finance organisation”
“Reset the password for extension 1002 in ABCD Company”
"Push the following settings to all connections across all orgs: disable video calls, set DTMF mode to rfc2833, and set the re-registration timeout to 300 seconds. Do a dry run first so I can see what would change before we apply it."
Requirements
Claude account | Pro, Max, Team, or Enterprise plan. Free plan: limited to one custom connector. |
Ringotel API token | Generated in your Ringotel Shell admin portal under Account > Settings > API Settings. |
MCP server URL |
Connecting Claude to Ringotel
To add the Ringotel MCP connector to your Claude account follow these steps.
Go to claude.ai and sign in to your account. Click your profile icon in the top-right corner, then select Settings.
In the left sidebar, click Connectors. Scroll to the bottom of the page and click Add custom connector.
In the dialog that appears, paste your MCP server URL: https://mcp.ringotel.com/mcp. Click Add.
Claude will open a browser window showing the Ringotel login page. Paste your Ringotel API key into the field and click Connect to Ringotel. Your token is validated against your Ringotel account in real time and is never stored in plaintext on the server.
Claude will redirect back and the Ringotel connector will appear in your Connectors list with a Connected status. Start a new conversation and ask Claude: “List my Ringotel organisations” to confirm everything is working.
Note:
You may need to reconnect if your Ringotel API Key has changed or a major update has been published to the Ringotel MCP Server.
Using the Ringotel Connector
Once connected, the Ringotel tools are available in any Claude conversation. Here are some examples of what you can do.
Organisations
List all organisations: “Show me all my Ringotel organisations”
Create an organisation: “Create a new org called Acme Ltd in the Dublin region”
Change domain: “Change the domain of org ABC to newdomain”
Enable or disable: “Disable the Finance organisation”
Bulk disable: “Disable these 3 organisations: [list of domains]”
Connections
List connections: “List all connections in org XYZ”
Create connection: “Create a new SIP connection called Main PBX in org ABC with address pbx.example.com”
Enable recording: “Enable call recording on all connections across all organisations”
Users
List users: “List all users in organisation XYZ”
Find by extension: “Find which organisation has extension 205”
Create a user: “Add user John Smith with username jsmith, email john@company.com”
Recover deleted user: “Recover the deleted user with extension 502 in domain acme”
Reset password: “Reset the password for extension 1002 in org ABC”
Activate / deactivate: “Deactivate user ID 12345 in org XYZ”
Inactive users: “Find all users who haven’t made any calls in the last 30 days”
Messaging & Chat
List chat users: “List all chat users in org ABC”
Send message: “Send a message to extension 205 in domain acme saying Hello”
SMS chats: “Show me SMS chats for number +353871234567 today”
Send file: “Send this file URL to extension 301 in org XYZ”
Call Logs & Activity
View calls: “Show me all calls made by extension 205 yesterday”
Call summary: “How many calls did org ABC make last week?”
Across all orgs: “Give me a call activity summary for all organisations over the last 30 days”
Tip:
You can enable or disable specific Ringotel tools within a conversation using the Search and tools menu. This is useful if you only want Claude to perform read-only operations.
Bulk tools
Bulk tools run in parallel across all your organisations, processing up to 10 organisations simultaneously. They all support a dry_run option to preview changes without making them.
Note:
For operations not listed above, you can ask Claude to call any Ringotel API method directly. For example: “Call the Ringotel API method getSIPCredentials for user 12345 in org XYZ”.
Security & Privacy
Your Ringotel API key is handled securely throughout the connection process:
API key encryption | Your Ringotel API key is encrypted with AES-256-GCM before being stored in in-memory in the session token. It is never logged or saved permanently to disk. |
Token validation | Your token is validated against the live Ringotel API at login time. Invalid tokens are rejected immediately. |
No shared credentials | Each account authenticates with their own Ringotel API key. Keys are not shared between accounts. |
HTTPS only | All communication between Claude and the MCP server uses HTTPS with a valid TLS certificate. |
Important:
Your Ringotel API key grants full admin access to your Ringotel account. Do not share it with anyone. If you believe your key has been compromised, regenerate it immediately in your Ringotel Shell admin portal under API Settings.
Troubleshooting
"Authorization with the MCP server failed"
This usually means the OAuth login did not complete successfully. Try the following:
Remove the connector from Settings → Connectors.
Add it again and complete the login page with a fresh API token.
Make sure your API key is valid.
"This connector has no tools available"
This can happen if the connection was established but Claude could not retrieve the tool list. Try:
Disconnecting and reconnecting the connector.
Starting a fresh conversation and enabling the connector again.
"Invalid Ringotel API token"
The token you entered was rejected by the Ringotel API. Check that:
You copied the full token without any extra spaces.
The token has not expired or been regenerated since you last used it.
Your token is from the correct Ringotel Shell instance (e.g. shell.ringotel.co or your white-label portal).
Connector appears connected but Claude gives wrong answers
Claude uses your Ringotel account data in real time. If results look unexpected:
Double-check the organisation or user IDs Claude is referencing.
Ask Claude to clarify: “Which organisation ID did you use for that?”
Try asking more specifically: “List all organisations first, then show users in org Acme Ltd.”
Frequently Asked Questions
Do I need a paid Claude plan?
No. Custom connectors using remote MCP are available on Claude, Cowork, and Claude Desktop for users on Free, Pro, Max, Team, and Enterprise plans. Free users are limited to one custom connector. This feature is currently in beta.
Can multiple team members use the same connector?
Yes, but each person must add the connector to their own Claude account and authenticate with the API key from your Ringotel account.
Can Claude make changes to my Ringotel account?
Yes. The connector has full access to your Ringotel account based on your API key permissions. Claude can create, update, and delete users, organisations, and other resources. Always review what Claude is about to do before confirming destructive actions.
What happens if my API key changes?
If you regenerate your Ringotel API key, your existing connector session will eventually expire (within 1 hour for active sessions, or 30 days for idle ones). You will need to reconnect the connector by removing it and adding it again with your new token.
Is my data sent to Anthropic?
When you use Ringotel tools in Claude, the data returned from your Ringotel account (user lists, call logs, etc.) is processed by Claude to generate responses. This is subject to Anthropic’s standard privacy policy. The MCP server itself does not send your data anywhere other than back to Claude.
Can I use this on Claude mobile apps?
Yes. Once you have set up the connector on claude.ai, you can use Ringotel tools on the Claude iOS and Android apps as well. You cannot add new connectors from the mobile app, this must be done from claude.ai on a desktop browser.
Getting Support
Claude account or subscription issues | Anthropic Help Center at support.claude.ai |
Ringotel API or account questions |