Promptles
Errors

Verify the MCP Output

Ask for the raw response shape first; refuse to act on fields the agent can't quote.

MCP responses can be paginated, partial, or shaped differently than you expect — and the agent will happily quote fields that aren't in the response if you don't push back. Ask it to surface the raw shape first (the actual keys and types it received), then act on the data. If a field the agent claims isn't visible in that raw output, it didn't come from the MCP — it was invented.

Where you'll practice this

4 Promptles scenarios teach this principle directly. Each one drops you into a real engineering ticket and asks you to write the prompt you'd send to Claude Code.

  • Show Me the Shape

    Last week, an engineer asked the agent to summarize three Linear issues via the Linear MCP. The summary confidently included a `severity` field for each issue — 'severity: high', 'severity: critical' — and the team made decisions on it. Turns out the Linear API doesn't return a…

  • Don't Hallucinate Fields

    Your team's nightly digest is an MCP-driven summary — the agent calls `github__list_pull_requests` against three repos and writes a Slack message with the day's open PRs. This morning's digest claimed every PR had a `riskScore` field ('riskScore: low', 'riskScore: medium',…

  • Find the Right Doc, and Cite It

    Your Google Drive MCP server is connected. You asked Claude to 'summarize our pricing doc' and got a clean, confident summary, of the wrong file. There are four documents with 'pricing' in the name, and it grabbed a draft from last year. The one you actually mean is 'Pricing…

  • Verify the Whole Chain Before It Ships

    You've built a weekly client update: pull the headline metrics from a Drive sheet, summarize the open issues in Linear, and post a client-facing update to a shared Slack channel. It runs end to end, which is exactly the problem, a few weeks ago it posted a revenue number off a…

Other principles in Errors