com.ringkit/ringkit · v0.0.3 · productivity
RingKit is healthy: it completed an MCP handshake in 1300 ms and exposes 51 tools.
Cheapest AI virtual assistant for your business line: $1.99/mo per number, then pay only for usage.
Endpoint: https://api.ringkit.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 51 |
| Latency | 1300 ms |
| Last checked (UTC) | 2026-11-06T03:10:45.102Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-06T03:10:45.102Z | Healthy | 1300 |
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 i |
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 |
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 |
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; free trial credit doesn't count); starter: free, 5 documents / 50k tokens (refused while usage is over those limits). Reuse an idempotencyKey when retrying; |
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 ex |
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 |
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 availab |
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 ans |
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, the free trial credit covers it). First call: omit callId and pass callerText "" to get the greeting; then pass the returned callId with each caller line. Reuse an idempote |
ringkit_get_wallet | Step 6: Fund the wallet. Read the prepaid wallet balance (cents), including the unspent free trial 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 requ |
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 (free trial 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. I |
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 |
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 |
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 ownerSign |
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. |