RingKit

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "ringkit": {
      "type": "http",
      "url": "https://api.ringkit.com/mcp"
    }
  }
}

51 tools

• 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…

• 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…

• 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…

• 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…

• 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…

• 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…

• 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)…

• 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…

• 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…

• 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…

• 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…

• 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…

• 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…

• 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…

• ringkit_list_calls

  Step 9: Watch the calls. List recent calls with outcome, intent, summary and cost, newest first (paginated).

Security scan

Recent checks