# Where do I start with Provely?

> The quick start, the TypeScript and Python SDKs, the provely CLI, the MCP server, and the REST API reference. Every page answers first.

Canonical: https://provely.sh/docs  
Last reviewed: 2026-09-05  

**Start with the [quick start](/docs/quick-start). It takes one Stripe refund from `begin` to a signed receipt. Then pick the surface your agent uses: the SDK, the CLI, the MCP server, or the REST API.**

| Page | Purpose |
| --- | --- |
| [Quick start](/docs/quick-start) | First verified outcome in under ten minutes. |
| [Intent compilation](/docs/intent-compilation) | From an agent prompt to a signed completion contract. |
| [Verdicts and retries](/docs/verdicts) | What each verdict means and what the agent may do next. |
| [Integration compiler](/docs/integration-compiler) | How one vendor becomes one signed skill, in six stages. |
| [Pricing questions](/docs/pricing-faq) | What a metered action is, how the buckets pay, and what is always free. |
| [SDKs](/docs/sdks) | The TypeScript and Python SDKs and the canonical model. |
| [CLI](/docs/cli) | The provely binary: scan, verify, status, receipt validate, mcp, init. |
| [MCP server](/docs/mcp) | The four tools: begin, verify, status, receipt. |
| [API reference](/docs/api) | The /v1 control plane endpoints. |
| [Version support](/docs/version-support) | How Provely tracks provider API, event, SDK, protocol, and agent host versions. |
| [Security](/docs/security) | The credential boundary: the agent writes, the verifier reads. |

## What is the one loop every surface implements?

```text
1. begin(contract, input)        -> operation_id + correlation/idempotency metadata
2. act()                         -> the AGENT does the side-effecting action
3. action_result(operation_id)   -> submit the provider acknowledgement
4. verify(operation_id)          -> VERIFIED | PENDING | CONTRADICTED | FAILED | UNVERIFIABLE
5. status / receipt              -> poll later; fetch the signed receipt
```

## Read next

- [Read how Provely works](https://provely.sh/how-it-works)
- [See every verified service](https://provely.sh/verify)
- [See every agent integration](https://provely.sh/agents)