RevampKeyRevampKey home
Download

Look up a Stripe customer with AI

Finds a customer in Stripe by email and explains their billing in plain words: plan, invoices, failed payments and decline reasons, refunds and disputes, ready to paste into a support reply. Read-only.

Read-onlyUses 4 Stripe toolsWorks in RevampKey, Claude Code, Codex and Cursor

Use in RevampKey

Get RevampKey to connect Stripe

RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Stripe is one click away with its skills already attached.

Download RevampKey

Not now? Use the skills in your current tool

curl -fsSL --create-dirs -o .claude/skills/stripe-customer-lookup/SKILL.md https://revampkey.com/marketplace/stripe/skills/customer-lookup/SKILL.md
Other agents
Other agents

When to use it

  • A customer writes in about a charge
  • "Why did my payment fail?" tickets
  • Checking someone's plan before a sales call

What it looks like

You

Why was ana@example.com charged twice this month?

stripe_api_readstripe_api_searchstripe_api_detailssearch_stripe_documentation
Agent

Live mode. She was not charged twice: the Nov 1 Pro renewal ($49) failed with insufficient_funds, and the Nov 3 automatic retry succeeded. Her bank may show the failed attempt as pending for a few days. Invoice in_1Q… is paid; no refund is needed.

The SKILL.md file

View raw
name: stripe-customer-lookup

Look up a customer in Stripe by email, name or id and summarise their subscriptions, invoices, payments, failed charges, refunds and disputes for a support reply. Use when the user asks about a customer's billing, why a payment failed, whether someone was charged, or what plan a customer is on.

Read-only.

Steps

  1. Confirm the account and mode. Find the customer: search customers by email with stripe_api_read on the customers search endpoint. Use stripe_api_search and stripe_api_details to confirm the endpoint and query syntax, such as email:'ana@example.com'. Several matches are common; list them with created dates and ask, or check each.
  2. For the chosen customer, read:
    • subscriptions: status, plan, price, current period end, cancel at period end, trial end;
    • the last few invoices: status, amount, paid or open, hosted invoice link;
    • recent charges or payment intents, including failures and their decline code;
    • refunds and disputes.
  3. Explain failures in plain words. For example, insufficient_funds means the bank declined it, while authentication_required means the customer must complete 3D Secure. Use search_stripe_documentation for unfamiliar decline codes.

Report

  • Who they are: name, email, customer id and since when.
  • Their plan and its status.
  • What happened, as a timeline of the relevant events.
  • What the customer can do next, phrased so it can go into a support reply.
  • Any write action, such as a refund or cancellation, is a separate request that needs approval; see the refunds skill.

Stripe tools it uses

  • stripe_api_read
  • stripe_api_search
  • stripe_api_details
  • search_stripe_documentation

Tool list from Stripe MCP documentation.

FAQ

Does it show card numbers?

No. Stripe only returns the card brand and last four digits, and the skill only shows what the question needs.

Can it refund the customer too?

Not this skill; it is read-only. Ask for a refund separately and approve the exact amount.