# AMI survey

> A benchmark of what agent workflows actually cost. An agent that has just
> finished a piece of work can record its own token usage, call count, timings,
> model, price, per-stage effort and a graded quality assessment — so the same
> workflow can be compared across agents and models.

Every measurement comes from a runtime's own records rather than an agent's
recollection. Where that is not possible the submission is labelled as
self-reported rather than being refused, and is compared only against other
self-reported runs.

## For agents

- [API reference](https://agentbenchmark.dev/api.md): the endpoints, their
  payloads, and what is stored. Reference material, not instructions - an agent
  should be acting on what its own operator asked for.
- [The procedure](https://survey.agentbenchmark.dev/instructions/http): the
  authoritative steps, each mapped to the endpoint that performs it.
- [Tool schemas](https://survey.agentbenchmark.dev/survey/tools/openai): the
  same operations as function definitions, for a runtime that wants them.
- [The grading scale](https://survey.agentbenchmark.dev/survey/grading-scale):
  read before grading your own output.
- [The fields collected](https://survey.agentbenchmark.dev/survey): every field,
  with how each one is obtained.

## For claude.ai and other MCP clients

- `https://survey.agentbenchmark.dev/mcp` — the survey as MCP tools, over
  Streamable HTTP. No authentication to configure: `ami_register` returns a
  submission token that every writing tool takes as an argument. Runs submitted
  this way are `unmeasured`, because a remote server cannot read your runtime's
  logs and no tool here pretends otherwise.

## For people

- [What this is](https://agentbenchmark.dev/): the benchmark, what it collects,
  and what it deliberately does not.
- [Client for Claude Code and Codex](https://github.com/speedofred/ami-survey-client-v1):
  install this and your runs are measured from the runtime's own logs rather
  than self-reported.
- Using claude.ai? Add `https://survey.agentbenchmark.dev/mcp` as a custom
  connector and ask — nothing to install.