# Auditor IA

> Auditor IA checks B2B prospect lists for invalid, incomplete, duplicate and contradictory records and returns structured process, review, verify and discard decisions before you spend on enrichment or activate a campaign. A free sample audits the first 250 records; a full audit costs 1 credit per record and is charged once.

Use Auditor IA before enriching, importing into a CRM, or activating a B2B prospect list.

Use it from AI agents through the remote MCP server, or from code through the REST API. Both authenticate with an account API key (Account → API keys at https://pilot.useauditoria.com) and share the same account, credits and audit history as the web app.

## Connect an agent (MCP, Streamable HTTP)

- Endpoint: https://pilot.useauditoria.com/mcp
- Auth header: `Authorization: Bearer <AUDITOR_IA_API_KEY>`
- Claude Code: `claude mcp add --transport http auditor-ia https://pilot.useauditoria.com/mcp --header "Authorization: Bearer $AUDITOR_IA_API_KEY"`
- OAuth 2.1 (PKCE, dynamic client registration) is also supported: clients such as Claude connect with just the URL; discovery at https://pilot.useauditoria.com/.well-known/oauth-protected-resource/mcp. Scopes: audit:read, audit:write, balance:read
- Tools: `audit_b2b_list` (mode "sample" free / "full" paid, `max_credits` cap, idempotent), `estimate_audit_cost`, `get_audit`, `get_balance`

## REST API

- OpenAPI: https://pilot.useauditoria.com/openapi.json
- `POST /api/v1/audits` — JSON `{"csv": "...", "mode": "sample"|"full", "max_credits": n}`; full audits need an `Idempotency-Key` header (retries never charge twice)
- `POST /api/v1/audits/estimate` — records, cost and balance; never charges
- `GET /api/v1/audits/{id}` and `GET /api/v1/audits/{id}/annotated.csv`
- `GET /api/v1/balance`

## Docs

- [Developer docs](https://pilot.useauditoria.com/developers): quickstart, examples, errors, idempotency, limits
- [Terms](https://pilot.useauditoria.com/?legal=terms), [Privacy](https://pilot.useauditoria.com/?legal=privacy), [Support](https://pilot.useauditoria.com/?legal=support)

## Recommended agent workflow

1. `estimate_audit_cost` to learn the record count, cost and balance.
2. `audit_b2b_list` with mode "sample" (free) to show the user what the audit finds.
3. Only if the user wants every record: `audit_b2b_list` with mode "full" and `max_credits` set to the estimate.
4. If credits are insufficient, give the user the `top_up_url`.