> ## 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.

# Pitch Audit Tools

> Read agency Pitch Audits and co-competitor reports through MCP.

Pitch Audit tools expose agency pre-sales reports to MCP clients. They are read-only: neither tool creates, confirms, retries, or changes an audit.

## list\_pitch\_audits

List Pitch Audits across the agency workspaces accessible to the connected user.

### Parameters

| Parameter | Type   | Required | Description                                                                      |
| --------- | ------ | -------- | -------------------------------------------------------------------------------- |
| `teamId`  | string | No       | Restrict the list to one accessible agency workspace                             |
| `status`  | string | No       | `PENDING`, `RUNNING`, `RECOVERING`, `AWAITING_PROMPTS`, `COMPLETED`, or `FAILED` |
| `limit`   | number | No       | Max audits, default 20 and maximum 100                                           |
| `offset`  | number | No       | Pagination offset, default 0                                                     |

The result includes the audit ID, prospect, status, scores, prompt count, competitors, selected AI models, timestamps, and workspace.

## get\_pitch\_audit

Read the full report for one Pitch Audit.

### Parameters

| Parameter                   | Type    | Required | Description                                                            |
| --------------------------- | ------- | -------- | ---------------------------------------------------------------------- |
| `auditId`                   | string  | Yes      | Audit ID returned by `list_pitch_audits`                               |
| `subjectId`                 | string  | No       | Competitor report subject. Omit for the original prospect              |
| `includeAnswers`            | boolean | No       | Include full AI answer text. Defaults to false to keep context bounded |
| `includeCoCompetitorScores` | boolean | No       | Add full score summaries to every co-competitor row. Defaults to false |

The report includes the scored competitor and source analyses, detected insights, recommendations, `availableSubjects`, and `coCompetitors`. Full AI answers are added only when `includeAnswers` is true.

To retrieve the complete co-competitor list and compare their scores in one call:

```json theme={null}
{
  "auditId": "8a218180-6dd7-43c7-a481-f6a1cc72dfd8",
  "includeCoCompetitorScores": true
}
```

Read `audit.coCompetitors[].scores`. Keep the expansion disabled when you only need the lighter co-occurrence metrics.

### Open a co-competitor report

Every `coCompetitors` row returns a `subjectId`. Reuse it with the same audit:

```json theme={null}
{
  "auditId": "8a218180-6dd7-43c7-a481-f6a1cc72dfd8",
  "subjectId": "rival.com"
}
```

For the original prospect, omit `subjectId` or pass `self`.

### Example prompts

```text theme={null}
List the completed Pitch Audits in my agency workspace.
```

```text theme={null}
Open the latest Pitch Audit, identify its strongest co-competitor, then load that co-competitor's report.
```

### OAuth Scope

Both tools require `read:pitch-audits`.

<Note>
  Existing MCP connections must reconnect and authorize the new scope before these tools appear.
</Note>