All recipes

Secure & Govern · Prompt

Review a vendor's SOC 2 report

Read a vendor's SOC 2 report and check exceptions and customer responsibilities against the client's controls.

ControlMap
Requires MCPby Greg Brydon · Solutions Engineer

Needs an LLM client connected to ScalePad MCP — Claude Desktop, Cursor, Windsurf or similar. Without it the assistant cannot call the recipe's tools.

User prompt

2 inputs to fill
I've attached [VENDOR]'s SOC 2 report. Review it for [CLIENT NAME]:
1. Report type, period and scope. Does it cover the services the client uses?
2. Exceptions or qualified opinions, and whether they affect the client
3. Complementary user entity controls (the client's responsibilities) and whether ControlMap shows the client actually doing them
4. Subservice organizations that are carved out

Summarize in a short memo. Before you create, update or delete anything, show me exactly what you plan to change in a table and wait for my approval. After approval, create a risk for any exception that affects the client, and create an evidence record for the review mapped to the client's vendor management objectives.

How to work with the ControlMap API (ScalePad MCP):
- Find the client with GET /controlmap/v1/clients/health and use its tenant ID (for example "dundmif") in every request. Some clients have no UUID.
- Send the header Content-Type: application/json on every POST, PUT and PATCH, including searches.
- Use page_size of 50 or less and follow next_cursor. The "fields" parameter is ignored, so responses are large.
- Judge controls by "status", not the "compliant" flag. Objective lists include sub-objectives, so take totals from objective_summary.
- Use framework-level scores and labels. The overall score_label on client health can be wrong.
- Older policy sections may be URL-encoded twice: decode them and use the highest version of each section.
- If a call returns 502 or fails to connect, wait a few seconds and retry once. If it still fails, tell me exactly which data is missing.

When writing to ControlMap:
- Update policies one field per request. review_date must include milliseconds (2027-01-01T00:00:00.000Z) and policy status must be draft, in_progress, in_review or approved.
- Risk scores and treatment can't be changed through the API. A new risk takes one impact and likelihood, which sets inherent, current and target together. List any score or treatment changes for me to make in ControlMap.
- Write evidence request notes to the "notes" field and assignees to "assigned_to".
- Files can't be uploaded through the MCP. Attach a link to where the file lives (SharePoint, Google Drive) and list any files I need to upload in ControlMap.
- Department and risk category must match existing values (GET /risks/departments and /risks/categories).
- Action item effort is capped at 8 hours, so put larger estimates in the description.
- A 500 error can still save part of a change. Read the record back before retrying.

# Review a vendor's SOC 2 report

Hook: Read a vendor's SOC 2 report and check exceptions and customer responsibilities against the client's controls.

When to use it

Annual vendor review, or when a key vendor sends a new report.

What you get

Exceptions that matter, user entity controls the client must own, and a risk update.

Fill in the details

  • [VENDOR]: Vendor name (e.g. Dropbox)
  • [CLIENT NAME]: Client name (e.g. Acme Dental)

Status

Tested against the ControlMap API on October 16, 2026. Only asks for what the API supports.

Makes changes: Claude shows a plan of every create, update or delete and waits for your approval before acting.

GBAuthorGreg BrydonSolutions Engineer · ScalePad

Recipes are starting points. Adapt them to your environment and validate the output before putting one into practice.

Request a recipe

More in Secure & Govern