---
name: stripe-disputes-to-respond
description: "Every morning: Stripe disputes and inquiries waiting on a response, with amount, reason and the evidence due date, and a question on who gathers it. Use when the user asks for this, or when it runs on a schedule."
---

# Stripe disputes to respond to

Every morning: Stripe disputes and inquiries waiting on a response, with amount, reason and the evidence due date, and a question on who gathers it.

A dispute you don't answer is a dispute you lose, and the deadline sits in a field most people only see when they open the Disputes page. Small teams miss them in the gap between "finance will handle it" and "support has the emails".

Every morning the agent lists the disputes and inquiries that still need a response, sorted by how soon evidence is due, with the reason the bank gave and what kind of evidence answers it. The card asks who takes each one, so the question gets an owner the same day it arrives.

## Two ways to get the data

Use the API or MCP route when you have an MCP server, a CLI or an API token for the app. Otherwise, if you can drive a browser the user is signed in to (Claude in Chrome, a Playwright or Chrome DevTools MCP server), use the browser route. Say which one you used.

## Route A: API or MCP server

### What you need

- Read access to disputes and charges: the Stripe MCP server (`https://mcp.stripe.com`) with OAuth or a restricted key as the bearer token, which reads them through its `list_disputes` and search tools, or a restricted key with Disputes and Charges set to Read in `STRIPE_API_KEY`.
- Who on the team can gather evidence (support, fulfillment, finance), so the card can offer them as answers.

If something is missing, say what and stop; do not invent numbers.

### Steps

1. **List the open disputes** (Stripe): Call `GET /v1/disputes` with `created[gte]` 120 days ago and `limit=100`, paging with `starting_after`. The list has no status filter, so keep the disputes whose `status` is `needs_response` or `warning_needs_response` (an inquiry that is not yet a chargeback).
2. **Add the payment behind each one** (Stripe): Retrieve the `charge` (`GET /v1/charges/{id}`) for the customer email, description and payment date. Note `evidence_details.has_evidence` (evidence already saved) and `evidence_details.submission_count`.
3. **Rank by deadline**: Sort by `evidence_details.due_by` (a Unix timestamp), soonest first, and mark anything due within 72 hours as urgent. Match the `reason` to the evidence that answers it: tracking for `product_not_received`, the cancellation policy and logs for `subscription_canceled`, the second charge for `duplicate`, sign-in and delivery records for `fraudulent`.
4. **Ask who gathers the evidence**: Post the list as an ask and record the answer in a local notes file next to the dispute ID. The skill writes nothing to Stripe: an update with evidence is sent to the bank unless `submit=false` is passed, so evidence stays a job for a person in the Dashboard.

## Route B: the browser

### What you need

- Signed in to the Stripe Dashboard with a role that can view disputes and payments (Administrator, Analyst, or a Support role); 2FA already done.

If something is missing, say what and stop; do not invent numbers.

### Steps

Start at https://dashboard.stripe.com/disputes. The user is signed in already; never type passwords or codes, and ask if a sign-in page appears.

1. **Open the disputes that need a response**: On the **Disputes** page in the Stripe Dashboard choose the **Needs response** filter. Make sure the Dashboard is in live mode, not the sandbox, and that the right account is selected in the top left if you have several. Inquiries appear in the same list, labeled as inquiries.
2. **Read each row**: For each dispute note the customer, the amount, the **Reason** and the **Respond by** date. Open the dispute to see the payment's date and description, and whether the evidence section already holds files (the page says so under the response status).
3. **Sort by deadline**: Order the list by Respond by, soonest first, and mark anything due within 72 hours. For each reason, write down what answers it: tracking for product not received, the cancellation policy and logs for subscription canceled, the second charge for duplicate, sign-in and delivery records for fraudulent.
4. **Stop before responding**: Do not click **Submit evidence** or **Accept dispute**; both are final. Post the list and the question of who gathers the evidence, and leave the response itself to the person in the Dashboard.

Note: The Dashboard already does most of this report: the Needs response list, the deadline and the evidence status are all on one page, so the browser route is a good fit here. The one thing to watch is the account picker: the list is per Stripe account, so a business with several accounts runs the steps once per account.

## The report

- **Open disputes**: how many and the amount at stake, with the earliest deadline.
- **The list**, soonest first: customer, amount, reason, evidence due date and whether evidence is already saved.
- **What to collect** for each reason.
- The ask: who gathers the evidence, or which small one to accept.

## Post it to Briefkin

When `BRIEFKIN_TOKEN` is set, or `~/.config/briefkin/env` exists (the installer from https://briefkin.dev/docs writes it), also send the result to the user's Briefkin board as one card. Keep the `item_key` the same on every run so the card updates in place, use a new `event_id` per run, and put today's real numbers in place of the example ones. If the request fails, say so once and carry on.

```bash
[ -n "${BRIEFKIN_TOKEN:-}" ] || . ~/.config/briefkin/env
curl -sS -X POST "${BRIEFKIN_URL:-https://briefkin.dev}/v1/events" \
  -H "authorization: Bearer $BRIEFKIN_TOKEN" \
  -H "content-type: application/json" \
  -d @- <<'JSON'
{
  "v": 1,
  "event_id": "stripe-disputes-to-respond/<date of this run, e.g. 2026-10-16>",
  "item_key": "stripe-disputes-to-respond",
  "project": "Acme",
  "source": "Stripe disputes to respond to skill",
  "kind": "action",
  "title": "4 disputes need evidence, the first due in 3 days",
  "summary": "**4** open disputes worth **$1,386** need a response. The $612 fraud claim is due Oct 20 and has no evidence saved yet.",
  "action": {
    "request": "Who gathers the evidence for these 4 disputes?",
    "options": [
      "Support takes all 4",
      "Fulfillment takes shipping",
      "I will do it",
      "Accept the $49 one"
    ]
  },
  "widget": [
    {
      "type": "Table",
      "props": {
        "columns": [
          "Customer",
          "Amount",
          "Reason",
          "Due",
          "Evidence"
        ],
        "align": [
          "left",
          "right",
          "left",
          "left",
          "left"
        ],
        "rows": [
          [
            "j.martin@example.com",
            "$612.00",
            "Fraudulent",
            "Oct 20",
            "None"
          ],
          [
            "orders@northwind.example",
            "$480.00",
            "Product not received",
            "Oct 23",
            "Tracking saved"
          ],
          [
            "li.chen@example.com",
            "$245.00",
            "Subscription canceled",
            "Oct 27",
            "None"
          ],
          [
            "k.okafor@example.com",
            "$49.00",
            "Duplicate (inquiry)",
            "Oct 29",
            "None"
          ]
        ]
      }
    },
    {
      "type": "Callout",
      "props": {
        "text": "The $49 duplicate is still an inquiry: answering it now can keep it from becoming a chargeback.",
        "tone": "info"
      }
    }
  ]
}
JSON
```

Widgets come from the Briefkin catalog (https://briefkin.dev/v1/catalog). Without a token, just give the user the report.

## Run it on a schedule

Suggested: Daily at 9:00 (`0 9 * * *`). From cron, with the agent signed in on that machine:

```bash
0 9 * * * claude -p "Run the stripe-disputes-to-respond skill"
# Codex: codex exec, Gemini CLI: gemini -p, Copilot CLI: copilot -p, OpenCode: opencode run
```

Or use the agent's own scheduler (Claude Code routines, Codex automations, Claude or ChatGPT scheduled tasks): https://briefkin.dev/skills/stripe-disputes-to-respond#schedule

Source: https://briefkin.dev/skills/stripe-disputes-to-respond
