# Ringkit Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## Ringkit

Set up an AI phone receptionist that answers your business line and takes messages

- Record: https://musedirectory.ai/connector/ringkit
- Category: Productivity
- Developer: Ringkit (https://www.ringkit.com/docs)
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 681ms, checked 2026-11-07T03:31:00Z
- Endpoint: https://api.ringkit.com/mcp
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-11-06T03:11:20Z)
- Source: Found in the official MCP Registry (com.ringkit/ringkit) https://registry.modelcontextprotocol.io/v0/servers?search=com.ringkit%2Fringkit

Connects to Ringkit's AI phone receptionist service. Muse can create a business, import a website and documents into a knowledge profile, choose a voice, set routing and transfer numbers, rent a phone number, place test calls, and review call summaries and costs.

Example request: "Set up an AI receptionist for my salon's phone line so it answers questions about hours and prices when I'm with a client."

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use Ringkit to help me. It is a free service with an MCP server at https://api.ringkit.com/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

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. An
- 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 start
- 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 the
- 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 idempotenc
- 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; witho
- 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
- 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
- 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
- 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 lin
- 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 am
- 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 checko
- 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
- 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
- ringkit_list_calls: Step 9: Watch the calls. List recent calls with outcome, intent, summary and cost, newest first (paginated).

Screening checks:
- MCP handshake: pass (Answered in 667ms)
- Domain against threat feeds (Cloudflare security DNS): pass (api.ringkit.com, www.ringkit.com not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: pass (51 tools read, nothing found)
- Inputs asking for passwords, card numbers or seed phrases: pass (None found)
- Domain and redirects: pass (Domain registered 6392 days ago)
- AI review of purpose and tool behavior: pass (creates accounts and spends prepaid wallet funds without sign-in; can provision and release phone numbers that cost money)