# Audits and findings MCP tools

This page documents **16 tools** in the audits and findings group. Return to the [complete MCP tool reference](/docs/developers/api/mcp/tools) to browse another group.

Select a tool to inspect its schemas and behavior. Schema links open the exact definition in GitHub.

### `listFindings` — List Findings

List all findings (nonconformities, observations, exceptions) for the organization.

- **Input:** [`ListFindingsInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3611-L3650)
- **Output:** [`ListFindingsOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3652-L3663)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14696–L14707 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14696-L14707)

### `getFinding` — Get Finding

Get a finding by ID.

- **Input:** [`GetFindingInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3665-L3672)
- **Output:** [`GetFindingOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3674-L3680)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14708–L14719 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14708-L14719)

### `addFinding` — Add Finding

Add a new finding (nonconformity, observation, or exception) to the organization.

- **Input:** [`AddFindingInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3682-L3742)
- **Output:** [`AddFindingOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3744-L3750)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L14720–L14731 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14720-L14731)

### `updateFinding` — Update Finding

Update an existing finding.

- **Input:** [`UpdateFindingInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3752-L3808)
- **Output:** [`UpdateFindingOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3810-L3816)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14732–L14743 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14732-L14743)

### `deleteFinding` — Delete Finding

Delete a finding.

- **Input:** [`DeleteFindingInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3818-L3825)
- **Output:** [`DeleteFindingOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3827-L3834)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14744–L14755 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14744-L14755)

### `linkFindingAudit` — Link Finding Audit

Link a finding to an audit with a reference ID.

- **Input:** [`LinkFindingAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3836-L3851)
- **Output:** [`LinkFindingAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3853-L3862)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14756–L14767 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14756-L14767)

### `unlinkFindingAudit` — Unlink Finding Audit

Unlink a finding from an audit.

- **Input:** [`UnlinkFindingAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3864-L3875)
- **Output:** [`UnlinkFindingAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3877-L3888)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14768–L14779 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14768-L14779)

### `listFindingAudits` — List Finding Audits

List audits linked to a finding.

- **Input:** [`ListFindingAuditsInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3890-L3906)
- **Output:** [`ListFindingAuditsOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L3908-L3919)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L14780–L14791 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L14780-L14791)

### `listAudits` — List Audits

List all audits for the organization.

- **Input:** [`ListAuditsInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5201-L5217)
- **Output:** [`ListAuditsOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5219-L5230)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15032–L15043 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15032-L15043)

### `getAudit` — Get Audit

Get an audit by ID.

- **Input:** [`GetAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5232-L5239)
- **Output:** [`GetAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5241-L5247)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15044–L15055 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15044-L15055)

### `addAudit` — Add Audit

Add a new audit to the organization.

- **Input:** [`AddAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5249-L5282)
- **Output:** [`AddAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5284-L5290)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L15056–L15067 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15056-L15067)

### `updateAudit` — Update Audit

Update an existing audit.

- **Input:** [`UpdateAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5292-L5334)
- **Output:** [`UpdateAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5335-L5341)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15068–L15079 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15068-L15079)

### `deleteAudit` — Delete Audit

Delete an audit.

- **Input:** [`DeleteAuditInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5343-L5350)
- **Output:** [`DeleteAuditOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5352-L5359)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15080–L15091 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15080-L15091)

### `getAuditReportUrl` — Get Audit Report URL

Get a presigned download URL for an audit's attached report. Returns a time-limited URL valid for 15 minutes. The audit must have an attached report.

- **Input:** [`GetAuditReportUrlInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5166-L5173)
- **Output:** [`GetAuditReportUrlOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5175-L5182)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15092–L15103 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15092-L15103)

### `deleteAuditReport` — Delete Audit Report

Delete the report file attached to an audit.

- **Input:** [`DeleteAuditReportInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5184-L5191)
- **Output:** [`DeleteAuditReportOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L5193-L5199)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15104–L15115 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15104-L15115)

### `publishFindingList` — Publish Finding List

Publish the finding register for an organization as a document. If a document already exists, a new version is created.

- **Input:** [`PublishFindingListInput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L7629-L7645)
- **Output:** [`PublishFindingListOutput`](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L7647-L7658)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L15680–L15691 ↗](https://github.com/getprobo/probo/blob/main/pkg/server/api/mcp/v1/specification.yaml#L15680-L15691)