usefulapiRinkel MCP server
Read Rinkel calls, voicemails, contacts and numbers; add call notes, edit contacts, block numbers. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.
What can I ask?
Turn on the Rinkel connector, then ask in plain words. The AI picks the tools.
- Which calls did we miss this week, and who called more than once?
- Do I have new voicemails? Give me the caller and the length of each.
- Add a note to the last call from +31612345678: wants a quote by Friday.
- Block +31850001234 from calling any of our numbers, reason: spam.
What you can do with Rinkel in Claude and ChatGPT
For businesses that use Rinkel as their cloud phone system.
Find missed calls and repeat callers
Lists calls with date, direction, status (answered, missed, voicemail), duration and numbers, so you can find missed calls and numbers that called more than once.
Check new voicemails
Counts the voicemails not played yet and lists them with caller, date and length. Can also give a temporary link to listen to one.
Read a call transcription or get a recording link
Gets the transcription of a call, if the account has AI insights, or a temporary link to stream or download the call recording.
Add or change a note on a call
Adds a note to a call record, or replaces the text of an existing note. Everyone who sees the call can see the note.
Changes dataLook up, add or update a contact
Finds the contact that owns a phone number, creates a contact, or updates one. Contacts are shared with everyone in the account.
Changes dataBlock or unblock a phone number
Blocks a number, anonymous callers or a prefix such as +31* from calling any of the account's numbers, or removes a number from the block list.
Changes dataHow do I connect Rinkel?
Before you connect
The login page asks for your Rinkel API key.
Create it in My Rinkel → Settings → Integrations (API access is included in the Professional and Expert plans). The key gives access to the call data of your whole Rinkel account. It is used only to call the Rinkel API on your behalf and is never shown to anyone; you can delete it in My Rinkel at any time.
Claude claude.ai · Desktop
- Open Customize → Connectors, then click + Add → Add custom connector.
- Enter the name Rinkel and this URL, then click Add:https://
rinkel. usefulapi. io/ mcp - Claude opens the login page: enter your Rinkel API key.
- In a chat, click + → Connectors and turn on Rinkel.
Team and Enterprise: an Owner adds the connector for the organization first.
ChatGPT chatgpt.com
- Open Plugins, click +, then Add custom MCP server.
- Enter the name Rinkel and this URL, choose OAuth as the authentication, confirm the warning and create it:https://
rinkel. usefulapi. io/ mcp - ChatGPT opens the login page: enter your Rinkel API key.
- In Plugins, install Rinkel, then choose it in a chat.
No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.
Claude Code
Run this command, then run /mcp in Claude Code to log in:
Cursor
Add to Cursor or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"rinkel": {
"url": "https://rinkel.usefulapi.io/mcp"
}
}
} VS Code
Add to VS Code or add this to .vscode/mcp.json:
{
"servers": {
"rinkel": {
"type": "http",
"url": "https://rinkel.usefulapi.io/mcp"
}
}
} Codex
Run these commands. The second one opens the login page:
Other clients
Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.
Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your Rinkel API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Proper user | $9/mo · $90/yr | 10,000 tool calls / month |
| Pro+per user | $39/mo · $390/yr | 100,000 tool calls / month |
Each paid plan covers this Rinkel server only. Ask your AI to run rinkel_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with rinkel_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with rinkel_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
Tools 31
Show all 31 tools (the AI picks them for you)
Read only · 18
- List calls
rinkel_list_callsList call detail records (inbound and outbound calls) with date, direction, status (ANSWERED, MISSED, VOICEMAIL, ANSWERING_SERVICE), duration, external and internal number, the users involved, notes, and (when the account has Rinkel AI insights) the AI summary and sentiment. Use for 'who called today', 'which calls did we miss this week', 'calls longer than 5 minutes'. Newest first by default. - Get a call
rinkel_get_callGet one call detail record by its Rinkel id (the `id` field of rinkel_list_calls): numbers, users, status, duration, notes, voicemail and call-recording ids, AI insights. - Get a call by network call id
rinkel_get_call_by_network_idGet one call detail record by its network `callId` (the id Rinkel sends in webhook events), optionally with insights and notes. - Get a call transcription
rinkel_get_call_transcriptionGet the raw transcription of a call by its network `callId` (needs Rinkel AI insights on the account; 404 when the call has none). - Get a call recording URL
rinkel_get_call_recording_urlGet a temporary URL (valid 3 hours) to stream or download a call recording. The id is `callRecording.id` of a call record. Append `download` as a query parameter to the URL to download instead of stream. - List voicemails
rinkel_list_voicemailsList voicemail messages (call records with status VOICEMAIL): caller, date, duration, whether new, and the voicemail id. Newest first. With is_new=true Rinkel ignores every other filter and returns only unplayed voicemails. - Count new voicemails
rinkel_count_new_voicemailsNumber of voicemails that have not been played yet. - Get a voicemail URL
rinkel_get_voicemail_urlGet a temporary URL (valid 3 hours) to stream or download a voicemail. The id is `voicemail.id` of a call or voicemail record. - List contacts
rinkel_list_contactsList the contacts shared with everyone in the account (plus the Rinkel system contact, tag 'system'): names, company, phone numbers, email. - Get a contact
rinkel_get_contactGet one contact by id. - Find a contact by phone number
rinkel_find_contact_by_numberFind the contact that owns a phone number (E.164 such as +31612345678 works best). 404 when there is none. - List users
rinkel_list_usersList the account's users: name, email, phone number, role (ADMIN, USER, ANSWERINGSERVICE), availability schedule and status, and `fixed`/device info (`deviceId` is needed to start a call). - Get a user
rinkel_get_userGet one user by id, including preferences, notification settings, schedule and `deviceId`. - List phone numbers
rinkel_list_numbersList the account's Rinkel phone numbers: id, label, number, status (ACTIVE, SUSPENDED, PENDING_PORTING_IN ...), activation date and the users assigned. - Get a phone number
rinkel_get_numberGet one Rinkel number with its full dial plan: greeting, business hours schedule, call forwarding targets and ring logic, voice menu, call recording and caller-id settings. - List greeting recordings
rinkel_list_recordingsList the uploaded audio recordings used in the dial plan (greetings, announcements, voice-over scripts): name, description, duration and where each is used. Not call recordings. - List webhooks
rinkel_list_webhooksList the webhook subscriptions (events incomingCall, outgoingCall, callStart, callEnd, callInsights) with URL and active flag. Webhooks need the Expert plan. - Validate a phone number
rinkel_validate_phone_numberCheck a phone number for a country and return its normalised form. With check_inventory=true Rinkel also checks whether the number is available to order.
Changes data · 9
- Add a call note
rinkel_add_call_noteWRITE: add a note to a call record (visible to everyone in the account who sees the call). The id is the call record's `id`; if Rinkel answers 404, retry with the record's `callId`. - Update a call note
rinkel_update_call_noteWRITE: replace the text of an existing note on a call record (the note id is in `notes[].id` of the call record). - Delete a call note
rinkel_delete_call_noteWRITE, irreversible: delete one note from a call record. Needs confirm=true after the user approved it. - Create a contact
rinkel_create_contactWRITE: create a contact. It is shared with everyone in the Rinkel account (all users see it and calls from its numbers show its name). - Update a contact
rinkel_update_contactWRITE: update a contact (PUT semantics). `numbers` is required and REPLACES all stored numbers, and an omitted default_outbound_number_id CLEARS it; omitted names, company and email keep their stored value. Read the contact first (rinkel_get_contact) and resend what must stay. The system contact cannot be changed. - Delete a contact
rinkel_delete_contactWRITE, irreversible: delete a contact for the whole account. Needs confirm=true after the user approved it. The Rinkel system contact cannot be deleted. - Block a number
rinkel_block_numberWRITE: block a number from calling ANY of the account's numbers. Accepts an E.164 number, 'anonymous', or a prefix wildcard such as '+31*' (a wildcard must end the value and include a country code; a broad wildcard blocks every caller from that country). Undo with rinkel_unblock_number. - Unblock a number
rinkel_unblock_numberWRITE: remove a number (or the same wildcard pattern that was blocked) from the block list so it can call again. - Start an outgoing call
rinkel_start_callWRITE, COSTS CALL MINUTES: starts a real phone call. Rinkel rings the given user device first and, once it is answered, dials `to` using the chosen Rinkel number as caller id, so call charges apply to the account and the person called sees the number. Needs confirm=true, set only after the user explicitly asked to place this call. Get device_id from rinkel_list_users (`fixed`/device info or `deviceId`) and number_id from rinkel_list_numbers.
Your usefulapi plan · 4
- Usage status (free-tier meter)
rinkel_usage_statusReport the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter. - Request a missing feature
rinkel_request_featureTell usefulapi that the user needs something the Rinkel tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter. - Upgrade to Pro or Pro+
rinkel_upgradeGet a paid plan for Rinkel (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter. - Cancel the Pro subscription
rinkel_cancel_subscriptionCancel the caller's Rinkel Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run rinkel_upgrade later to undo the cancel before the period ends. Does not count against the meter.
FAQ
What can I do with Rinkel in Claude or ChatGPT?
Find missed calls and repeat callers. Check new voicemails. Read a call transcription or get a recording link. Add or change a note on a call. Look up, add or update a contact. Block or unblock a phone number. See what you can do for the details.
Is this an official Rinkel product?
No. usefulapi is an independent service. It is not affiliated with or endorsed by Rinkel. The server calls the Rinkel API with your own Rinkel access, so it sees only the data that your account can see.
Can I connect Rinkel to Claude or ChatGPT?
Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.
What do I need to connect?
The login page asks for your Rinkel API key. See Before you connect for where to find it.
Do I put my Rinkel key or an Authorization header in the client config?
No. Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: the login page asks for your Rinkel API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
How do you keep my Rinkel credentials?
The login stores them encrypted in the authorization grant of your connection. The server uses them to call the Rinkel API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in Rinkel.
Can the AI change my Rinkel data?
Yes, if you approve it. 9 of the 27 Rinkel tools can create or change data. The other 18 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.
What does it cost?
The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this Rinkel server only. Cancel any time: your paid plan then runs to the end of the paid period. Run rinkel_usage_status to see how many calls you used.
How do I subscribe or cancel?
Ask the AI to run rinkel_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run rinkel_cancel_subscription. Your paid plan continues to the end of the paid period.
What if a Rinkel tool that I need is missing?
Tell the AI what you wanted to do. It can send the request with rinkel_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.
Which AI clients can I use?
Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.
Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.