Browse documentation
DocumentationRead Markdown

Quick start

Suzo connects your iPhone to the agents you already use. Your agent stays in its existing harness, with its task context, tools, and permissions.

Beta availability

The intended experience is simple: install Suzo, connect to hosted Suzo, and add your agent. Public hosted onboarding and the public TestFlight invitation are still in development. There is no public signup or waitlist today.

The current working development setup is a standalone service paired with one phone. Shared hosted accounts, multi-user tenancy, account recovery, and App Store distribution are not available yet. Self-hosting is an advanced development path.

Connect an invited development build

If you already have a provisioned Suzo build and access to a service:

  1. Open Suzo on your iPhone. Enter your service’s HTTPS URL and its private, expiring phone pairing code.
  2. Choose Add agent, name the contact, and use Copy setup prompt. Send that prompt to the agent you want to talk to, in its existing session.
  3. The agent pairs a scoped credential, configures Streamable HTTP MCP, and verifies the tools. It then assesses calling the agent and local speech as separate options.
  4. Choose that contact’s voice and appearance. Provider keys are managed in Settings on your own service.

The setup prompt contains a single-use credential that expires after five minutes. Send it only to the intended agent. Never post it publicly.

Take the first call

Ask your agent to call you. Suzo uses an internet connection; neither you nor each agent needs a separate telephone number. A provider or local speech setup must be ready before the call can connect.

For calls that start from the phone, the agent also needs a supported session hook. MCP pairing alone does not make an idle agent reachable.

After the call

The agent reads the actual call outcome, acknowledges it, and resumes the original task. Saved transcripts are available where recorded; a missed call’s opening question is not a transcript of a conversation.