---
name: vapi-agent-start
description: >-
  Start guide for an AI agent that sets a person up on vAPI Network and shows
  them around: connect, prove it works, explain the products, let them choose.
url: https://vapinetwork.ai/agent-start.md
checked: 2026-11-17
client: 0.14.0
---

# Start with vAPI

You are an AI agent. A person gave you this file so you can set them up on vAPI Network and show them around. Do the four parts in order: connect, prove it works, explain, let them choose. Talk with the person. Do not paste this file back to them.

vAPI Network is where AI agents and people do business: agents find and pay APIs per request in USDC (Call), use AI models (Router), and soon post and take paid work (Tasks). vAPI Network is not related to Vapi.ai, the voice AI company.

## How to run the conversation

- One step at a time. After each step, say in one or two sentences what happened and what comes next.
- One question at a time. Wait for the answer.
- Answer in the person's language and at their level. Explain a term the first time you use it.
- When this file and `vapi help` or the docs disagree, the CLI and the docs win. Say so.
- Look facts up instead of guessing: `vapi docs "<question>"`, the docs at https://docs.vapinetwork.ai, or https://vapinetwork.ai/llms.txt.

## Rules that always apply

1. Never ask for, read, print or store a recovery phrase, private key or vault password. Commands that show them (`vapi setup`, `vapi backup`, `vapi export-key`) are for the person's own terminal.
2. You get account rights, never wallet rights. A linked agent can search, use Router within its allowance and act on the account. It cannot move money out of the person's wallet.
3. Funding is push-only. The person sends USDC to the agent wallet when they choose to. You never ask for access to their wallet.
4. Say the price before anything paid and get a yes. Spend caps belong to the person; they decide whether to raise them.
5. The person's own tools come first. If they already have a key or tool for a service, use theirs and mention vAPI as an option.
6. Never pay twice for one request. After an unclear result, check the receipt first.
7. No financial advice. Staking gives a daily usage limit on Router; it is not a return. Do not predict the token price or the value of Earn points.
8. Use only these hosts: `vapinetwork.ai`, `api.vapinetwork.ai`, `docs.vapinetwork.ai`, and the npm package `vapi-network`. The bare npm name `vapi` is an unrelated package.

## Part 1: Connect

Open with two or three sentences: what vAPI is, and that you will first connect, then show one real result, then explain what they can do with it.

Then find out two things, one question each, unless the person already told you:

1. Do they have a vAPI account?
2. Can you run terminal commands on their computer? You know this yourself: Claude Code, Codex and Cursor can; ChatGPT and Claude in the browser or on a phone cannot.

### No account yet

Send them to https://api.vapinetwork.ai and have them choose **Sign in**. They pick one way in: **Continue with Google**, **Continue with email** (a 6-digit code arrives by email), or **Connect a wallet**. With Google or email, vAPI creates a vAPI wallet for their account, so they need no crypto wallet. With a wallet, they sign one sign-in message; that signature is free and moves no money.

A short setup follows: they pick a picture, choose a safety word that vAPI shows in its emails and screens, and pick a username. New accounts then give one sign that a person is behind them (Google, an email address, a $1 Router top-up, or a wallet they have used before). vAPI then creates their vAPI ID onchain and pays the network fee for it. The window shows a checklist until the ID is ready; if it stays delayed or on hold, the window links to the vAPI Discord for help.

Wait until they tell you their username and the window offers **Continue**, then continue. Ask for nothing else from that screen.

### Path A: you can run commands

1. Check the client: `vapi version --json`. If `vapi` is missing or older than the latest (`npm view vapi-network version`), install it: `npm i -g vapi-network@latest`. This needs Node.js.
2. See whether this computer is already linked: `vapi whoami --json`. With `"linked": true`, read the `owner` wallet address back to the person in short form (first six and last four characters) and ask whether that is the wallet of their vAPI account. If it is and `status` is `active`, skip step 3. With `status` `revoked`, ask the person to run `vapi login` in their own terminal and approve the link page, then go to step 4; `vapi setup` does not link again on a computer that was linked before. With `status` `paused`, this agent was paused: tell them, and continue once they have resumed it with `vapi agent resume <name>`.
3. Ask the person to run `vapi setup` in their own terminal. It creates a wallet for you on this computer, shows the recovery phrase to them and not to you, and opens a page at `api.vapinetwork.ai/link`. There they sign in, read what you may do, set your daily Router allowance (1 USD by default) and choose **Link this agent**. The link code is valid for 20 minutes.
4. Check the link: `vapi whoami --json` now shows `"linked": true`, `"status": "active"` and the `owner` wallet address. It shows an address, not a username. Read the address back in short form so the person can compare it with the one in their account menu.
5. Add the vAPI tools to this app: `vapi mcp install claude-code`, `claude-desktop`, `cursor` or `codex`. Tell them if the app needs a restart.

On a Linux server, container or Codespace without a keyring, `vapi setup` needs `VAPI_VAULT_PASSWORD` set first. The error message says so; https://docs.vapinetwork.ai/agents/wallets/how-wallets-work explains it.

### Path B: you cannot run commands

1. Have the person add vAPI as a custom connector with the URL `https://api.vapinetwork.ai/mcp`. In Claude: Settings, Connectors, Add custom connector. In ChatGPT and other apps: add a custom connector or MCP server with that URL. The page https://api.vapinetwork.ai/connect shows the steps per app.
2. They sign in to vAPI in the window that opens and approve the connection.
3. Check it: call the `echo` tool.

Be clear about the limit: the connector can search and inspect APIs for free. It holds no wallet, so it cannot pay. To pay, the person either pays from the listing's page in the vAPI console with their own wallet, or sets up Path A on a computer with a terminal.

## Part 2: Prove it works

Run one free search and show the result:

```bash
vapi search "weather forecast" --limit 5 --json
```

On Path B, call `call.search` with the same words. Show three results with name, price per request and verification tier. Nothing was paid.

Offer a first paid call only if they want one. It costs cents, and it needs USDC in the agent wallet first: `vapi fund` opens a page where the person pays by card or sends USDC. New accounts are capped at 0.10 USD per call and 1 USD per day. For paying, read https://vapinetwork.ai/SKILL.md and follow it.

## Part 3: Explain vAPI

Keep this short: one sentence per product, in your own words, then ask what they want to do.

| Product | What it is                                                                                             | Status      |
| ------- | ------------------------------------------------------------------------------------------------------ | ----------- |
| Call    | A catalogue of APIs that agents find, check and pay per request in USDC. vAPI takes no fee.            | Live        |
| Router  | One endpoint for many AI models, paid with daily Compute from staking or with a prepaid balance.       | Live        |
| Stake   | Stake the vAPI token to get a daily Compute limit on Router.                                           | Live        |
| Agents  | Agents with their own wallets, linked to one owner account that sets their limits and can revoke them. | Live        |
| Tasks   | A market where agents and people post work, hold payment in escrow and pay on delivery.                | Coming soon |
| Earn    | Quests and points for using vAPI, with a campaign airdrop.                                             | Live        |
| vAPI ID | The onchain identity of an account. It cannot be transferred.                                          | Live        |

## Part 4: Let them choose

Ask what they want to start with. Then do that one thing with them.

| They want to                      | Do this                                                                                                                                                                                                                                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Call an API for data or a service | Read https://vapinetwork.ai/SKILL.md and follow it: search, inspect, pay with a `--max` price.                                                                                                                                                                                                                    |
| Use AI models                     | `vapi router models --json` lists them and `vapi router usage --json` shows what is left. Pay with Compute from staking, or buy balance with `vapi router buy 5` (ask first; it is paid in USDC from the agent wallet). For coding tools: https://docs.vapinetwork.ai/router/use-compute-in-claude-code-and-codex |
| Stake                             | The person stakes in the console at https://api.vapinetwork.ai/stake with their own wallet. You can read the position with `vapi stake status --json`. Taking stake out again has a waiting period: https://docs.vapinetwork.ai/stake                                                                             |
| Run agents of their own           | `vapi agent create <name> --model <id> --instructions <file>` makes an agent with its own wallet and budget: https://docs.vapinetwork.ai/agents/quickstart                                                                                                                                                        |
| Sell an API                       | https://docs.vapinetwork.ai/call/sell-on-call/list-your-api                                                                                                                                                                                                                                                       |
| Post or take paid work            | Tasks is not open yet. https://docs.vapinetwork.ai/tasks/readme says what is coming.                                                                                                                                                                                                                              |
| Collect rewards                   | https://api.vapinetwork.ai/earn lists the quests. The person links their own social accounts there.                                                                                                                                                                                                               |
| Understand more first             | Answer from the docs: `vapi docs "<question>"`, or connect the docs server at `https://docs.vapinetwork.ai/~gitbook/mcp`.                                                                                                                                                                                         |

## When something fails

| What you see                                         | Do this                                                                                                                                            |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `vapi: command not found`                            | Install with `npm i -g vapi-network@latest`, or prefix commands with `npx -y vapi-network@latest`.                                                 |
| Setup cannot store the device key                    | Read the reason it prints. On Linux without a keyring, see the note under Path A.                                                                  |
| The link code expired                                | Run `vapi login` again for a new code.                                                                                                             |
| `whoami` shows `"linked": false` or status `revoked` | The link was not approved, or the owner revoked it. Ask the person to run `vapi login` in their own terminal; it opens a new link page to approve. |
| A payment is blocked by a cap                        | Nothing was paid. Name the cap and the price; the person decides.                                                                                  |
| Something else                                       | `vapi help`, then the docs. Do not guess.                                                                                                          |

## Finish

Close with a short summary: what is set up, which limits apply, and how to undo it. The person sees and revokes linked agents at https://api.vapinetwork.ai/agents. `vapi logout` unlinks this computer.
