Conto

Build with Conto

Add policy-checked payments to your agent with the SDK, MCP server, CLI, installable skills, OpenAPI, and machine-readable discovery surfaces.

Run CLI QuickstartBrowse OpenAPI
Explore product controls

Make your first policy-checked payment in about 10 minutes.

Start on Tempo Testnet, fund with free pathUSD, and test the same authorization, policy, and execution flow your production agent will use.

Open setup guideAgent sandbox guideTry sandbox

Terminal

npx @conto_finance/create-conto-agent
Bootstraps an agent, wallet, policy, and SDK key in one guided run.

Make the first controlled payment

Create a testnet agent, verify its wallet and scopes, then execute a small payment through Conto's policy engine.

Bootstrap a sandbox agent

The CLI creates an agent, testnet wallet, policy, SDK key, and local config in one guided run.

npx @conto_finance/create-conto-agent

Verify setup

Check auth, key scopes, wallet custody, chain, balance, and policy assignments before moving money.

npx conto doctor

Request and execute

Run the same request -> execute flow you will use in production, but against a funded Tempo Testnet wallet.

npx tsx example.ts --execute

Pick an integration path

Start with the surface that matches how your agent runtime already works.

Agent Sandbox Quickstart

Let an autonomous agent create a test-mode organization, agent, wallet, SDK key, and sandbox API key without human signup.

curl -X POST https://conto.finance/api/agents/sandbox

TypeScript SDK

Use `@conto_finance/sdk` when you own the runtime and want typed payment, policy, and bootstrap flows.

npm install @conto_finance/sdk

MCP Server

Connect Claude and other MCP-compatible clients to Conto for payments, trust, alerts, and analytics.

npx @conto_finance/mcp-server

CLI Quickstart

Provision an agent, wallet, default policy, and SDK key in one guided flow.

npx @conto_finance/create-conto-agent

Agent Skills

Install Conto into OpenClaw or Hermes when your agent already has a wallet stack and tool runner.

hermes skills install well-known:https://conto.finance/.well-known/skills/conto

See the first payment in every surface

The same policy-checked request and execute flow across the SDK, REST, MCP, CLI, and hosted Conto Pay.

SDK

You own the runtime

Typed TypeScript helpers for request, approve, and execute.

import { Conto } from '@conto_finance/sdk';
 
const conto = new Conto({ apiKey });
const p = await conto.payments.request({
  amount: 10, recipientAddress: '0x...', purpose: 'API usage',
});
// approved? execute it
if (p.status === 'APPROVED') await conto.payments.execute(p.requestId);

REST

Any language

One POST, bearer auth. Same policy check behind it.

curl -X POST https://conto.finance/api/sdk/payments/request \
  -H "Authorization: Bearer $CONTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":10,"recipientAddress":"0x...","purpose":"API usage"}'

MCP

Assistants & operators

Add the server, then your assistant can pay within policy.

// 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

Terminal quickstart

Bootstrap an agent, wallet, policy, and key, then pay.

# agent + wallet + policy + key, one guided run
npx @conto_finance/create-conto-agent
# verify scopes, custody, and balance
npx conto doctor
# first policy-checked payment
npx tsx example.ts --execute

Conto Pay

No code, hosted

The hosted workspace. Ask the agent to pay, in plain language. The same policies, approvals, and record apply, with nothing to deploy.

Pay @exa-api $10 for API usage

Staged, policy-checked, and sent from your hosted wallet.

Five surfaces, one policy engine. Start sandboxed on Tempo Testnet, then promote the same controls to production.

Match Conto to your runtime

Use the deployment pattern that fits your signer, operator workflow, or generated client.

Custom Runtime

Prefer the SDK or REST API when you control the agent loop.

Operator Assistant

Prefer MCP when humans and assistants share the same control plane.

External Wallet

Use approve -> transfer -> confirm when your signer lives outside Conto.

Generated Clients

Use OpenAPI plus `/api-docs` when you want contract-driven integrations.

Machine-readable discovery

Endpoints agents can read directly, no scraping required.

Agent Sandbox Quickstart

Copy-paste discovery, signup, setup, approval, confirmation, and claim guide for autonomous agents.

/docs/quickstart/agent-sandbox

Sandbox Signup

Anonymous test-mode signup endpoint that creates an agent, wallet, SDK key, and sandbox API key.

/api/agents/sandbox

Agent Manifest

Single machine-readable entrypoint for docs, packages, auth, and install surfaces.

/.well-known/agent.json

Skill Index

Lists published skills and their installable files.

/.well-known/skills/index.json

Skill Manifest

Stable well-known path for the Hermes/OpenClaw Conto skill bundle.

/.well-known/skills/conto

Skill Entrypoint

Serves `SKILL.md` by default and can list or fetch individual skill files.

/skill

OpenAPI

The OpenAPI spec behind the generated clients, schema validation, and interactive API docs.

/api/openapi

LLMs Index

Compressed docs index for agent discovery and retrieval.

/llms.txt

LLMs Full

The full docs and API reference in one file, for agents that pull in a lot of context.

/llms-full.txt