V2.4.0 NOW STABLE

Build Agents
That Pay.

Integrate Vouch SDK in 5 minutes. Add secure identity, programmable mandates, and x402 payments to any AI agent.

setup.js
import { VouchClient } from '@vouch/sdk';

// Initialize the trust layer
const agent = new VouchClient({
apiKey: process.env.VOUCH_API_KEY,
mandate: {
maxSpend: 5.00,
currency: 'USDC',
domain: '*.amazon.com'
}
});

Quickstart

Get up and running in under 5 minutes with our guide.

API Reference

Complete technical specs for all Vouch endpoints.

MCP Integration

Model Context Protocol setup for Claude & GPT.

Examples

Copy-paste templates for commerce agents.

Quickstart Guide

1

Install the SDK

The Vouch SDK is available via npm, yarn, or bun. It includes all the necessary types for TypeScript development.

TERMINAL
$ npm install @vouch/sdk
2

Initialize Your Agent

Instantiate the client with your credentials and set the global mandate for your agent. These policies are enforced at the protocol level.

INDEX.JS
const client = new VouchClient({
apiKey: 'vc_live_...',
mandate: {
maxSpend: 5.00,
currency: 'USDC'
}
});
3

Make Your First Payment

Vouch handles the complexity of the x402 handshake. Simply provide the invoice URL and the SDK takes care of the rest.

PAYMENT.JS
const receipt = await client.pay({
invoice: 'https://api.merchant.com/pay/123',
amount: 2.50
});

console.log('TX Success:', receipt.hash);

Tools Reference

Available MCP and SDK tools for agent interaction.

Tool NameDescriptionParametersResponse
request_mandateRequest spending limit from useramount reasonmandate_token
verify_identityPresent agent's Vouch Passportmerchant_idpassport_proof
execute_x402_paymentPay invoice via HTTP 402invoice_url amounttx_hash
check_reputationGet agent's trust scoreagent_idscore, history

The x402 Handshake Flow

Vouch standardizes the way agents handle "Payment Required" responses from merchants.

Agent

Makes HTTP Request

Merchant

Returns 402 Header

Vouch Node

Settles USDC on Base

Non-Custodial

Private keys stay in your environment via AgentKit. We never hold your funds, we only authorize the transaction flow.

Machine-Readable Docs

Our specialized llms.txt file ensures your agents can read our documentation and debug their own integrations autonomously.

Production-Ready

Built-in audit logging, compliance tracking, and anti-looping logic designed for enterprise agent deployments.

BASE SEPOLIA TESTNET

Vouch Sandbox

Simulate an x402 handshake. Monitor how your agent interacts with a restricted domain in a safe, cost-free environment.

Zero-cost simulations
Real-time webhook inspection
Policy violation testing
// Simulation Log
[SYSTEM]Booting Sandbox Agent...
[AGENT]Target: bookstore.test/buy
[HTTP]GET /checkout -> 402 Payment Required
[VOUCH]Intercepting request. Checking Mandate...
[VOUCH]Mandate valid. Settling 1.20 USDC on Base...
[AGENT]Retrying request with Vouch-Proof header...
[SUCCESS]Order confirmed. TX: 0x4f...a12

Ready to Build?

Join 2,500+ developers building the future of autonomous agentic commerce.