add_credits

Free

Initiates a credit purchase using the payment method on file. Credits are added immediately upon successful payment. Minimum purchase is $10, maximum is $1,000 per transaction.

Parameters

Name	Type	Required	Description
session_token	string	Required	The session token from start_session
amount_usd	number	Required	Amount in USD to add (min: 10, max: 1000)

Returns

Name	Type	Description
credits_added	number	Number of credits added
credits_available	number	New credit balance
transaction_id	string	Payment transaction ID

Example

typescript

const result = await mcp.callTool("add_credits", {
  session_token: "sess_xyz789...",
  amount_usd: 50
});
 
console.log(result.credits_added);  // 50000 (1 credit = $0.001)
console.log(result.credits_available);  // 99800

Notes

Minimum purchase: $10 (10,000 credits)
Maximum purchase: $1,000 (1,000,000 credits)
Requires payment method on file