Developer Platform
Connect your agent to Conto and test its first payment in sandbox.
Start with a sandbox agent
npx -y @conto_finance/ create-conto-agent --sandbox --json- 2. Check your setup. Run
npx @conto_finance/create-conto-agent doctorto check scopes and balance. - 3. Make a test payment. Follow the generated example to see a request come back Approved, Blocked, or Needs approval.
Payment request examples
SDK
Request a simulated payment with a sandbox agent SDK key. Save the request ID to check its status.
import { Conto } from '@conto_finance/sdk';const conto = new Conto({ apiKey: process.env.CONTO_API_KEY! });const p = await conto.payments.request({ amount: 1, recipientAddress: '0x0000000000000000000000000000000000000001', purpose: 'Sandbox test', idempotencyKey: 'sandbox-example-001',});console.log(p.requestId, p.status);// Reuse the key for retries. Use a new key for a new payment.REST
Request a simulated payment with a sandbox agent SDK key. Save the request ID. Reuse the idempotency key only for retries.
curl --fail-with-body https://conto.finance/api/sdk/payments/request \ -H "Authorization: Bearer $CONTO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"amount":1,"recipientAddress":"0x0000000000000000000000000000000000000001","purpose":"Sandbox test","idempotencyKey":"sandbox-rest-example-001"}'MCP
Add the server, then your assistant can request a payment. Conto checks it against your policy before anything is sent.
// claude_desktop_config.json{ "mcpServers": { "conto": { "command": "npx", "args": ["@conto_finance/mcp-server"], "env": { "CONTO_API_KEY": "conto_agent_..." }}}}// then ask: "Pay api.exa.ai $10" -> calls payCLI
Create an anonymous sandbox and run a simulated payment. No account, signer, or funds needed.
# run in a new directorymkdir conto-first-paymentcd conto-first-paymentnpx -y @conto_finance/create-conto-agent --sandbox --jsonnode example.mjs --execute# After a timeout, use --status with the saved request ID.Conto Pay
The hosted workspace. Ask the agent to pay, in plain language. Conto decides under the same policies and approvals and keeps the same record, with nothing to deploy.
Pay @exa-api $10 for API usage
Held, checked against your rules, and sent from the agent's hosted wallet only after Conto clears it.
Start with simulated sandbox payments, then test a funded onchain integration before preparing for production.
Ways to integrate agent payments
Add payment requests, spending checks, and approvals to your agent.
OpenAPI reference
Generate a client from the OpenAPI schema.
Machine-readable docs
Let agents find setup instructions through manifests, skills, and Markdown docs.
From sandbox setup to production
Choose an integration path
Pick the surface that matches how your agent runs. Hosted Conto Pay needs nothing deployed.
Create a test environment
Run your agent against the sandbox and check that each test request comes back Approved, Blocked, or Needs approval.
Prepare for production
Test your rules in the sandbox, then configure production access, wallet signing, funding, and policies before using real funds.
Test compute payments with spending limits
Test paid compute requests against a per-call limit and session budget using the SDK.
- Per-call cap: $5
- Session budget: $25
Test before using real funds
Developers can test agent payments without building their own spending controls.