Home / Servers / Stripe API / post_credit_notes

Create a credit note

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Create a credit note Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice’s amount_remaining (and amount_due ), but not below zero. This amount is indicated by the… [POST /v1/credit_notes]

Name on the gateway: stripe_api__post_credit_notes · may change things.

Parameters

NameTypeDescription
amountintegerThe integer amount in cents (or local equivalent) representing the total…
credit_amountintegerThe integer amount in cents (or local equivalent) representing the amount to…
effective_atintegerThe date when this credit note is in effect. Same as created unless…
email_typecredit_note | noneType of email to send to the customer, one of credit_note or none and the…
expandarraySpecifies which fields in the response should be expanded.
invoice requiredstringID of the invoice.
linesarrayLine items that make up the credit note. One of amount, lines, or…
memostringThe credit note's memo appears on the credit note PDF.
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
out_of_band_amountintegerThe integer amount in cents (or local equivalent) representing the amount that…
reasonduplicate | fraudulent | order_change | product_unsatisfactoryReason for issuing this credit note, one of duplicate, fraudulent…
refund_amountintegerThe integer amount in cents (or local equivalent) representing the amount to…
refundsarrayRefunds to link to this credit note.
shipping_costobjectWhen shipping_cost contains the shipping_rate from the invoice, the…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__post_credit_notes",
  "arguments": {
    "invoice": "…"
  }
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a credit note tool with amount set to ….

More from Stripe API