> ## Documentation Index
> Fetch the complete documentation index at: https://conto.finance/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Tooling

> A practical toolbelt for building, testing, and operating Conto agent payment integrations

# Developer Tooling

Use this page when you want a working integration, not just conceptual docs. Start with the CLI,
verify the runtime with setup probes, then add API docs, MCP tools, webhooks, and audit trails as
you move toward production.

## Fastest First Run

```bash theme={null}
npx @conto_finance/create-conto-agent
```

The CLI provisions an agent, wallet, policy, SDK key, and local config. Choose **Tempo Testnet** for
the first run so you can fund with free `pathUSD` and exercise the real request and execute flow
without real funds.

After the wizard completes, run the generated example:

```bash theme={null}
npx tsx example.ts
```

## Toolbelt

| Tool            | Use it for                                        | Link                                            |
| --------------- | ------------------------------------------------- | ----------------------------------------------- |
| CLI quickstart  | One-command agent, wallet, policy, and key setup  | [CLI quickstart](/cli/quickstart)               |
| SDK setup probe | Verify agent status, wallets, scopes, and limits  | [`GET /api/sdk/setup`](/sdk/installation)       |
| OpenAPI         | Generate clients and inspect request schemas      | [API reference](https://conto.finance/api-docs) |
| MCP server      | Give Claude/Codex/Cursor agent tools access       | [Install MCP server](/mcp/install)              |
| Webhooks        | Receive signed payment and agent lifecycle events | [Webhooks](/guides/webhooks)                    |
| Audit logs      | Review policy decisions and sensitive actions     | [Audit logs](/guides/audit-logs)                |
| Policy testing  | Dry-run and validate policy behavior              | [Policy testing](/guides/policy-testing)        |

## Setup Probe

Before making a payment, call the setup endpoint with the same SDK key your agent will use:

```bash theme={null}
curl https://conto.finance/api/sdk/setup \
  -H "Authorization: Bearer $CONTO_API_KEY"
```

The CLI wraps the same endpoint with pass/fail checks:

```bash theme={null}
npx conto doctor
```

Check these fields in the response:

* `agent.status` is `ACTIVE`
* at least one wallet is linked and funded
* `scopes` includes `payments:request`
* execute-capable flows include `payments:execute`
* limits and policies match the agent's expected spending envelope

## Generated Clients

The OpenAPI document is the contract for generated clients:

```bash theme={null}
curl https://conto.finance/api/openapi > conto-openapi.json
```

Use it with your preferred generator or import it into tools like Postman, Bruno, or an internal API
portal. The interactive reference is available at [conto.finance/api-docs](https://conto.finance/api-docs).

## Production Readiness

Before giving an autonomous agent production funds, confirm:

* SDK keys are named by environment and agent, for example `prod-research-agent`
* each runtime uses the narrowest key type and scopes it needs
* webhook signature verification uses the raw request body
* testnet policy results match the production policy envelope
* organization API keys are stored only in backend or CI systems
* agent SDK keys are rotated after demos, contractor access, or leaked logs
* audit logs are reviewed after the first live payment

## Useful Next Reads

<CardGroup cols={2}>
  <Card title="Choose Your Integration" icon="route" href="/guides/choose-your-integration">
    Decide between SDK, REST, MCP, OpenClaw, Hermes, x402, and MPP.
  </Card>

  <Card title="Recipes" icon="terminal" href="/guides/recipes">
    Copy-paste API, SDK, skill, and payment examples.
  </Card>

  <Card title="Authentication" icon="key" href="/sdk/authentication">
    Understand SDK keys, org API keys, key types, and scopes.
  </Card>

  <Card title="Testing Payments" icon="flask-conical" href="/guides/testing-payments">
    Safely test with Tempo Testnet before moving money in production.
  </Card>
</CardGroup>