SDK Installation
The Conto SDK provides two clients:Contofor agent-scoped payment and read operationsContoAdminfor organization-scoped provisioning and management
Installation
Packages
Requirements
- Node.js 20.19.0+ or Bun
- TypeScript 4.7+ (optional but recommended)
Choose Your Client First
UseConto with an agent SDK key (conto_agent_..., stored as CONTO_API_KEY) for payment
operations and agent-scoped reads, including the MCP server. Use ContoAdmin with an organization
API key (conto_..., stored as CONTO_ORG_API_KEY) to provision agents, wallets, policies, or
memberships from your backend. For the full credential selection guide, including admin SDK keys,
see Choose the Right Credential.
Basic Agent Setup
Organization Setup with ContoAdmin
Configuration Options
The SDK retries transient failures only for read-only calls and idempotency-protected payment
authorization. Financial execution and other non-idempotent writes are never retried
automatically. See Retry Strategy for the exact behavior.
Full Configuration Example
Environment Variables
We recommend using environment variables for configuration:.env
apiKey for Conto, orgApiKey for ContoAdmin.
TypeScript Support
The SDK is written in TypeScript and includes full type definitions:Framework Integration
Next.js
Express
Serverless (AWS Lambda)
Verifying Installation
Verify connectivity with a read-only call.GET /api/sdk/setup returns your agent, wallets, and granted scopes without creating any payment record:
Next Steps
Authentication
Learn about SDK authentication
Admin SDK
Provision agents and wallets with org API keys
Payments
Make your first payment