Home / Servers / Stripe API / post_topups

Create a top-up

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

Create a top-up Top up the balance of an account [POST /v1/topups]

Name on the gateway: stripe_api__post_topups · may change things.

Parameters

NameTypeDescription
amount requiredintegerA positive integer representing how much to transfer.
currency requiredstringThree-letter ISO currency code, in lowercase. Must be a supported currency.
descriptionstringAn arbitrary string attached to the object. Often useful for displaying to…
expandarraySpecifies which fields in the response should be expanded.
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
payment_methodstringThe ID of a PaymentMethod representing the payment method to be used for the…
payment_method_optionsobjectPayment method-specific configuration for this top-up.
sourcestringThe ID of a source to transfer funds from. For most users, this should be left…
statement_descriptorstringExtra information about a top-up for the source's bank statement. Limited to…
transfer_groupstringA string that identifies this top-up as part of a group.

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_topups",
  "arguments": {
    "amount": 0,
    "currency": "…"
  }
}

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 top-up tool with amount set to ….

More from Stripe API