---
name: conto-agent-setup
description: Discover, install, verify, and use Conto for policy-checked agent payments.
user-invocable: true
allowed-tools: Bash(command:*), Bash(npm:*), Bash(npx:*), Bash(curl:*), Bash(node:*)
metadata:
  author: conto
---

# Conto Agent Setup

You are setting up Conto, a control center for agentic payments. Your goal is to help the user connect an agent, verify policy-checked payments, and choose the right integration surface.

## Discovery

Start with these machine-readable resources:

- Agent manifest: https://conto.finance/.well-known/agent.json
- Agent-readable site: https://conto.finance/ai
- Raw Markdown index: https://conto.finance/.md
- Docs index: https://conto.finance/llms.txt
- Full docs: https://conto.finance/llms-full.txt
- OpenAPI: https://conto.finance/api/openapi
- Skill: https://conto.finance/skill

## Choose an Integration Path

- Use the SDK when you control the agent runtime: `npm install @conto_finance/sdk`
- Use MCP when an assistant should operate Conto tools: `npx @conto_finance/mcp-server`
- Use the CLI for guided setup: `npx @conto_finance/create-conto-agent`
- Use skills when the agent runtime supports well-known skills: https://conto.finance/.well-known/skills/conto
- Use REST/OpenAPI when generating clients or integrating directly: https://conto.finance/api/openapi

## Fast Sandbox Path

1. Read the agent sandbox quickstart: https://conto.finance/docs/quickstart/agent-sandbox
2. For headless setup, run:

```bash
npx @conto_finance/create-conto-agent --sandbox --json
```

3. Or create a sandbox directly:

```bash
curl -X POST https://conto.finance/api/agents/sandbox \
  -H "Content-Type: application/json" \
  -d '{}'
```

4. Store returned credentials securely. Keys are shown once and sandbox credentials expire.
5. Verify setup with the SDK setup endpoint or CLI doctor.
6. Make a small policy-checked payment request in sandbox mode.
7. Confirm that Conto returns a policy decision before execution.

## Production Readiness

- Confirm wallet custody mode.
- Confirm agent SDK key scopes.
- Configure spend limits, counterparty rules, time windows, and approval thresholds.
- Add webhooks for payment status, approvals, alerts, and freeze events.
- Test denials and approval routing before enabling live funds.
- Review audit logs and machine-spend analytics after test traffic.

## First Useful User Prompts

- "Set up a Conto sandbox for this agent."
- "Read Conto's agent manifest and tell me the best integration path."
- "Install the Conto MCP server and verify it is available."
- "Generate a minimal SDK payment request and explain where policy is enforced."
- "Install the Conto skill for this runtime and verify a policy check works."