BotPhone

npx add-mcp 'https://auth.botphone.tel/mcp'

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: 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

Manual Android setup

1. In Muse, open Connectors and choose Add custom connector.
2. For the server URL, enter https://auth.botphone.tel/mcp, including /mcp.
3. When Muse asks for a Client ID, enter 59ca045f-f57c-4f33-bb63-dbcf97a6a0da.
4. Tap Add, sign in to BotPhone, review the permissions, and tap Allow.

This Client ID is public and has no secret. PKCE (S256) secures the sign-in flow. Muse on iPhone handles client registration automatically, so iPhone users do not need to enter it.

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, 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 (Write): Has the same agent call someone on your behalf with a temporary mission layered on top of its normal prompt.

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.

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 retained for 12 months.
• 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.
• Pricing: $2 setup, $2 per month for the number, $0.20 per inbound minute, and $0.10 per outbound minute. Usage is billed by the second. See the Terms.

8. 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 an individual or small-business owner through Muse. If you need higher-volume access, contact info@botphone.tel.

9. 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.