vapi-network
Buyer-controlled client for x402 API payments in USDC on Base.
Install / Use
claude mcp add vAPI-Network -- npx -y github:vAPI-Network/vapi-networkIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Finance & AccountingSupported Platforms
Tags
Our assessment of vapi-network
vapi-network scores 91/100 on our quality scale, 23rd of 102 Finance & Accounting skills we index (top 23%).
Its MCP Server is 9.1 KB long, well organised into 10 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
With 5,275 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so vapi-network is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 95/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
vapi-network compared with similar skills
All 4 of these similar skills score higher than vapi-network; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| vapi-network (this skill)by vAPI-Network | 91 | 5.3k | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install vapi-network?
- Run
claude mcp add vAPI-Network -- npx -y github:vAPI-Network/vapi-network. The install tabs above show the steps for each supported agent. - Which AI agents does vapi-network work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is vapi-network safe to use?
- It is Apache-2.0-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is vapi-network still maintained?
- The repository was last updated today, so vapi-network is actively maintained.
Skill content
View source on GitHubvAPI Network
One wallet, every x402 API. vapi-network is the open-source, non-custodial
TypeScript client for discovering and paying x402 services in USDC on Base, from a
terminal, an MCP client or your own code.
vAPI Network builds payment and trust infrastructure for AI agents on Base. Call, Router, Stake and Agents are live on production. Tasks is coming soon. See vapinetwork.ai and the documentation.
vAPI Network is not related to Vapi.ai, the voice AI company.
Quickstart
This README describes client 0.15.0. npm view vapi-network version shows the latest published release.
The client needs Node.js 22 or newer.
npm i -g vapi-network
vapi setup [--no-cloud-backup] # creates or restores the vault, derives main, links it to your owner wallet; safe to rerun
vapi fund # opens the hosted funding page for your address
vapi search "weather" # every catalogue, merged, with provenance
vapi pay <listing-ref> --max 0.02
vapi receipts # one line per paid call: quote, settlement, latency
No install? Prefix any command with npx vapi-network, for example
npx vapi-network setup. (npx vapi cannot work: the bare vapi name on npm
belongs to an unrelated package.)
Back up the recovery phrase only in a terminal; vAPI cannot recover it.
Turn on encrypted cloud backup with vapi backup --cloud; only the owner can approve a restore.
On a server, a container or GitHub Codespaces, read
Linux without a keyring before vapi setup.
An agent can set itself up from the agent skill. Tell it: "Read https://vapinetwork.ai/SKILL.md and follow it to set up vAPI." The same file ships in this package as SKILL.md, with the CLI version it describes in its frontmatter.
Interactive CLI runs check for a newer release at most once a day and cache the result in
~/.vapi/update-check.json. JSON, MCP server, CI and non-TTY runs skip the check. Set
VAPI_NO_UPDATE_CHECK=1 to disable it.
How a payment works
The device vault encrypts your keys on this machine, using an OS-stored device key with optional password protection. vAPI applies your spend caps before signing, sends the payment straight to the service, and writes a local receipt. There is no payment proxy and no server-side signer. vAPI Call takes no fee; providers are paid directly.
Local runs keep keys on this machine; experimental Railway runs require explicit
member-key export. Call and discovery metrics are measured locally and nothing is
uploaded unless you send a report yourself. Every payment identifies this client as
vapi through x402 builder-code; when an API advertises payment-identifier, the
generated id is kept on that receipt.
Three ways to use it
The CLI, the MCP server and the SDK share one vault, one set of spend caps and one
receipt ledger under ~/.vapi/.
Register the MCP server with your agent client, then ask it to "Search vAPI for a weather API":
vapi mcp install <claude-code|claude-desktop|cursor|codex>
Call the same client from TypeScript:
import { createVapiClient } from "vapi-network";
const vapi = await createVapiClient({ account: "researcher" });
const listings = await vapi.call.search("Base DEX volume");
const result = await vapi.call.pay({ id: "base-dex-volume", maxPriceUsd: 0.05 });
console.log(result.body);
The MCP server has no tool that reveals a recovery phrase or a private key, and no tool that creates or retires a listing. The tool list is in docs/mcp.md.
What you can do
| Surface | What it does | Guide | | ------------ | -------------------------------------------------------------------------- | ------------------------------------------------------------ | | Call | Discover, check, publish and pay for x402 APIs. | docs/call.md | | Router | Use vAPI Router for model access and balance. | docs/router.md | | Coding tools | Run Claude Code and Codex on your daily Compute allowance. | docs/code.md | | Tasks | Preview task posting, USDC escrow and delivery; coming soon on production. | docs/tasks.md | | Agents | Run capped local agents with dedicated wallets and profiles. | docs/agents.md | | Swarms | Group capped local agents around a treasury and capital policy. | docs/swarms.md | | MCP | Use namespaced payment tools from an MCP client. | docs/mcp.md | | SDK | Use Call, vAPI Router and local agents behind one wallet-bound API. | docs/sdk.md | | Vault | Manage the owner wallet, device vault, accounts and spend caps. | docs/wallets.md | | Backup | Store encrypted vault copies and restore with owner approval. | docs/backup-and-recovery.md |
Every command, option and exit code is in the CLI reference. Account transfers are in docs/sending.md. Configuration, funding, networks and bug reports are in docs/configuration.md. When something fails, start with docs/troubleshooting.md. The full list of guides is in docs/README.md.
Packages
| Package | Purpose |
| ----------------------- | ----------------------------------------------------------------------- |
| vapi-network | zero-dependency distribution with the vapi binary and defaults |
| @vapi-network/core | x402 protocol, wallet store, spend policy, discovery merge and receipts |
| @vapi-network/sources | vAPI Registry, Coinbase Bazaar, local-file and x402scan source adapters |
| @vapi-network/mcp | stdio MCP server with namespaced payment tools |
| @vapi-network/cli | command parsing and the command implementations behind vapi |
Every npm tarball is bundled and has zero runtime dependencies. The scoped
packages are useful for embedding; most users should start with vapi-network.
All five packages share one version and are released together; each release is
described in CHANGELOG.md.
vAPI Desktop
vAPI Desktop is the macOS app for managing agent wallets and connecting local MCP clients.
The signer process keeps keys on your computer.
Version 0.1.0 is not released yet; signing and notarization are pending. The source is in apps/desktop.
See the desktop release guide for building and signing the app.
Support and community
| You have | Go to |
| ------------------------------------ | --------------------------------------------------------------------------------- |
| A bug in the CLI, MCP server or SDK | Open an issue |
| A question or an idea | GitHub Discussions |
| An account, points or quest question | Discord or Telegram |
| An API you want listed on vAPI Call | vapi publish, described in docs/call.md |
| A vulnerability | security@vapinetwork.ai, described in SECURITY.md |
SUPPORT.md says what to include so a report can be answered in one round.
Contributing
Bug fixes, tests, documentation and discovery sources are welcome. Read CONTRIBUTING.md for the setup, the checks and the sign-off each commit needs, and AGENTS.md for the layout and the invariants a change must keep. Participation is governed by the Code of Conduct.
pnpm install --frozen-lockfile
pnpm check
pnpm build
pnpm pack:check
License
Apache-2.0. See LICENSE.
Related Skills
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
