# DialValet documentation

Give your AI agent a phone (verified caller ID). You ask for a specific call; it
places one real outbound U.S. call showing a number you verified; you get a short
outcome when it ends. Private beta, U.S. only, prepaid.

## Five-minute setup

1. Install `@dialvalet/cli`: `npm install --global @dialvalet/cli`
2. Sign up with a U.S. phone one-time code.
3. Verify the caller ID recipients will see (a second code).
4. Add prepaid credit ($5–$100 checkout). Wait until payment settles. Optional
   for a first call: verifying the caller ID adds a free $1.00 credit.
5. Place one explicit call with `--confirm`.

First call free: $1.00 credit (about 6 minutes) once your caller ID number is
verified, one per number.

Walkthrough: [Quickstart](QUICKSTART.md). Agents: start at
[https://dialvalet.com/llms.txt](https://dialvalet.com/llms.txt).

## For people

1. [Quickstart](QUICKSTART.md) — five-minute path, MCP snippets, and trust rules.
2. [CLI reference](CLI.md) — install `@dialvalet/cli` and run every command.
3. [Terms of Service](https://dialvalet.com/terms) and
   [Privacy Policy](https://dialvalet.com/privacy).

## For agents and developers

1. [Agent map](https://dialvalet.com/llms.txt) — the short version, start here.
2. [Expanded agent brief](https://dialvalet.com/llms-full.txt) — fuller detail.
3. [REST and MCP reference](API.md) — endpoints, scopes, tools, and errors.
4. [OpenAPI contract](https://dialvalet.com/openapi.yaml) — machine-readable schema.

## Trust and acceptable use

- Verified personal caller ID proves you control the from-number. It is **not**
  consent from the person you call.
- Not a dialer: no telemarketing, campaigns, bulk dialing, or call-center use.
  One-to-one, user-directed calls only.
- U.S. numbers and U.S. destinations only.
- Prepaid credit only. No subscription, no automatic reload. The free first call
  credit is one per number.
- Dedicated DialValet numbers and inbound forwarding are not available.
- Private beta. Do not assume recordings or international calling.
- You are responsible for providing every disclosure required by applicable law.

Full rules: [Terms — acceptable use](https://dialvalet.com/terms#acceptable-use).

## What it costs

- $0.15 per started connected minute, as ceil(connected_seconds / 60). A 20-second
  answered call is one minute. A 61-second call is two.
- If nobody answers, there is no talk-time charge.
- Credit is prepaid through Stripe Checkout, $5 to $100 at a time. No
  subscription, no automatic reload, and no card charge per call.
- First call free: $1.00 credit (about 6 minutes) once your caller ID number is
  verified, one per number.
- Using a number you already own costs nothing.

## What it does and does not do

Available now: phone sign-in, caller-ID verification, prepaid credit, outbound
U.S. calls from a verified number, GPT-Live voice selection (account default or
per call), live transcript while a call runs, plain-text guidance requests,
live steering corrections, an optional structured result afterward, and an
optional handoff that rings you from +1 480-480-1077 when the call is placed
with `--allow-transfer` (API/MCP: `allow_user_transfer: true`).
Portuguese voices speak Brazilian Portuguese.

Not available: audio recordings, dedicated DialValet phone numbers, inbound call
forwarding, and non-U.S. numbers or destinations.

## Limits and retention

- Default account limits are 5 calls per day, 1 call at a time, and 20 minutes
  maximum per call. Without an explicit maximum duration, a call defaults to the
  longest the available balance covers.
- Calls are not recorded. When a structured result is produced it is encrypted and
  kept up to 30 days, may include speaker-labeled transcript turns, and you can
  delete it sooner from the dashboard or the API.
- DialValet does not inject a fixed opening disclosure. The user or connected
  agent must include any identity, AI/artificial-voice, purpose, callback-number,
  recording, or opt-out notice required for the particular call.
- Call objectives and optional context are screened for prohibited or harmful use
  before dialing. Routine personal and customer-service calls, including benign
  jokes between friends, are allowed when they do not involve fraud, harassment,
  credentials, harm, illegal activity, or another prohibited use.

Questions: [contact@dialvalet.com](mailto:contact@dialvalet.com)