Skip to content
Conto

Developer Platform

Connect your agent to Conto and test its first payment in sandbox.

Start with a sandbox agent

1. Run the guided setup

npx -y @conto_finance/create-conto-agent --sandbox --json
Create a sandbox agent with default spending limits and temporary keys, then run a simulated payment.
  1. 2. Check your setup. Run npx @conto_finance/create-conto-agent doctor to check scopes and balance.
  2. 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 pay

CLI

Create an anonymous sandbox and run a simulated payment. No account, signer, or funds needed.

# run in a new directory
mkdir conto-first-payment
cd conto-first-payment
npx -y @conto_finance/create-conto-agent --sandbox --json
node 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

Step 1

Choose an integration path

Pick the surface that matches how your agent runs. Hosted Conto Pay needs nothing deployed.

Step 2

Create a test environment

Run your agent against the sandbox and check that each test request comes back Approved, Blocked, or Needs approval.

Step 3

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
Run the AI infrastructure demo

Test before using real funds

Developers can test agent payments without building their own spending controls.