BotPhone
BotPhone MCP for Muse
Sign inSign up free
Back to BotPhone for Muse

BotPhone MCP · BotPhone for Muse

Connector Docs

BotPhone for Muse gives your Muse one configurable AI phone agent for inbound and outbound calls. This page covers setup, prompts, knowledge, call missions, and the MCP connector.

Effective September 20, 2026 · Last updated October 13, 2026

1. How the agent works

Each BotPhone number has one AI agent with one editable main prompt and one knowledge base. The same identity and instructions apply when the agent answers an inbound call or places an outbound call for you. Voice, model, disclosure, safety, billing, and call-control rules are managed by BotPhone so setup stays simple.

The main prompt answers one question: What should this agent do? You can start from a Personal Assistant or Business Receptionist preset, start blank, edit the prompt directly in the BotPhone dashboard, or tell Muse what job you want the agent to perform.

Outbound missions

An outbound call can have a temporary mission in addition to the saved prompt. For example, an agent whose normal job is to manage appointments can receive the mission “Call my dentist and move Friday’s appointment.” The mission applies only to that call and does not change the agent’s saved prompt.

2. Knowledge

Add information the agent may use during either inbound or outbound calls. Knowledge belongs to this agent and does not replace its main instructions.

  • Pasted text: add policies, services, prices, FAQs, hours, or any other approved reference material.
  • One web page: give BotPhone a public URL to read and index.
  • Website crawl: ask BotPhone or Muse to crawl a bounded set of public pages from the same website.

Sources show their status as queued, fetching, indexing, ready, or failed. Only ready sources are used. You can refresh, retry, or remove a source at any time. When the agent cannot find a supported answer, it is instructed to say that it does not know instead of inventing one.

3. Editing through Muse

Muse is the easiest way to set up and manage the agent. You can speak naturally instead of filling out a long settings form. For example:

  • “Make my BotPhone agent answer calls for my plumbing business and take a clear message when it cannot help.”
  • “Learn the services and FAQs from example.com.”
  • “Add this cancellation policy to its knowledge.”
  • “Make the prompt shorter and tell callers that same-day appointments are not guaranteed.”
  • “Undo the last prompt change.”
  • “Call Sarah and ask whether Tuesday at 2 works for her.”

Muse summarizes prompt and knowledge changes before applying them. Prompt changes are saved to history, so an earlier version can be restored without deleting later history. A call request is authorization to place that specific call; the call’s mission does not alter the saved agent.

4. Server and authentication

  • MCP server: https://auth.botphone.tel/mcp (use the full URL; do not shorten it to the domain)
  • Authentication: API key, sent as Authorization: Bearer <key> (BotPhone also accepts X-API-Key)
  • Keys: create one in the dashboard under Connect your AI assistant. Each key is shown once, only a hash is stored, and you can revoke it any time.

Setup (iPhone, Android, and desktop)

  1. Sign in at auth.botphone.tel/app/setup (or create a free account) and tap Muse.
  2. Copy the message and send it in a Muse chat. Muse shows a Connect button.
  3. Tap Get my Muse key and Copy key. Copy the key last, right before you tap Connect, then paste it in Muse's secure box and tap Add. Never paste the key into the chat itself.

Your key gives Muse access to your line, including placing calls on your credit. If you paste it somewhere it shouldn't be, revoke it in the dashboard and create a new one. Revoking takes effect immediately.

Signing in instead of using a key

Muse can also connect with BotPhone sign-in (OAuth 2.0 with PKCE). When Muse asks for a Client ID, enter 59ca045f-f57c-4f33-bb63-dbcf97a6a0da, then sign in to BotPhone and tap Allow. On iPhone this needs you signed in to Muse at muse.ai in Safari first, which is why we recommend the API key.

The connect prompt is available from the Add to Muse button on the BotPhone for Muse page. Account and phone-line setup are available at auth.botphone.tel/app/setup.

5. Connector tools

  • get_agent_config (Read): The agent’s current prompt, line status, knowledge summary, and most recent change.
  • list_knowledge_sources (Read): Knowledge sources and their crawl or indexing status.
  • get_prompt_history (Read): Recent prompt versions that can be reviewed or restored.
  • list_calls (Read): Recent inbound and outbound calls, newest first, with caller, time, summary, outcome, urgency, and any message left.
  • get_call_details (Read): Full details for one call, including the text transcript.
  • get_account_status (Read): Phone line status, prepaid balance, minutes remaining, launch-offer status, and setup completion.
  • get_top_up_link (Read): A Stripe payment link for adding prepaid calling credit.
  • mark_calls_read (Write): Marks calls as read.
  • update_agent_prompt (Write): Replaces the agent’s main prompt and saves the previous version to history. Muse summarizes the proposed change and asks you to confirm first.
  • add_knowledge_text (Write): Adds approved pasted text to the agent’s knowledge base.
  • add_knowledge_website (Write): Reads one public web page or starts a bounded crawl of a public website.
  • refresh_knowledge_source (Write): Retries or refreshes a website knowledge source.
  • remove_knowledge_source (Write): Removes a source and stops the agent from using it.
  • restore_agent_prompt_revision (Write): Restores an earlier prompt while keeping the complete change history.
  • place_call (Sensitive write): Has the same agent call a real person on your behalf with a temporary mission layered on top of its normal prompt. The call spends your prepaid credit.
  • update_agent_name (Write): Sets the optional agent label shown in summary emails. Changing the prompt clears it.
  • get_receptionist_profile (Read, deprecated): Reads the older receptionist profile settings.
  • update_receptionist_profile (Write, deprecated): Updates the older receptionist profile settings.

Tools act only on the BotPhone account of the person who approved the connection. Knowledge and prompt operations are scoped to that account’s agent.

6. Dashboard and testing

The BotPhone dashboard provides the same core controls for people who prefer a screen: choose a starting preset, edit the main prompt, add or remove knowledge, review prompt history, and restore an earlier version. Saved changes apply to the next call.

You can test the agent from the dashboard without changing its prompt or knowledge. You can also call the assigned BotPhone number to test the real inbound phone experience.

Booking meetings with Calendly

In the dashboard's Calendar card, click Connect Calendly, sign in to Calendly, and click Allow. Turn on the meeting types the agent may book and add a short line on who each one is for. On inbound calls, the agent asks a question or two to pick the right meeting type, offers a few open times, confirms the caller's name and email, and books it. Calendly sends the caller its usual confirmation and invite.

Booking by API requires a paid Calendly plan. On Calendly's free plan, the agent offers to email callers your booking link instead. Calendar setup is in the dashboard only; it is not a connector tool.

7. Access requirements and pricing

  • Regions: BotPhone provides U.S. phone numbers. Outbound calls support U.S. and Canadian destinations.
  • Outbound permission: call only people who expect the call. You are responsible for applicable consent, identification, telemarketing, and do-not-call requirements.
  • Call length: a single call is capped at 10 minutes.
  • Recording: call audio is not recorded. Text transcripts, summaries, and messages are kept while your BotPhone account is active. To delete your account and data, email info@botphone.tel; deletion is completed within 30 days. Deletion excludes logs, backups, and copies held by subprocessors, which are removed on their own schedules.
  • Channels: phone calls today. WhatsApp is coming soon and is not currently supported.
  • Account: a BotPhone account with Google or email sign-in, an active phone line, and prepaid calling credit. Billable calls stop when the balance reaches $0.
  • Launch offer: The first 100 qualifying signups get the $2 setup fee waived, the first month of the number free, and $2 in prepaid account credit. One offer per person, tied to the BotPhone account connected to Muse.
  • Pricing: the $25 monthly plan includes the number and 150 minutes a month, with no setup fee. Plan minutes reset monthly; purchased minutes never expire. Pay as you go is $2 setup, $2 per month for the number, and $0.20 per minute for all inbound and outbound calls. Usage is billed by the second. Minute packs are one-time purchases, and auto top-up is optional. See the Terms.

8. Rate limits

BotPhone does not currently publish fixed request-rate limits for the connector at this time. The connector is intended for interactive use by an individual or small-business owner through Muse. If you need higher-volume access, contact info@botphone.tel.

9. Data and processors

To run the service we use: Twilio (phone numbers and calls), LiveKit Cloud (real-time audio and AI inference), Deepgram (speech to text), Fish Audio (text to speech through LiveKit), Gemma (conversation and call summaries through LiveKit), OpenAI (knowledge-base search embeddings), Supabase (database and sign-in), Render (hosting), Stripe (payments), Resend (email), Google (optional sign-in), and, if you connect it, Calendly (meeting booking during calls).

Call summary emails go to the addresses you set and include the full transcript. If you connect Calendly, callers who book give their name and email, which go to your Calendly account; callers who ask for your booking link get one email with it. The access Calendly grants BotPhone is encrypted before it is stored, and disconnecting revokes it. If you place calls through the BotPhone API with a webhook and ask for transcripts, the transcript is also sent to the webhook URL you choose. Data is encrypted at rest in our database, staff access is limited, and admin actions and transcript views are logged.

10. Compliance and support

You are responsible for the instructions and knowledge you provide, the people you ask the agent to call, and any disclosure or notice requirements that apply to your use. Do not use BotPhone for emergency services or high-risk professional decisions. See our Privacy Policy and Terms. Support: info@botphone.tel.