# Ringkit [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://www.ringkit.com/docs  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 1  
**Directory Page:** https://allmcps.com/mcp/ringkit

## Description
Manage an AI phone receptionist through MCP: update business answers and call routing, review call summaries, and manage phone numbers. Hosted service with OAuth support.

## Tools
Capabilities this server exposes over MCP:

- **ringkit_create_business** — Step 1: Create the business. Create a RingKit business (pay-per-minute AI phone receptionist) and its first API key, returned once. No auth needed: this is how an agent starts. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_whoami** — Step 1: Create the business. The business behind the API key on this connection, with authKind, role and the key's scope (manage or read).
- **ringkit_get_onboarding** — Setup progress: the next step (number | done), whether the business has a number, whether the knowledge profile has the basics, and the latest website import.
- **ringkit_start_knowledge_import** — Step 2: Teach it the business. Import the business website into the knowledge profile in the background: returns the queued import; poll ringkit_get_latest_knowledge_import until done or failed. Only fields that are still empty are filled; uploaded documents are never touched. An unfinished import is returned instead of starting another. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_get_latest_knowledge_import** — Step 2: Teach it the business. The newest website import and its status (queued, running, done, failed), or null when none was started.
- **ringkit_import_knowledge** — Step 2: Teach it the business. Crawl the business website now and draft a knowledge profile (hours, services, FAQs...). Set apply=true to save it, or review and use put/patch. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_start_setup_chat** — Step 2: Teach it the business. Open the setup assistant: a chat that interviews the owner and saves the answers (hours, services, policies, transfers...) into the knowledge profile and routing. Returns the open conversation with the assistant's opening message (restart=true starts over). Capped per business per day. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_send_setup_chat** — Step 2: Teach it the business. Send the owner's message to the setup assistant (conversationId from ringkit_start_setup_chat). The reply lists what was saved in `writes`. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_setup_chat** — The open setup-assistant conversation with its messages, or null.
- **ringkit_close_setup_chat** — Close a setup-assistant conversation (conversationId); what it saved stays saved. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_put_knowledge** — Step 2: Teach it the business. Replace the whole knowledge profile the AI receptionist answers from. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_patch_knowledge** — Step 2: Teach it the business. Update some top-level fields of the knowledge profile (others are kept). Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_knowledge** — Read the knowledge profile the receptionist answers from (services, hours, FAQs, policies).
- **ringkit_upload_knowledge_document** — Step 2: Teach it the business. Upload a document the receptionist should answer from (menu, price list, policies, manual). contentBase64 is the file's bytes, base64-encoded; fileName's extension picks the type: .pdf, .docx, .txt, .md, .html (PDF/DOCX only where the server has them enabled). Text is extracted at upload and searched on every call; a website import never removes uploads. Limits by tier (see get_knowledge_usage): 10 MB per file; Starter 5 documents / 50k tokens, Pro 100 / 500k. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_list_knowledge_documents** — List uploaded knowledge documents (newest first) with usage against the tier's limits.
- **ringkit_get_knowledge_document** — Read one uploaded document (documentId) with its extracted sections.
- **ringkit_delete_knowledge_document** — Delete an uploaded knowledge document (by documentId); the receptionist stops using it on the next call. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_knowledge_usage** — Read the knowledge tier (starter | pro), its limits, and how many documents/tokens are used.
- **ringkit_set_knowledge_tier** — Switch the knowledge tier. pro: 100 documents / 500k tokens for $5.00/month, accrued daily from the wallet (needs $5 of paid credit available; promotional credit doesn't count); starter: free, 5 documents / 50k tokens (refused while usage is over those limits). Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_list_voices** — Step 3: Pick a voice. List the receptionist voices (id, gender, accent) and the default. Pick one with ringkit_update_business {voice}.
- **ringkit_update_business** — Step 3: Pick a voice. Update the business: name, timezone, vertical, website, or `voice` (the receptionist's voice, an id from list_voices). Owner identity (ownerEmail, ownerPhone), status and notify need an owner; API keys are owners. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_routing** — Step 4: Decide who answers. Read the routing policy: when the AI answers, transfers or takes a message, the schedules, transfer targets and spend cap.
- **ringkit_put_routing** — Step 4: Decide who answers. Set the routing policy: transfer targets (your own team numbers the receptionist can transfer to) and handoff preferences, recording, spend cap. Full replace; omitted fields take defaults. Every call is answered by the AI (mode ai_only): ai_first/human_first are accepted but RingKit's live-rep pool is not offered, so they act as ai_only. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_voice_stack** — Read which voice stack answers the AI tier: livekit or elevenlabs (the ElevenLabs Agents platform running the same receptionist brain; a caller who needs a person is still transferred to the business's team number or a message is taken). The server chooses the initial stack based on provider availability. Shows desired vs applied, status ok | pending | error, the steps of the last switch and lastError.
- **ringkit_put_voice_stack** — Switch the voice stack: {stack: livekit | elevenlabs}. Applied synchronously (ElevenLabs agent sync, number import or removal, carrier routing), so it can take a few seconds. Needs an active number and ai_only/ai_first routing (human_first answers 409 voice_stack_unsupported_mode). A failed step answers 502 voice_stack_failed with the status in details: call it again with the same stack to resume. Owner only. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_simulate_call** — Step 5: Try it in text. Try the receptionist in text mode (no number needed; billed like a call at the AI rate from the wallet, requires available wallet credit). First call: omit callId and pass callerText "" to get the greeting; then pass the returned callId with each caller line. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_get_wallet** — Step 6: Fund the wallet. Read the prepaid wallet balance (cents), including the unspent promotional credit (trialCreditCents, calls only), and auto-refill.
- **ringkit_top_up** — Step 6: Fund the wallet. Add funds (min $10). Returns a checkoutUrl that the human must open and pay (you can't pay), or null when credited immediately (dev). A retried identical call returns the same checkout URL; pass a new idempotencyKey to start a second top-up of the same amount. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_get_auto_refill** — Read the auto-refill settings (enabled, threshold, amount) and whether a card is saved.
- **ringkit_put_auto_refill** — Step 6: Fund the wallet. Turn auto-refill on or off and set its threshold and amount. It may be enabled before a card is saved; refills start once the human saves one in the dashboard. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_list_ledger** — Wallet ledger entries (top-ups, call charges, rentals), newest first, paginated.
- **ringkit_search_numbers** — Step 7: Get a phone number. Search available phone numbers (US, by area code).
- **ringkit_provision_number** — Step 7: Get a phone number. Order a phone number for the business ($1.99 a month, billed daily from the wallet). Needs $2 of paid credit available (promotional credit covers calls only); no human sign-in. On 402 funding_required call ringkit_top_up, ask the human to pay the checkoutUrl, then retry. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_list_numbers** — Step 7: Get a phone number. List the business's phone numbers.
- **ringkit_release_number** — Release a phone number (numberId from list_numbers); it stops taking calls and its rental stops. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_verify_destination** — Step 8: Place a test call. Call `number` from the business's RingKit number and read a 6-digit code twice (valid 10 minutes), to prove the business controls it. The human who answers must tell you the code for ringkit_confirm_destination. A retried identical call returns the same result; pass a new idempotencyKey to place another verification call. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_confirm_destination** — Step 8: Place a test call. Confirm a number with the 6-digit code its verification call read (only the person who answered has it). 5 attempts per code. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_list_destinations** — Numbers the business proved it controls (allowed test-call targets and ownerPhone).
- **ringkit_test_call** — Step 8: Place a test call. Ring `to` from the business's RingKit number with the AI receptionist (a real call, billed at the AI rate). `to` must be configured on the business (ownerPhone, a transfer target or an SMS notify target) and verified. Ask the human to answer and talk to it like a caller. A retried identical call returns the same result; pass a new idempotencyKey to ring again. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_list_calls** — Step 9: Watch the calls. List recent calls with outcome, intent, summary and cost, newest first (paginated).
- **ringkit_get_call** — Step 9: Watch the calls. One call (callId) with its full transcript.
- **ringkit_get_recording** — Step 9: Watch the calls. A short-lived URL for a call's recording (callId); 404 when the call has none.
- **ringkit_create_webhook** — Step 10: Get told about calls. Subscribe a URL to call.completed / message.taken / balance.low events (HMAC-signed with the returned secret, shown once). Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_list_webhooks** — Step 10: Get told about calls. List the business's webhook endpoints and their events.
- **ringkit_create_api_key** — Step 11: Manage API keys. Create an API key: scope manage (acts as owner) or read (read-only tools / GET only). The plaintext apiKey is in this result once and never again. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_list_api_keys** — Step 11: Manage API keys. List the business's API keys (prefix, scope, last use, revoked or not); never the plaintext.
- **ringkit_revoke_api_key** — Step 11: Manage API keys. Revoke an API key (keyId from list_api_keys); it stops authenticating at once, including on this connection if it is this key. Reuse an idempotencyKey when retrying; without one, each call executes again.
- **ringkit_invite_owner** — Step 12: Hand it to the owner. Optional hand-over: emails a sign-in link bound to this business to `email` (default: ownerEmail), adding them as owner first. Nothing in setup needs it: the agent can keep running the line, and the human can take over any time by clicking the link (that sets ownerSignedInAt). 5 per business per hour; pass a new idempotencyKey to send again. Identical requests are deduplicated for 24 hours; use a new idempotencyKey only to deliberately repeat the action.
- **ringkit_get_business** — Step 12: Hand it to the owner. Read the business: profile, voice, status, how it was created (createdVia) and whether a human owner has signed in (ownerSignedInAt).
- **ringkit_list_business_users** — Step 12: Hand it to the owner. List the people who can sign in to the business dashboard, with their roles and last sign-in.
- **ringkit_complete_onboarding** — Step 12: Hand it to the owner. Mark first-run setup finished (the business has a number, or the owner chose to do it later) so the dashboard stops nudging. Reuse an idempotencyKey when retrying; without one, each call executes again.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What Ringkit does

Ringkit exposes an AI phone receptionist through MCP. Agents can create a business, configure the receptionist's knowledge, choose a voice, define transfer and message-taking behavior, select a voice stack, simulate calls, and manage the prepaid wallet used for call charges.

The knowledge system supports structured business details such as hours, services, FAQs, and policies. It can also use website imports, uploaded documents, and an interactive setup conversation. Uploaded files are extracted when added and remain separate from later website imports.

## How it works

Connect an MCP client to `https://api.ringkit.com/mcp`. OAuth is supported for the hosted service. A new business can be created through `ringkit_create_business` without prior authentication; the response includes the first API key, which is returned only once. Subsequent operations use the business associated with the connection or key.

The tools follow a staged onboarding flow:

1. Create the business and inspect its identity and onboarding state.
2. Populate the knowledge profile from a website, documents, direct updates, or the setup assistant.
3. Select a receptionist voice.
4. Configure schedules, transfer targets, handoff preferences, recording, and spending limits.
5. Test the receptionist in text mode with `ringkit_simulate_call`.
6. Check the wallet and add funds or configure auto-refill.

Website imports run in the background. Start one with `ringkit_start_knowledge_import`, then poll `ringkit_get_latest_knowledge_import` for queued, running, done, or failed status. Text simulations do not require a phone number, but they are charged at the AI call rate and require available wallet credit.

## Setup and configuration

The hosted MCP URL is:

```text
https://api.ringkit.com/mcp
```

Use `ringkit_update_business` for the business name, timezone, vertical, website, or receptionist voice. `ringkit_list_voices` provides the available voice IDs. Routing is replaced as a complete policy through `ringkit_put_routing`; the service currently answers calls with the AI, while accepted `ai_first` and `human_first` values behave as AI-only because no live-representative pool is offered.

Voice-stack changes use `ringkit_put_voice_stack` with either `livekit` or `elevenlabs`. The business needs an active number and compatible routing. Switching performs carrier and agent synchronization and may take several seconds.

## Tools and capabilities

- Create businesses and inspect the connected business, role, authorization kind, and key scope.
- Import website content, replace or patch structured knowledge, and run an owner-facing setup chat.
- Upload, list, inspect, and delete PDF, DOCX, TXT, Markdown, or HTML knowledge documents.
- Read usage limits and switch between Starter and Pro knowledge tiers. Starter allows five documents and 50,000 tokens; Pro allows 100 documents and 500,000 tokens for $5 per month, subject to available paid wallet credit.
- Read and replace call-routing policies, including transfer targets, schedules, recording, and spending caps.
- List voices, change the selected voice, inspect the active voice stack, and switch between LiveKit and ElevenLabs.
- Simulate calls, inspect wallet balances and promotional call credit, add funds, and configure auto-refill.

Most mutating operations accept an idempotency key. Identical requests are commonly deduplicated for 24 hours, while retries without a key can execute again.

## Limitations and notes

Knowledge documents have a 10 MB per-file limit. PDF and DOCX extraction is available only where enabled for the account tier. Website imports fill empty knowledge fields and do not remove uploaded documents.

A top-up requires at least $10. In hosted use, the tool returns a checkout URL that a human must open and pay; agents cannot complete that payment. Auto-refill begins after a human saves a payment card in the dashboard.

The voice-stack switch requires an active phone number. If a switch fails, the status includes the failed step and error; repeating the request with the same stack resumes the operation. Setup chat usage is capped per business per day, and the receptionist stops using a deleted document on the next call.

_Full upstream README: https://allmcps.com/mcp/ringkit/readme_

