Home / Servers / Stripe API / post_invoices
Create an invoice
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Create an invoice This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you finalize the invoice, which allows you to pay or send the invoice to your customers. [POST /v1/invoices]
Name on the gateway: stripe_api__post_invoices · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
account_tax_ids | array | The account tax IDs associated with the invoice. Only editable when the… |
application_fee_amount | integer | A fee in cents (or local equivalent) that will be applied to the invoice and… |
auto_advance | boolean | Controls whether Stripe performs automatic collection of the invoice. If… |
automatic_tax | object | Settings for automatic tax lookup for this invoice. |
automatically_finalizes_at | integer | The time when this invoice should be scheduled to finalize (up to 5 years in… |
collection_method | charge_automatically | send_invoice | Either charge_automatically, or send_invoice. When charging automatically… |
currency | string | The currency to create this invoice in. Defaults to that of customer if not… |
custom_fields | array | A list of up to 4 custom fields to be displayed on the invoice. |
customer | string | The ID of the customer to bill. |
customer_account | string | The ID of the account to bill. |
days_until_due | integer | The number of days from when the invoice is created until it is due. Valid… |
default_payment_method | string | ID of the default payment method for the invoice. It must belong to the… |
default_source | string | ID of the default payment source for the invoice. It must belong to the… |
default_tax_rates | array | The tax rates that will apply to any line item that does not have tax_rates set. |
description | string | An arbitrary string attached to the object. Often useful for displaying to… |
discounts | array | The coupons and promotion codes to redeem into discounts for the invoice. If… |
due_date | integer | The date on which payment for this invoice is due. Valid only for invoices… |
effective_at | integer | The date when this invoice is in effect. Same as finalized_at unless… |
expand | array | Specifies which fields in the response should be expanded. |
footer | string | Footer to be displayed on the invoice. |
from_invoice | object | Revise an existing invoice. The new invoice will be created in status=draft.… |
issuer | object | The connected account that issues the invoice. The invoice is presented with… |
metadata | object | Set of key-value pairs that you can attach to an object. This can be useful… |
number | string | Set the number for this invoice. If no number is present then a number will be… |
on_behalf_of | string | The account (if any) for which the funds of the invoice payment are intended.… |
payment_settings | object | Configuration settings for the PaymentIntent that is generated when the… |
pending_invoice_items_behavior | exclude | include | How to handle pending invoice items on invoice creation. Defaults to exclude… |
rendering | object | The rendering-related settings that control how invoices render in… |
shipping_cost | object | Settings for the cost of shipping for this invoice. |
shipping_details | object | Shipping details for the invoice. The Invoice PDF will use the… |
statement_descriptor | string | Extra information about a charge for the customer's credit card statement. It… |
subscription | string | The ID of the subscription to invoice, if any. If set, the created invoice… |
transfer_data | object | If specified, the funds from the invoice will be transferred to 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:
{
"name": "stripe_api__post_invoices",
"arguments": {}
}Or connect the Stripe API server directly, which lists 606 tools including this one:
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 an invoice tool with account_tax_ids set to ….