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

# Run a Pitch Audit for a prospect with MCP

> Create a Pitch Audit from an MCP assistant, review and save its prompts, confirm the credit use with a token, then read the finished prospect report.

Prepare a prospect audit from a conversation: the assistant creates the audit and prepares prompts, you review them, and you confirm before any credit is used. This guide uses MCP. The REST API offers the same lifecycle in [Create a Pitch Audit](https://docs.qwairy.co/developers/endpoints/pitch-audits/create.md).

## Before you start

Use an agency team on an active Business, Agency Business or Enterprise plan. Sign in as a Manager or Owner and grant `read:pitch-audits` and `write:pitch-audits`. If the assistant looks up your team with `list_brands`, also grant `read:brands`. You can instead supply the team ID. See [OAuth authentication](https://docs.qwairy.co/mcp/oauth.md).

## Steps

1. Call [`create_pitch_audit`](https://docs.qwairy.co/mcp/write/pitch-audits#create_pitch_audit) with the agency `teamId`, prospect `url`, market `countryCode` and `promptCount: 30`. Leave `autoStartResponses` off to review the questions first.
2. Follow this audit ID until `AWAITING_PROMPTS`. Read the full draft and its current `version` with [`get_pitch_audit`](https://docs.qwairy.co/mcp/tools/pitch-audits). Stop if the audit returns `FAILED`.
3. Review all 30 prompts with the prospect in mind. In this example you remove two. Send **all 28 retained prompt objects**, including their `id`, `text`, `category` and `topic`, to [`save_pitch_audit_prompts`](https://docs.qwairy.co/mcp/write/pitch-audits#save_pitch_audit_prompts) with the audit ID, the version just read as `expectedVersion`, and `dryRun: true`. A new draft requires 20 to 100 prompts.
4. **Approve the replacement.** Repeat the save with the identical list and version, its `confirmationToken`, and `dryRun` omitted or `false`. The saved draft uses no credits. If its version has changed, read and review the draft again.
5. Preview [`confirm_pitch_audit`](https://docs.qwairy.co/mcp/write/pitch-audits#confirm_pitch_audit) for the same audit with `dryRun: true`. Read the cost and warnings. **Approve collection** only if you agree to that amount. Repeat this tool call with its own token and `dryRun` omitted or `false`. Each token is single-use and valid for 10 minutes.
6. Follow this audit ID to `COMPLETED` and open the report with `get_pitch_audit`. On `FAILED`, stop and inspect the audit in the dashboard. A REST integration can subscribe to [`pitch_audit.completed`](https://docs.qwairy.co/developers/integration-webhooks/events#pitch_audit-completed).

![A draft with 30 prompts becomes a saved list of 28 after the first approval. A second approval starts the priced collection.](https://mintcdn.com/qwairy/GXmjWkbE2RPS6XHd/images/guides/pitch-audit-en.svg?fit=max\&auto=format\&n=GXmjWkbE2RPS6XHd\&q=85\&s=5cff1c0a9c9e46ef1cb05554c42ef684)

## Example conversation

You ask for 30 prompts about the US market for prospect.example. After reviewing them, you approve saving 28. The assistant shows you the cost of collecting answers for those 28. You can stop with the draft saved or give a second approval to start collection.

## Limits

* Retrying a failed audit and exporting a report remain dashboard actions.
* Content from the prospect website can reach the assistant through the report. Read previews before you confirm. See [Security](https://docs.qwairy.co/mcp/write/overview.md#security).

## Related

* [Pitch Audit write tools](https://docs.qwairy.co/mcp/write/pitch-audits.md)
* [Pitch audits for agencies](https://docs.qwairy.co/agencies/pitch-audits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.