Back to BotPhone for Muse

BotPhone for Muse beta

Connector Docs

BotPhone for Muse is an inbound AI receptionist that gives your Muse a business phone number. This page covers the MCP connector and its access requirements.

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

1. What the connector does

BotPhone answers calls to a business phone number for a U.S. small business. The MCP connector lets Muse read what happened on those calls and adjust what the receptionist tells callers. Outbound calls, when enabled, are placed by BotPhone voice agents, not by Muse.

2. Server and authentication

  • MCP server: https://auth.botphone.tel/mcp
  • Authentication: OAuth 2.0 authorization code flow with PKCE, no client secret, dynamic client registration
  • Authorization endpoint: https://auth.botphone.tel/oauth/authorize
  • Token endpoint: https://auth.botphone.tel/oauth/token (auth method: none)
  • Registration endpoint: https://auth.botphone.tel/oauth/register
  • Scopes: openid email profile

The connect prompt is available from the Add to Muse button on the BotPhone for Muse page. Full setup notes are at auth.botphone.tel/docs.

3. Tools

  • list_calls (Read): Recent calls the receptionist answered, newest first, with caller, time, summary, reason, urgency, and any message left.
  • get_call_details (Read): Full details for one call, including the text transcript.
  • get_receptionist_profile (Read): The receptionist’s current configuration.
  • get_account_status (Read): Line status, prepaid balance, and setup completion.
  • get_top_up_link (Read): A Stripe payment link for adding calling credit.
  • mark_calls_read (Write): Marks calls as read.
  • update_receptionist_profile (Write): Changes what the receptionist tells callers. Muse asks you to confirm before the change is applied.
  • place_call (Write): Has the receptionist phone someone on your behalf, using your BotPhone number, only when you ask.

Tools act only on the account of the person who approved the connection.

4. Access requirements

  • Regions: U.S. only. Phone numbers are U.S. numbers for U.S. small businesses.
  • Direction: inbound calls, plus approved outbound calls placed by the BotPhone voice agent when you ask, to U.S. and Canadian numbers of people who expect them. Outbound use must follow 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 retained for 12 months.
  • Channels: phone calls today. WhatsApp is coming soon and is not currently supported.
  • Account: a BotPhone account with a Google sign-in, and prepaid calling credit. When the balance reaches $0, the receptionist stops handling billable calls.
  • Pricing: $2 setup, $2 per month for the number, and $0.20 per inbound minute. See the Terms.

5. Rate limits

BotPhone does not currently publish fixed request-rate limits for the connector during the beta. The connector is intended for interactive use by a single business owner through Muse. If you need higher-volume access, contact info@botphone.tel.

6. Compliance and support

Businesses remain responsible for AI-disclosure and notice requirements that apply to calls they receive. See our Privacy Policy for how data is handled. Support: info@botphone.tel.