MCP server

Rinkel MCP by usefulapi

io.usefulapi/rinkel

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read Rinkel calls, voicemails, contacts and numbers; add call notes, edit contacts, block numbers.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

27

Token cost

About 6,210 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http rinkel https://rinkel.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.rinkel]
url = "https://rinkel.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"rinkel":{"httpUrl":"https://rinkel.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"rinkel":{"url":"https://rinkel.usefulapi.io/mcp"}}}

VS Code

{"servers":{"rinkel":{"type":"http","url":"https://rinkel.usefulapi.io/mcp"}}}

Antigravity

agy mcp add rinkel https://rinkel.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"rinkel","server_url":"https://rinkel.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"rinkel","server_url":"https://rinkel.usefulapi.io/mcp"}

Tools

• rinkel_add_call_note ~180 tokens
  WRITE: 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`. Rinkel API: PUT /call-detail-records/{callId}/note.
• rinkel_block_number ~214 tokens
  WRITE: 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. Rinkel API:
• rinkel_count_new_voicemails ~72 tokens
  Number of voicemails that have not been played yet. Rinkel API: GET /voicemails/new-count.
• rinkel_create_contact ~344 tokens
  WRITE: create a contact. It is shared with everyone in the Rinkel account (all users see it and calls from its numbers show its name). Rinkel API: POST /contacts.
• rinkel_delete_call_note Deletes data · ~190 tokens
  WRITE, irreversible: delete one note from a call record. Needs confirm=true after the user approved it. Rinkel API: DELETE /call-detail-records/{callId}/note/{noteId}.
• rinkel_delete_contact Deletes data · ~162 tokens
  WRITE, irreversible: delete a contact for the whole account. Needs confirm=true after the user approved it. The Rinkel system contact cannot be deleted. Rinkel API: DELETE /contacts/{id}.
• rinkel_find_contact_by_number ~139 tokens
  Find the contact that owns a phone number (E.164 such as +31612345678 works best). 404 when there is none. Rinkel API: GET /contacts/find-by-number/{number}.
• rinkel_get_call ~140 tokens
  Get 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. Rinkel API: GET /call-detail-records/{id}.
• rinkel_get_call_by_network_id ~161 tokens
  Get one call detail record by its network `callId` (the id Rinkel sends in webhook events), optionally with insights and notes. Rinkel API: GET /call-detail-records/by-call-id/{callId}.
• rinkel_get_call_recording_url ~164 tokens
  Get 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. Rinkel API: GET /call-recordings/{id}/stream.
• rinkel_get_call_transcription ~148 tokens
  Get the raw transcription of a call by its network `callId` (needs Rinkel AI insights on the account; 404 when the call has none). Rinkel API: GET /call-detail-records/by-call-id/{callId}/transcription.
• rinkel_get_contact ~88 tokens
  Get one contact by id. Rinkel API: GET /contacts/{id}.
• rinkel_get_number ~136 tokens
  Get 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. Rinkel API: GET /numbers/{id}.
• rinkel_get_user ~130 tokens
  Get one user by id, including preferences, notification settings, schedule and `deviceId`. Rinkel API: GET /users/{id}.
• rinkel_get_voicemail_url ~129 tokens
  Get a temporary URL (valid 3 hours) to stream or download a voicemail. The id is `voicemail.id` of a call or voicemail record. Rinkel API: GET /voicemails/{id}/stream.
• rinkel_list_calls ~1087 tokens
  List 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 toda
• rinkel_list_contacts ~210 tokens
  List the contacts shared with everyone in the account (plus the Rinkel system contact, tag 'system'): names, company, phone numbers, email. Rinkel API: GET /contacts.
• rinkel_list_numbers ~95 tokens
  List the account's Rinkel phone numbers: id, label, number, status (ACTIVE, SUSPENDED, PENDING_PORTING_IN ...), activation date and the users assigned. Rinkel API: GET /numbers.
• rinkel_list_recordings ~226 tokens
  List 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. Rinkel API: GET /recordings.
• rinkel_list_users ~125 tokens
  List 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). Rinkel API: GET /users.
• rinkel_list_voicemails ~656 tokens
  List 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. Rinkel API: GET /voicemails.
• rinkel_list_webhooks ~97 tokens
  List the webhook subscriptions (events incomingCall, outgoingCall, callStart, callEnd, callInsights) with URL and active flag. Webhooks need the Expert plan. Rinkel API: GET /webhooks.
• rinkel_start_call ~357 tokens
  WRITE, 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 expl
• rinkel_unblock_number ~129 tokens
  WRITE: remove a number (or the same wildcard pattern that was blocked) from the block list so it can call again. Rinkel API: DELETE /privacy/unblock-number.
• rinkel_update_call_note ~187 tokens
  WRITE: replace the text of an existing note on a call record (the note id is in `notes[].id` of the call record). Rinkel API: PATCH /call-detail-records/{callId}/note/{noteId}.
• rinkel_update_contact ~440 tokens
  WRITE: 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 can
• rinkel_validate_phone_number ~204 tokens
  Check 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. Rinkel API: GET /misc/validate-phone-number.

Browse

• Email
• Speech to text

Related MCP servers

• Placetel MCP by usefulapi
  Read Placetel calls, recordings, numbers and routing; edit contacts, start calls, send SMS.
• Spruce Health MCP by usefulapi
  Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only).
• DialMyCalls MCP by usefulapi
  Manage DialMyCalls contacts and groups; read broadcasts; send text and voice broadcasts on approval.
• WhatConverts MCP by usefulapi
  Read WhatConverts leads, calls, forms, accounts and profiles; add leads and update lead value.
• Aircall MCP by usefulapi
  Read calls, contacts, users, teams and numbers; tag calls and create or update contacts.
• myPhoner MCP by usefulapi
  Work myPhoner calling lists and leads: search, log call outcomes, add, update and assign leads.
• Kickserv MCP by usefulapi
  Look up Kickserv customers, jobs, notes and time entries, and create jobs, tasks and charges.
• Textline MCP by usefulapi
  Read Textline conversations, contacts and reports; send a text, add notes, resolve or transfer.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/rinkel.svg)](https://aptlynx.net/servers/io.usefulapi/rinkel)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents