Documentation Index

Fetch the complete documentation index at: https://help.frisbii.com/llms.txt

Use this file to discover all available pages before exploring further.

MCP prompt guide + skills

Prev Next

Overview

The Frisbii MCP Connector is only as useful as the prompts you provide it. This guide shows how to structure a prompt so your assistant investigates before it acts, introduces three ready-made skills for the most common billing tasks, and includes example prompts for everything else.

Good to know

Prompts that trigger a tool that changes data (see Supported Frisbii MCP tools) affect your live account. Always let the assistant show you what it found and what it intends to do before you tell it to proceed.


How to write an effective prompt

The prompts that get the best results from the Frisbii MCP Connector generally follow the same shape:

  1. Identify the customer by name, email, or ID. If your prompt is ambiguous, ask the assistant to list the matching candidates rather than guess.

  2. State the goal in plain language — the complaint, the change you want, or the question you're asking.

  3. Set your own guardrails in the prompt where it matters, for example a refund limit, a maximum discount, or "don't cancel, just tell me the options." The connector doesn't enforce business policy for you — the assistant only applies the limits you give it, or the defaults built into a skill (see below).

  4. Ask for a preview first on anything that changes data — "show me what you'd do before doing it." This is optional but recommended, especially the first few times you try a new type of request.

  5. Ask for confirmation of the result — "verify it went through" — so the assistant reads back the updated state instead of assuming the action succeeded.


Packaged skills

A skill is a ready-made command that packages a full workflow — including guardrails and a built-in verification step — behind a single instruction. Instead of describing the whole process yourself, you invoke the skill by name and supply a few arguments; the assistant handles diagnosis, proposes a fix, waits for your confirmation, and verifies the result before summarizing what happened.

Note

The policy values shown for each skill below (refund limits, discount caps, and so on) are examples. State your own limits in the prompt if you want different ones for a given conversation — the skill applies whatever guardrails you give it.

Skills need to be created in the AI assistant directly.

/resolve-billing-issue

The support workhorse: takes a customer and a complaint in natural language, diagnoses the account, proposes the policy-compliant fix, executes it only after your confirmation, verifies the result, and produces a ticket-ready summary.

Argument

Description

customer

Customer handle, email, or ID (required)

complaint

The complaint in the customer's own words (required)

dry_run

If true, stop after proposing the fix (default: false)

Example default policy (state your own in the prompt to override):

  • Refund cap: €500 — above this, the skill escalates to a human instead of acting

  • Refund age limit: 90 days — older charges need your approval first

  • Goodwill coupon cap: 20%

How it works:

  1. Identifies the customer: If more than one match is found, it lists the candidates rather than guessing.

  2. Pulls the billing overview and classifies the complaint: duplicate charge, wrong invoice, charged after cancellation, payment failure, or a goodwill request.

  3. Checks the fix against policy. If it exceeds the refund cap or age limit, or the diagnosis is ambiguous, it stops and gives you a diagnosis plus an escalation note instead of acting.

  4. Proposes the exact fix, amount, and expected end state, and waits for your explicit confirmation before doing anything.

  5. Executes the single agreed fix, then reads back the result to verify it landed.

  6. Produces a ticket-ready summary.

Example interaction:

You: /resolve-billing-issue customer=acme-gmbh complaint="we were charged twice in July"

Assistant: Found ACME GmbH. Diagnosis: two charges on 3 July, 41 seconds apart, both against the same invoice — the second is a duplicate. Proposed fix: refund the duplicate charge, €249.00. Within the €500 cap. Proceed?

You: Yes

Assistant: Refunded €249.00. Verified: charge shows as refunded, credit note created, balance €0.00.
— Ticket summary: duplicate charge on the 3 July invoice, refunded in full, resolved. —

/save-customer

A retention flow for a customer who wants to cancel or is at risk of churning. It walks a save ladder — fix a problem first, then pause, then discount — and shows the billing impact before anything is applied.

Argument

Description

customer

Customer handle, email, or ID (required)

reason

Stated churn reason, if known (optional)

dry_run

If true, stop after recommending an offer (default: false)

Example default policy (state your own in the prompt to override):

  • Maximum discount: 25%

  • Maximum discount duration: 6 months

  • Maximum pause duration: 3 months

  • Save ladder order: fix an issue → pause → discount (a discount is never offered first if a cheaper rung fits)

How it works:

  1. Builds a picture of the account: subscription, payment history, dunning status, and any existing discounts.

  2. Classifies the churn driver: a billing problem, a temporary need gap, price sensitivity, or product dissatisfaction, and matches it to the cheapest rung of the ladder that fits.

  3. If the account already has an active save discount, it doesn't stack another, it escalates to a human instead.

  4. Shows the before/after: current price, price under the offer, duration, and what happens when the offer expires.

  5. Applies the agreed offer only after your confirmation, then verifies it's attached correctly.

  6. Summarizes the outcome with a follow-up date to calendar.

Example interaction:

You: /save-customer customer=nordwind-media reason="too expensive"

Assistant: Nordwind Media: €890/month, 26 months as a customer, no active discounts, no billing friction. Since this is a price objection, recommending 20% off for 6 months — €890 → €712/month, reverting on 2027-02-18. Within policy. Apply this offer?

You: Yes

Assistant: Applied. Verified: discount attached, next invoice previews at €712.00. Calendar a check-in for 2027-02-18.

/change-subscription

Handles upgrades, downgrades, add-on changes, pauses, resumes, and cancellations — always previewing the entitlement and billing impact first.

Argument

Description

customer

Customer handle, email, or ID (required)

change

Requested change in natural language (required)

effective

immediate | next-renewal (default: next-renewal)

dry_run

If true, stop after the preview (default: false)

Example default policy (state your own in the prompt to override):

  • Cancellations require a stated reason

  • Downgrades always list every entitlement the customer would lose, before asking for confirmation

How it works:

  1. Loads the current subscription, plan, add-ons, and any open balance.

  2. Resolves the target — the new plan, add-on, or the pause/resume/cancel operation requested.

  3. Builds a preview: the entitlement diff (features gained and lost), the billing impact (old vs. new price, proration, next invoice), and the timing.

  4. Waits for your explicit confirmation — cancellations always require a separate, explicit confirmation naming the subscription, never bundled with another change.

  5. Executes the single agreed change, then verifies the resulting plan, state, and add-ons match the preview.

  6. Summarizes the before/after.

Before cancelling for a price reason, the skill suggests trying /save-customer first.

Example interaction:

You: /change-subscription customer=acme-gmbh change="downgrade from Pro to Standard"

Assistant: ACME GmbH is on Pro (€249/month, renews 1 September), with one add-on. Standard is €99/month. Downgrading loses priority support, the higher API rate tier, and SSO; core features and reporting are kept. Billing: €299 → €149/month from the next renewal, no proration. Worth flagging the SSO loss to the customer. Proceed?

You: Yes

Assistant: Updated, effective at the next renewal. Verified: plan shows Standard, add-on intact, no proration invoice generated, as previewed.


More things you can ask

Not every task needs a packaged skill. Here are example prompts for other common jobs.

Customer support

Task

Example prompt

Fix a broken payment

"Find [customer]'s most recent failed payment, check why it failed, and tell me what you'd try to fix it."

Handle a double charge

"List [customer]'s charges from the last 30 days and flag any duplicates."

Dunning and revenue recovery

Task

Example prompt

Daily recovery sweep

"Show me all overdue or failed billing right now, and which ones look worth retrying today."

Review dunning plans

"List our dunning plans and show me the current dunning status for accounts on the Standard dunning plan."

Unblock stuck payments

"List blocked payments and tell me the likely cause for each one."

Finance and accounting

Task

Example prompt

Payout reconciliation

"Reconcile the payout for [date/window] and list anything that doesn't match, with the underlying charge or credit note for each mismatch."

Manual invoicing

"Check [customer]'s balance, then draft a one-off invoice for [amount/description] — show me the draft before creating it."

Invoice correction

"Find invoice [number], void it, and prepare a corrected invoice for [details] — walk me through both steps."

Product, pricing, and RevOps

Task

Example prompt

Launch a new plan

"Check the current catalogue for anything that would collide with a new [plan name] plan, then set it up with these entitlements: [list]. Read it all back afterward so I can confirm it matches."

Run a promotion

"Check for overlapping coupons, then create a coupon [terms] and apply it to [target subscriptions]. Confirm before applying to more than one account."

Price change rollout

"List subscriptions on the old [plan] plan, and propose how you'd migrate each to [new plan] — don't change anything yet."

Catalogue hygiene

"Audit our plans, add-ons, coupons, and entitlements for anything orphaned or expired, and list what you'd remove."

Sales and onboarding

Task

Example prompt

Provision a new customer

"Check if [name/email] already exists as a customer. If not, set them up with the [plan] plan plus [add-ons], and apply the coupon [code] we agreed with them. Confirm the first invoice looks right."

Custom deal setup

"Set [customer] up on the plan closest to [terms], and add a one-off charge of [amount] for the setup fee."