gatefareio/mcp-serverofficial
A
licenseA
qualityD
maintenanceMarketplace MCP for paid HTTP APIs. Pay per call in USDC on Base via the open x402 standard — non-custodial. 13 tools for discovery, buying, and publishing APIs.
7
39 npm
2
MIT
@vapi-network/mcp
Officialby vAPI-Network
Integrates with Coinbase Bazaar as a discovery source, allowing the client to read and merge public x402 v2 service listings from Coinbase's facilitator catalog.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@vapi-network/mcpsearch for weather APIs and pay the top result"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
vAPI Network
vAPI Network builds payment and trust infrastructure for AI agents on Base, with x402 API payments in USDC.
One wallet, every x402 API. vapi-network is its open-source, non-custodial
TypeScript client for discovering and paying x402 services from a terminal, an
MCP client, or your own code. Your key is generated on your machine, encrypted
under your passphrase, and never leaves it. vAPI applies spend policy before
signing, sends the payment straight to the service, and writes a local receipt.
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.
Call is launching. Router, Stake and Agents are coming soon. Tasks is in preview. See vapinetwork.ai and the documentation.
vAPI Network is not related to Vapi.ai, the voice AI company.
Install
npm i -g vapi-networkNo install? Prefix any command with npx vapi-network, for example
npx vapi-network init. (npx vapi cannot work: the bare vapi name on npm
belongs to an unrelated package.)
Related MCP server: agent-tools-mcp
Quickstart
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, latencyBack 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.
What you can do
Surface | What it does | Guide |
Call | Discover, check, publish and pay for x402 APIs. | |
Router | Use vAPI Router for model access and balance. | |
Tasks | Post, take and deliver vAPI tasks through the task API. | |
Agents | Run capped local agents with dedicated wallets and profiles. | |
Swarms | Group capped local agents around a treasury and capital policy. | |
MCP | Use namespaced payment tools from an MCP client. | |
SDK | Use Call, vAPI Router and local agents behind one wallet-bound API. | |
Vault | Manage the owner wallet, device vault, accounts and spend caps. | |
Backup | Store encrypted vault copies and restore with owner approval. |
Wallets and custody are in docs/wallets.md, and account transfers are in docs/sending.md. Configuration, funding, networks and bug reports are in docs/configuration.md.
The MCP server registers docs.search, docs.read, tasks.search, tasks.show, tasks.post, tasks.propose, tasks.submit, tasks.award, tasks.sign, tasks.fund, tasks.deliver, tasks.release, tasks.refund, tasks.dispute, tasks.counter-evidence, tasks.resolve-unmatched, tasks.message, tasks.thread, tasks.watch, tasks.status, vapi.status, vapi.accounts, vapi.siblings, accounts.add, accounts.caps, accounts.send, auth.link, auth.status, router.models, router.usage, router.chat, router.buy, call.search, call.inspect, call.pay, call.read, swarm.setup, swarm.add, swarm.leave, swarm.fund, swarm.rebalance, swarm.status, swarm.dissolve, wallet.address, wallet.balance, wallet.accounts, wallet.list, wallet.use, wallet.fund, receipts.list, receipts.stats, support.report, swarm.run, swarm.allocate, swarm.delegate, swarm.runs; inputs and results are in docs/mcp.md.
Swarms
Swarms keep a treasury and capped member accounts on this machine. Setup is safe to rerun; the owner approves account links and funds the treasury. A deposit arriving at the treasury after dissolve stays on the treasury account, which is kept on this device.
swarm.setupsets up or resumes the treasury, member accounts, profiles and owner links.swarm.addadds or resumes one member.swarm.leavesweeps one member to the treasury and removes it from the swarm.swarm.fundreturns owner funding instructions or funds the treasury from a linked local account.swarm.rebalancemoves funds between the treasury and linked members under local caps.swarm.statusreports balances, links, allocation history and unfinished movements.swarm.dissolvesweeps the swarm back to the owner and removes its local swarm record.swarm.runruns the lead, which may delegate one level deep using treasury-funded budgets bounded by a per-run draw (default $2.00), or runs every member independently on its own capital.swarm.runacceptsdetach: trueto start in the background, andswarm.runslists a swarm's runs with status.swarm.allocateandswarm.delegateare agent-only operations and are refused outside a swarm run; their optionalrequestIdinput makes retries idempotent.
MCP always declines approval prompts during swarm runs.
CLI commands:
vapi swarm create <name>creates or resumes a local swarm and can fund it after linking.vapi swarm add <name> <role>adds or resumes one member.vapi swarm remove <name> <member>sweeps one member to the treasury and removes it.vapi swarm fund <name> <usd>prints owner funding instructions or funds from a local account.vapi swarm rebalance <name>moves capital toward the swarm's configured targets.vapi swarm status <name>reports balances, links, allocation history and unfinished movements.vapi swarm dissolve <name>sweeps the swarm to the owner and removes its swarm record.vapi swarm run <name> "<task>"runs the lead or every eligible member with per-run budget and treasury-draw limits.vapi swarm run <name> "<task>" --detach [--runtime local]starts the run in the background.vapi swarm runs <name>lists background runs and their status.vapi swarm stop <name> [<runId>|--all] [--confirm-worker-stopped]stops one or all running local processes for the swarm. The confirmation flag clears one stale start only after you verify its worker is gone.vapi agent run <name> "<task>" --detachstarts one agent run in the background.
Deprecated tool aliases
These pre-namespace names still work and each result carries a DEPRECATED: line naming its replacement.
Alias | Use instead |
|
|
|
|
|
|
|
|
CLI reference
Every command accepts --json. Most write one success or error value to stdout.
Task watch and a partially completed scope-signing flow can emit newline-delimited
JSON; delivery emits one result after chain success. See Task commands. Exit codes are
0 for success, 1 for an operational failure, and 2 for invalid usage or
an announced preview-only command.
Solana listings remain searchable. Inspecting or paying one returns
unsupported_network (CLI exit 1); vault payments on Solana arrive in a later release.
Inspect shows the registry’s last observed quote; pay fetches a fresh quote before signing.
Every wallet command takes --account <name>, falls back to VAPI_WALLET, then the default from vapi accounts use; --wallet <name> keeps working for one release.
Task exit codes are 0 ok, 1 error or invalid usage, 2 policy refusal, and 3 approval needed in non-interactive mode. Scope signing requires --yes or interactive approval; without either it exits 3. A policy refusal at exit 2 has JSON ok:false with reason: "policy.perTask" or reason: "policy.perDay". Invalid usage exits 1 with {ok:false,error:{code:"usage_error",message}}. Run vapi task --help for details. Chain operations require a locally trusted escrow factory. Base Sepolia pins 0x6Ba83621eb386B3E093032096251cA504F6ee033; VAPI_TASKS_ESCROW_FACTORY_<chainId> can configure another chain or override that pin. Base Sepolia uses BASE_SEPOLIA_RPC_URL, or https://sepolia.base.org when the variable is unset. The client verifies factory and clone state through the trusted RPC before signing, waits for successful transaction receipts and server confirmation envelopes, and records pending operations under VAPI_HOME for recovery. Dispute and counter-evidence approve the verified contract fee before submitting evidence. Local per-task, daily and approval policies apply to that fee. Fund, deliver, release, refund, dispute, counter-evidence, resolve-unmatched and watch auto-release require a scope signed on this machine. --counterparty only confirms the existing local binding. See task security and recovery.
Posting a task moves no money. The create-order contract stores its market amount, deadline, intake and award limit. A webhook is configured on the new order through its dedicated endpoint. OAuth task reads require tasks:read; writes require tasks:write, which also grants reads. See Task commands.
Command | Options | What it does |
|
| Creates |
|
| Creates or restores the vault, links the first account, and can offer cloud backup. Safe to rerun. |
|
| Lists local accounts and can add the owner's accounts on other devices as read-only rows |
|
| Derives and links a new account |
|
| Imports an account from a private-key prompt or local keystore |
|
| Renames an account and its local records |
|
| Sets the default account |
|
| Moves an account to |
|
| Restores an account from |
|
| Sets the account's spend caps and automatic Base USDC ceiling |
|
| Splits USDC across linked local accounts and records resumable legs |
|
| Continues an unfinished distribution; unsafe restored or legacy address replacement requires its terminal-only review flag |
|
| Cancels eligible legs without signing; restored legs require terminal-only review and signed legs require proven expiry |
|
| Creates or resumes a treasury, member accounts, profiles and owner links |
|
| Adds or resumes one member |
|
| Sweeps a member to the treasury and removes it from the swarm |
|
| Prints owner funding instructions or funds the treasury from a local account |
|
| Moves funds between the treasury and linked members under local caps |
|
| Reports balances, links, allocation history and unfinished movements |
|
| Sweeps the swarm back to the owner and removes its local swarm record |
|
| Sends USDC to the owner or another active account; vAPI pays gas |
| - | Name, address, default marker, caps in USD, unlocked, label |
|
| A new wallet, with its own phrase, caps and passphrase |
| - | Makes it the default for every later command |
| - | Renames the keystore, the registry entry and that wallet's receipts |
|
| Moves the keystore to |
| - | Brings a removed wallet back, same passphrase |
|
| Sets that wallet's spend caps, in US dollars |
|
| Prints and opens the hosted funding page. Makes no network call. |
|
| Asks the public vAPI documentation assistant and prints its answer and sources; no wallet or payment |
|
| Searches the vAPI documentation and prints matching excerpts; no wallet or payment |
|
| Reads one vAPI documentation page as Markdown; no wallet or payment |
|
| One deposit account per configured network, with balances and guidance |
|
| Merged discovery across every configured source, tagged by group and tier |
|
| Verification, fee, liveness, conformance, identity, contract and registry’s last observed quote, for free |
|
| Calls the API and pays it from the local wallet, naming an unverified tier |
| - | Checks settlement, shows its payment id, and never pays |
|
| Grades its 402, extensions and same-origin discovery. Never pays |
|
| The wallet's address and USDC balances |
|
| The local append-only call ledger, newest last |
|
| Raw receipts for a spreadsheet or dashboard |
|
| Spend, outcomes, latency percentiles and top services |
|
| Moves USDC to an address, or to the linked owner when omitted; open movement legs block it |
|
| Creates a capped local agent wallet, profile and owner link; |
|
| Runs the named agent on this machine with an optional hard budget across Call and Router top-ups |
| None | Lists profiles, links and today's Call and Router budgets |
| None | Prints the agent's spend policy, caps and tools |
| None | Stops future runs until the agent is resumed |
| None | Allows a paused agent to run again |
| None | Revokes the link and removes the profile, but keeps its wallet |
|
| Links the local agent wallet to your vAPI account |
|
| Removes the selected wallet's agent link and stored credentials |
|
| Shows the chosen wallet's owner link and permissions, whether the link is live, and its ERC-8004 agent identity. |
|
| Lists the vAPI Router model ids |
|
| Shows the agent's Compute allowance and Router balance |
|
| Sends one chat request through vAPI Router |
|
| Prints a gated Router key or rotates it without printing it |
|
| Buys vAPI Router balance with USDC from your wallet |
|
| Sets or clears automatic vAPI Router balance refill |
|
| Shows the linked owner's stake and Compute today |
|
| Prints and optionally opens the staking page |
|
| Finds public tasks and filters the returned page. |
|
| Shows the acting party's task or a public card and prints settled escrow receipts |
|
| Posts a title and brief; reports settings the current contract cannot store; moves no money |
|
| Signs proposal terms locally and offers to take a task |
|
| Uploads files and signs bounty proof. Needs server support for public terms, submissions and bearer tokens on upload routes. |
|
| Awards a proposal or submission. Moves no money. Needs server support for bearer tokens on participant routes. |
|
| Signs the agreed scope locally. A worker creates the unfunded escrow with the local vault wallet. |
|
| Applies local spend policy and funds escrow with the local vault wallet. |
|
| Prepares a delivery manifest from 1 to 20 files and records delivery onchain. |
|
| Releases escrow to the worker with the local vault wallet. |
|
| Returns escrow to the poster with the local vault wallet. |
|
| Applies spend policy, approves the verified fee and raises a dispute. |
|
| Pays the verified fee and submits counter-evidence before the deadline. |
|
| Resolves an unanswered dispute after the onchain deadline. |
|
| Sends a task message. Needs server support for bearer tokens on participant routes. |
|
| Reads task messages. The cursor is nextBeforeSeq for an older page. Needs server support for bearer tokens on participant routes. |
|
| Watches task events. Auto-release signs with the selected local vault wallet. |
|
| Shows chain state and participant events when signed in, or the public task card. |
|
| Prints the private key. Terminal only, never for an agent. |
|
| Prints the 12 words, or turns encrypted cloud backup on or off. |
|
| Rebuilds the vault from a recovery phrase typed at the prompt or piped on stdin, or restores an owner-approved cloud backup. |
|
| Restores a wallet from a prompt, never from argv |
|
| Re-encrypts the keystore under a new passphrase |
|
| Adds a password to the device vault |
|
| Removes the password from the device vault |
|
| Closes the protected vault on this device |
|
| Opens the protected vault for 8 hours, or set |
|
| Shows whether the device vault is protected and open |
|
| Puts that wallet's passphrase in the OS secret store |
|
| Takes a stored passphrase back out |
|
| Writes a privacy-preserving local bug report |
| - | Types the registry API key on a prompt into the OS secret store |
| - | Whether this machine has a key and where it comes from, masked |
| - | Takes the stored key back out |
|
| Probes your API, lists the endpoints you pick, signs the payout wallet |
| - | Takes a listing live once its FeeSplitter is deployed |
| - | Asks vAPI to review the listing |
| - | Every listing this API key owns |
|
| Takes over the listings vAPI indexed from your API, signed by their payee |
|
| Serves the MCP tools over stdio |
|
| Writes that app's MCP config and prints the file |
| - | Preview only; exits |
| - | The client version, also as |
| - | The same help bare |
Phrase recovery checks Base USDC balances until five consecutive addresses are empty and reports the number scanned. vapi restore --accounts <n> (or vapi setup --accounts <n> when restoring) derives a fixed count without balance queries.
Packages
Package | Purpose |
| zero-dependency distribution with the |
| x402 protocol, wallet store, spend policy, discovery merge and receipts |
| vAPI Registry, Coinbase Bazaar, local-file and x402scan source adapters |
| stdio MCP server with namespaced payment tools |
| command parsing and the command implementations behind |
Every npm tarball is bundled and has zero runtime dependencies. The scoped
packages are useful for embedding; most users should start with vapi-network.
Development
A pnpm workspace for Node.js 22 and pnpm 10. The gate, in order:
pnpm install
pnpm format:check
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm pack:checkAll five packages share one version and are released together. npm reads a
package manifest before lifecycle hooks run, so the release is made from the
generated publish/ directories, never from the workspace package roots.
pnpm install --frozen-lockfile
pnpm pack:check
npm login
pnpm --dir packages/core publish:npm
pnpm --dir packages/sources publish:npm
pnpm --dir packages/mcp publish:npm
pnpm --dir packages/cli publish:npm
pnpm --dir packages/vapi-network publish:npmpublish:npm publishes a package's staged ./publish directory to the latest
npm tag; publish:npm:next publishes the same tarball to next. The manual
release workflow verifies artifacts and prints these commands; it never receives
npm credentials and never publishes.
See AGENTS.md for layout and invariants, CONTRIBUTING.md for the workflow, CHANGELOG.md for what shipped in each release, and SECURITY.md for private vulnerability reports.
License
Apache-2.0. See LICENSE.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Discover machine-payable APIs, probe x402 payment terms, and run seller operations. Non-custodial.
Metered MCP tools: free discovery over MCP; per-call execution settled in USDC via x402 v2.
Pay for APIs with USDC. Read-only x402 payment discovery, verification, evidence, and status.
Agent-native MCP for governed commerce, x402 payments, paid capabilities, and verifiable receipts.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible agents to discover and call x402 paid services from a directory of over 2,000 APIs.Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for the x402 protocol that lets AI agents discover and call payment-gated HTTP APIs automatically.144 npmApache 2.0
- AlicenseNot gradedqualityCmaintenanceAn MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.441 npm1MIT