Examples
Three worked sessions with a coding agent connected to Sypnia: fixing a problem end to end, finding why a page is slow, and seeing what one customer saw.
Engine Cloud Three sessions, written out. Each shows what you type, which tool the agent calls, what comes back, and what the agent does with it. The data is the shop from the rest of these docs. Results are shortened here; the full ones are in the tools reference.
Your client shows a call under the server’s name. This page writes sypnia.problems({ … }); yours may show sypnia:problems or mcp__sypnia__problems.
1. Fix what is failing
The session from the Sypnia home page, in full.
You
what is failing in production?Agent calls sypnia.problems({ status: "open" })
{
"problems": [
{
"slug": "pay-button-does-nothing",
"status": "open",
"sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
"confidence": "high",
"where": { "file": "src/checkout/checkout.tsx", "line": 142, "function": "confirmPayment" },
"people": 3,
"first_seen": "2026-03-12T09:12:04Z",
"first_release": "4f2a91c"
}
],
"counts": { "open": 1, "resolved": 4, "ignored": 1 }
}Agent
1 open problem since yesterday’s deploy: 3 people tried to pay and could not. The checkout sends the payment without an amount. I have the trace and the session. Want me to fix it?
You
yes, and add a testAgent calls sypnia.problem({ id: "pay-button-does-nothing" })
{
"analysis": {
"cause": {
"text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
"evidence": [
{ "kind": "release_change", "ref": "4f2a91c:src/cart/cart.ts", "text": "The release renames `total` to `totalCents` in the Cart type." },
{ "kind": "stack_frame", "ref": "src/checkout/checkout.tsx:142", "text": "confirmPayment() still passes `cart.total` to createPayment()." }
]
},
"what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
"confidence": "high"
},
"stack": {
"frames": [
{
"function": "confirmPayment", "file": "src/checkout/checkout.tsx", "line": 142,
"source": { "start_line": 140, "lines": [
"async function confirmPayment(cart: Cart) {",
" setPaying(true);",
" const payment = await createPayment({ amount: cart.total, currency: cart.currency });"
] }
}
]
},
"release": { "version": "4f2a91c", "changes": { "commits": [{ "sha": "4f2a91c", "message": "Rename cart.total to cart.totalCents" }] } }
}The agent opens src/checkout/checkout.tsx, sees that line 142 still reads cart.total, and confirms in src/cart/cart.ts that the field is now totalCents. It writes a test that fails when the amount is missing, then edits the file:
async function confirmPayment(cart: Cart) {
setPaying(true);
- const payment = await createPayment({ amount: cart.total, currency: cart.currency });
- router.push(`/orders/${payment.orderId}`);
+ try {
+ const payment = await createPayment({ amount: cart.totalCents, currency: cart.currency });
+ router.push(`/orders/${payment.orderId}`);
+ } catch (error) {
+ setError('We could not take the payment. Nothing was charged. Please try again.');
+ } finally {
+ setPaying(false);
+ }
}Agent
Fixed:
confirmPayment()now readscart.totalCents, and the customer sees a message when a payment is rejected. I addedcheckout.test.tsxwith a test that fails when the amount is missing; it passes now, with the other 41 tests. I have not committed anything.
You review, merge and deploy. Then:
You
it's deployed as 5b3c8d2, mark it resolvedAgent calls sypnia.resolve_problem({ id: "pay-button-does-nothing", release: "5b3c8d2", note: "confirmPayment reads cart.totalCents. Pull request 128." })
{
"slug": "pay-button-does-nothing",
"status": "resolved",
"resolved_at": "2026-03-12T16:30:12Z",
"resolved_by": "mcp:Cursor",
"resolved_in_release": "5b3c8d2"
}Agent
Marked as resolved in release 5b3c8d2. If it happens again in that release or a later one, Sypnia reopens it and alerts you.
2. Find out why a page is slow
You
the daily summary says search got slower. why?Agent calls sypnia.performance({ route: "/search", since: "24h" })
{
"route": "/search",
"page": { "views": 1840, "lcp_p75_ms": 3100, "previous_lcp_p75_ms": 1900, "inp_p75_ms": 180, "cls_p75": 0.04, "poor_share": 0.21 },
"elements": {
"lcp": [
{ "selector": "main ul.results > li:nth-child(1) img", "kind": "image", "samples": 1310, "p75_ms": 3200, "poor_share": 0.24 }
]
},
"suggestions": [{ "id": "sug_3h7j1k5l9p2o", "title": "The search page's first product image loads slowly" }]
}Agent
The search page now takes 3.1 seconds to show its main content for three of four visits; it was 1.9. The slow element is the first product image in the results (
main ul.results > li:nth-child(1) img), in 1,310 of 1,612 measured loads. Interaction and layout are fine. Let me look at how that image is rendered.
The agent finds the results component, sees that yesterday’s release replaced the thumbnail URL with the full-size image, and proposes to serve the thumbnail again and to load the first image with high priority.
Nothing here is a problem: no one saw an error. The agent got from «slower» to an element and a line of code with one call.
3. See what one customer saw
A customer wrote to support: «I tried to pay three times and nothing happened».
You
ada@example.com says she couldn't pay this morning. what happened?Agent calls sypnia.search({ q: "ada@example.com" })
{
"people": [
{
"id": "u_1042", "name": "Ada Park", "email": "ada@example.com",
"last_seen": "2026-03-12T10:31:58Z",
"latest_sessions": [{ "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0", "started_at": "2026-03-12T10:31:16Z", "trouble": true }]
}
]
}Agent calls sypnia.session({ id: "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0" })
{
"events": [
{ "offset_ms": 12412, "type": "page_view", "text": "Opened /checkout (from /cart)" },
{ "offset_ms": 27090, "type": "click", "text": "Clicked button «Pay $64.00» in «Your order»" },
{ "offset_ms": 29310, "type": "rage_click", "text": "Clicked button «Pay $64.00» 4 more times" },
{ "offset_ms": 31000, "type": "request", "text": "POST /api/checkout answered 400 amount_required after 3,870 ms" },
{ "offset_ms": 31004, "type": "error", "text": "ApiError: POST /api/checkout failed with 400 (amount_required)", "problem": "pay-button-does-nothing" },
{ "offset_ms": 42230, "type": "page_leave", "text": "Left /checkout after 30 s" }
]
}Agent
Ada opened the checkout at 10:31, clicked «Pay $64.00», then four more times when nothing happened. The payment was rejected because it was sent without an amount, and the page showed her nothing. She left 11 seconds later. She was not charged. This is the known problem «pay-button-does-nothing», which hit 3 people today. The replay of her session is at https://app.sypnia.com/shop/sessions/8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0.
The search by e-mail works because the shop sends names and e-mails with identify(). A project that sends only ids is searched by id. The timeline has what she clicked, by the label of the button, and never anything she typed. The agent gives you the link to the replay; it cannot watch it.