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

# Guided Onboarding

> Point a coding agent at Verial and have it wire up a first evaluation end to end.

Guided onboarding is the fastest way to go from zero to a scored run when you are working through an AI coding agent. The agent introspects your organization, picks a published benchmark, configures a run, drives a rollout, and reads back results.

## The flow

1. **Connect.** The agent authenticates with a Verial API key or Solver key. See [Authentication](/api-reference/authentication).
2. **Discover.** The agent lists published benchmarks (`GET /benchmarks?visibility=Public`), inspects environments, and summarizes what is available.
3. **Pick a benchmark.** You confirm a target (for example `fax-referral@1`). The agent reads the tasks and criteria.
4. **Start a run.** The agent calls `POST /v1/benchmark-runs`, stores the returned bearer token, and walks through each task run.
5. **Drive the rollout.** The agent calls your agent-under-test through the sandbox endpoints (FHIR, HL7, files, portal).
6. **Read results.** The agent fetches task run verdicts, per-criterion scores, and evidence, then explains what happened.

## Using MCP

The [Verial MCP server](/mcp/overview) exposes every resource as a structured tool. MCP clients can discover the tool surface and execute the onboarding flow without any custom code. See [MCP Setup](/mcp/setup) to connect Claude Code, Cursor, or ChatGPT Desktop.

## Using the CLI

If your coding agent has a shell tool, the Verial [CLI](/cli/overview) is enough:

```bash theme={null}
verial benchmarks list --json
verial benchmark-runs create --benchmark fax-referral@1 --json
# ... drive rollout endpoints ...
verial benchmark-runs get $RUN_ID --json
```

<Note>
  A dedicated `/onboard` slash command that orchestrates the full flow in one step is on the roadmap. In the meantime, point your agent at this page and at [Running a Benchmark](/guides/running-a-benchmark).
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Agent Skills" icon="book-sparkles" href="/ai-agents/skills">
    Install Verial expertise into your AI coding agent.
  </Card>

  <Card title="MCP Server" icon="plug" href="/mcp/overview">
    The richest integration for agentic workflows.
  </Card>
</CardGroup>