{"serverId":"mcp-registry/io.github.aw3-technology/cred","tools":[{"name":"bulk_create_users","fixed":{"name":"bulk_create_users","description":"Create or update up to 1000 users in one call (one CRD for the batch). Returns counts of created/updated and per-row errors; a bad row does not fail the batch. A row's own signup_url/signup_host overrides the request-level signup_url. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["users"],"properties":{"users":{"type":"array","items":{"type":"object","required":["external_id"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"metadata":{"type":"object","description":"stripe_account_id is Cred-only: a value you send is silently dropped"},"signup_url":{"type":"string"},"external_id":{"type":"string"},"signup_host":{"type":"string"},"wallet_address":{"type":"string"},"signup_credit_type_id":{"type":"string"}}},"maxItems":1000,"description":"User rows"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"signup_url":{"type":"string","description":"Default signup URL for rows without their own"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":411,"tokensAfter":411},{"name":"buy_credits_x402","fixed":{"name":"buy_credits_x402","description":"MOVES MONEY: buy a project's credits by paying in stablecoin over x402. Call once without x402_payment to receive the payment requirements (returned as an error result containing the x402 PaymentRequired object), sign them with your wallet, then call again passing the base64 payment payload as x402_payment. Requires no API key — the payment is the credential — and costs no CRD.","inputSchema":{"type":"object","required":["project_id","credits"],"properties":{"credits":{"type":"number","description":"How many credits to buy (within the project's min/max)","exclusiveMinimum":0},"buyer_id":{"type":"string","description":"Identifier to credit (defaults to your paying wallet address)"},"buyer_name":{"type":"string","description":"Display name for the buyer record"},"project_id":{"type":"string","description":"Project selling the credits"},"buyer_email":{"type":"string","description":"Email to attach to the buyer record"},"x402_payment":{"type":"string","description":"Base64-encoded x402 PaymentPayload signed by your wallet"},"credit_type_id":{"type":"string","description":"Credit type to buy (defaults to the project's x402 credit type)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":332,"tokensAfter":332},{"name":"cancel_subscription","fixed":{"name":"cancel_subscription","description":"Cancel a subscription. By default it cancels at period end (credits already issued stay; no further renewals). at_period_end: false cancels immediately with no refund. With user_id/email instead of subscription_id, every live subscription of that customer is canceled. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Customer email (alternative to subscription_id)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID (alternative to subscription_id)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"at_period_end":{"type":"boolean","description":"Default true; false cancels now"},"subscription_id":{"type":"string","description":"Cred subscription ID or Stripe sub_… ID"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":358,"tokensAfter":358},{"name":"charge_saved_card","fixed":{"name":"charge_saved_card","description":"MOVES MONEY: charge a user's saved card off-session for one pack of a one-time pricing tier and credit it. idempotency_key is required; a retry with the same key never charges twice and returns the first outcome (replayed: true). Outcomes: 200 status succeeded (credits, new_balance); 202 status processing (not yet settled — retry later with the SAME key to check, never a new key); 402 status failed with code/decline_code (requires_action: true means the buyer must pay through checkout instead). ","inputSchema":{"type":"object","required":["user_id","pricing_tier_id","idempotency_key"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the card holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type to grant. Required when the tier allows several types (400 CREDIT_TYPE_REQUIRED otherwise)"},"idempotency_key":{"type":"string","maxLength":255,"description":"Unique key for this charge (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY_KEY_REUSED. Generate a fresh key (e.g. a UUID) per intended operation and reuse it only to retry that operation."},"pricing_tier_id":{"type":"string","description":"One-time (or both) pricing tier to buy"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":487,"tokensAfter":487},{"name":"create_checkout_session","fixed":{"name":"create_checkout_session","description":"Create a Stripe Checkout link for an end user to buy credits; returns checkout_url and session_id. Nothing is charged until the buyer pays on that page; credits are issued when payment completes. Price either a pricing tier (pricing_tier_id, optionally × quantity) or a custom amount (credit_type_id + amount credits, priced at the credit type's exchange_rate). billing: \"recurring\" creates a subscription (tier required; billing_type recurring or both), credited on every paid invoice; otherwise it ","inputSchema":{"type":"object","required":["user_id"],"properties":{"amount":{"type":"number","description":"Custom-amount checkout: number of credits to sell","exclusiveMinimum":0},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"billing":{"enum":["one_time","recurring"],"type":"string","description":"Default one_time"},"user_id":{"type":"string","description":"External user ID of the buyer (created if new)"},"quantity":{"type":"integer","maximum":10000,"minimum":1,"description":"Tier packs (or seats for a subscription); default 1"},"user_name":{"type":"string","description":"Buyer display name"},"cancel_url":{"type":"string","description":"Redirect if the buyer cancels, on an allowed domain (else Cred's default page, no error)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"signup_url":{"type":"string","description":"App/page URL the buyer came from (attribution)"},"user_email":{"type":"string","description":"Buyer email (prefills Checkout, matched first)"},"success_url":{"type":"string","description":"Redirect after payment, on an allowed domain (else Cred's default page, no error)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type to grant. Required with amount, and with a tier that allows several types (400 CREDIT_TYPE_REQUIRED otherwise)."},"pricing_tier_id":{"type":"string","description":"Tier to sell"},"save_payment_method":{"type":"boolean","description":"Save the card for off-session charges (one-time checkouts only)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":644,"tokensAfter":644},{"name":"create_escrow_hold","fixed":{"name":"create_escrow_hold","description":"Reserve credits: deducts amount from an existing user and parks it in a hold (status held), returning hold_id. Finish with capture_escrow_hold or release_escrow_hold; a hold past expires_at can be released back at any time. Pass idempotency_key on anything an agent might retry: a replay returns the original hold (idempotent_replay: true, with its current status) and holds nothing more; the same key on a different request is 409 IDEMPOTENCY_KEY_REUSED. Without a key every call places another hold","inputSchema":{"type":"object","required":["credit_type_id","amount"],"properties":{"amount":{"type":"number","description":"Credits to hold","exclusiveMinimum":0},"reason":{"type":"string"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the holder"},"metadata":{"type":"object"},"expires_at":{"type":"string","description":"ISO timestamp after which the hold can be released back to the holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"user_email":{"type":"string","description":"Holder email (checked first)"},"reference_id":{"type":"string","description":"Your reference, e.g. an order ID (filterable in list_escrow_holds)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type to hold"},"idempotency_key":{"type":"string","maxLength":255,"description":"Unique key for this hold (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY_KEY_REUSED. Generate a fresh key (e.g. a UUID) per intended operation and reuse it only to retry that operation."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":555,"tokensAfter":555},{"name":"create_pricing_tier","fixed":{"name":"create_pricing_tier","description":"Create a pricing tier. credits must be a positive integer; price (USD) must be 0 or at least 0.50, and at most $1.00 per credit. credit_type_ids lists the credit types a tier can be bought for; [] means every active credit type. Omit credit_type_ids for all types; malformed or foreign ids are rejected. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["name","credits","price"],"properties":{"name":{"type":"string","description":"Tier name"},"price":{"type":"number","minimum":0,"description":"Price in dollars"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"credits":{"type":"integer","minimum":1,"description":"Credits granted per purchase"},"currency":{"type":"string","description":"Currency code (default USD)"},"is_popular":{"type":"boolean","description":"Highlight as popular"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"description":{"type":"string","description":"Tier description"},"billing_type":{"enum":["one_time","recurring","both"],"type":"string","description":"Which checkouts may sell the tier. A subscription is created only when checkout is sent billing: \"recurring\"; recurring-only tiers cannot be used for saved-card charges or auto top-up. Default one_time."},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_ids":{"type":"array","items":{"type":"string"},"description":"Credit type UUIDs; omit or [] = all"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":507,"tokensAfter":507},{"name":"create_subscription_portal_link","fixed":{"name":"create_subscription_portal_link","description":"Create a short-lived Stripe customer portal URL for a subscriber to update their card (flow payment_method_update, default) or see invoices and card (overview). Mint it when the customer asks; don't store it. With user_id/email, uses their most recent subscription. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"flow":{"enum":["payment_method_update","overview"],"type":"string"},"email":{"type":"string","description":"Customer email (alternative to subscription_id)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID (alternative to subscription_id)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"return_url":{"type":"string","description":"URL to return to from the portal; must be https on a Cred host or a domain listed under Dashboard → Payments → Allowed redirect domains, else 400 REDIRECT_NOT_ALLOWED"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"subscription_id":{"type":"string","description":"Cred subscription ID or Stripe sub_… ID"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":416,"tokensAfter":416},{"name":"create_user","fixed":{"name":"create_user","description":"Create an end user, or return/update the existing one (email-first lookup, then external_id, so no duplicates). Returns created: true for a new user. Signup attribution is first-touch and optional: signup_url (else the connection's x-app-origin header) is recorded on a new user, or on an existing user that has none. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["external_id"],"properties":{"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"User email"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"metadata":{"type":"object","description":"Arbitrary metadata; stripe_account_id is Cred-only: a value you send is silently dropped"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"signup_url":{"type":"string","description":"App/page URL the user signed up from, e.g. https://app1.example.com/signup"},"external_id":{"type":"string","description":"Your user ID"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"wallet_address":{"type":"string","description":"0x EVM address to record as asserted (not verified)"},"signup_credit_type_id":{"type":"string","description":"Credit type the user signed up for (cross-app attribution)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":456,"tokensAfter":456},{"name":"delete_auto_topup","fixed":{"name":"delete_auto_topup","description":"Delete a user's auto top-up rule for credit_type_id, or ALL their rules when credit_type_id is omitted. Returns the number deleted. To pause instead, save_auto_topup with enabled: false. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["user_id"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the card holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type UUID (omit to delete every rule for the user)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":294,"tokensAfter":294},{"name":"delete_pricing_tier","fixed":{"name":"delete_pricing_tier","description":"Permanently delete a pricing tier by id (404 if not in this project). While auto top-up rules buy the tier it refuses with 409 TIER_IN_USE and the rule count; pass force: true (after the user confirms) to delete those rules and the tier together. Deactivating a tier (update_pricing_tier is_active: false) keeps history but makes its auto top-up charges fail. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results includ","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Pricing tier ID"},"force":{"type":"boolean","description":"Also delete the auto top-up rules that buy this tier"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":321,"tokensAfter":321},{"name":"delete_saved_payment_method","fixed":{"name":"delete_saved_payment_method","description":"Remove a user's saved card (detached in Stripe). charge_saved_card and auto top-up stop working for them until a new card is saved. Returns deleted: false if there was none. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["user_id"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the card holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":263,"tokensAfter":263},{"name":"delete_user","fixed":{"name":"delete_user","description":"Delete an end user, identified by user_email (checked first) or external_id. Irreversible: balances, ledger and auto top-up rules go with them. A user with swap history is kept as a financial record — 409 USER_HAS_HISTORY (swap_transactions count). 404 USER_NOT_FOUND. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"user_email":{"type":"string","description":"Email of the user to delete"},"external_id":{"type":"string","description":"External ID of the user to delete"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":300,"tokensAfter":300},{"name":"execute_swap","fixed":{"name":"execute_swap","description":"Swap a user's credits along a swap pair: deducts source_amount of the source type and credits the converted amount (after fee) in the target type. Errors: 400 INSUFFICIENT_CREDITS, 404 USER_NOT_FOUND, 400 outside min/max. On a bidirectional pair, direction \"reverse\" spends the target type for the source type at 1/rate (else 400 SWAP_NOT_BIDIRECTIONAL). Pass an idempotency_key so a retry replays the original swap (idempotent_replay: true); the same key on a different request is 409 IDEMPOTENCY_KE","inputSchema":{"type":"object","required":["swap_pair_id","source_amount"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID"},"direction":{"enum":["forward","reverse"],"type":"string","description":"Default forward"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"user_email":{"type":"string","description":"User email (alternative)"},"swap_pair_id":{"type":"string","description":"Swap pair ID"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"source_amount":{"type":"number","description":"Credits to spend (in the target type when direction is reverse)","exclusiveMinimum":0},"idempotency_key":{"type":"string","maxLength":255,"description":"Unique key for this swap (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY_KEY_REUSED. Generate a fresh key (e.g. a UUID) per intended operation and reuse it only to retry that operation."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":508,"tokensAfter":508},{"name":"get_auto_topup","fixed":{"name":"get_auto_topup","description":"Get a user's auto top-up rule for credit_type_id (auto_topup, or null), or all their rules (auto_topups) when credit_type_id is omitted, plus their saved card. Rules show threshold, enabled, max_per_day, charges_last_24h, last_status/last_error and disabled_reason (set when cred turned a failing rule off). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["user_id"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the card holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type UUID"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":315,"tokensAfter":315},{"name":"get_balance","fixed":{"name":"get_balance","description":"Get a user's credit balance(s). Identify the user by email (checked first) or user_id (your external user ID). An unknown user returns an empty balances array, not an error. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"User email (checked first)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID (fallback)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Only this credit type"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":289,"tokensAfter":289},{"name":"get_referral_settings","fixed":{"name":"get_referral_settings","description":"Get a referral program's settings (is_active, referrer/referee credits, credit type). A project can run one program per credit type: pass credit_type_id for that credit type's program (settings null when it has none); omit it for the project's default program. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type whose program to read"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":280,"tokensAfter":280},{"name":"get_saved_payment_method","fixed":{"name":"get_saved_payment_method","description":"Get the card saved for a user (brand, last4, expiry), or payment_method: null if none. Cards are saved by a one-time create_checkout_session with save_payment_method: true. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["user_id"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID of the card holder"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":262,"tokensAfter":262},{"name":"get_signup_analytics","fixed":{"name":"get_signup_analytics","description":"Signup attribution breakdown per signup_host (which of your apps users came from): users, purchases and revenue per host over the last `days` (default 30; 0 = all time). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"days":{"type":"number","minimum":0,"description":"Look-back window in days (default 30, 0 = all time)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":260,"tokensAfter":260},{"name":"get_transactions","fixed":{"name":"get_transactions","description":"List ledger transactions, newest first (types include issue, deduct, refund). Filter by user (email or user_id) and credit_type_id; paginate with limit/offset. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Filter by user email"},"limit":{"type":"number","description":"Results per page (max 100, default 50)"},"offset":{"type":"number","description":"Pagination offset (default 0)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"Filter by external user ID"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Filter by credit type"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":327,"tokensAfter":327},{"name":"get_user_wallet","fixed":{"name":"get_user_wallet","description":"Read the EVM address on file for an end user, and whether the holder proved it by signature (verified, verified_at). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"User email (checked first)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"external_id":{"type":"string","description":"External user ID"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":252,"tokensAfter":252},{"name":"get_users","fixed":{"name":"get_users","description":"Look up one end user by email or external_id (404 USER_NOT_FOUND if absent), or list users newest first with total, filterable by signup_host / signup_credit_type_id. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Look up by email"},"limit":{"type":"number","description":"Results per page (max 1000, default 100)"},"offset":{"type":"number","description":"Pagination offset (default 0)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"external_id":{"type":"string","description":"Look up by external ID"},"signup_host":{"type":"string","description":"List only users who signed up from this host, e.g. app1.example.com"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"signup_credit_type_id":{"type":"string","description":"List only users attributed to this credit type"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":368,"tokensAfter":368},{"name":"list_credit_types","fixed":{"name":"list_credit_types","description":"List the project's active credit types: id, name, symbol, description, exchange_rate (USD per credit), is_redeemable, and on-chain fields (is_on_chain, blockchain, contract_address, chain_id, token_decimals, mint_on_issue, deployment_type). Use the id as credit_type_id in other tools. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":262,"tokensAfter":262},{"name":"list_deposits","fixed":{"name":"list_deposits","description":"List on-chain token deposits observed for the project, newest first (read-only; the chain ingest writes them). status: credited (credits granted), unattributed (sent from an address no user had; held, not credited, and attaching the address with set_user_wallet only matches later deposits), observed (awaiting processing) or rejected. A user filter for an unknown user is 404 USER_NOT_FOUND. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED cos","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Filter by user email"},"limit":{"type":"number","description":"Results per page (max 200, default 50)"},"offset":{"type":"number","description":"Pagination offset"},"status":{"enum":["observed","credited","unattributed","rejected"],"type":"string"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"Filter by external user ID"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Filter by credit type"},"transaction_hash":{"type":"string","description":"Find one deposit by transaction hash"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":418,"tokensAfter":418},{"name":"list_escrow_holds","fixed":{"name":"list_escrow_holds","description":"List escrow holds, newest first, with total. Filter by status, holder or reference_id. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Holder email"},"limit":{"type":"number","description":"Max 100, default 50"},"offset":{"type":"number"},"status":{"enum":["held","released","captured","expired"],"type":"string"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"Holder external ID"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"reference_id":{"type":"string"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":295,"tokensAfter":295},{"name":"list_pricing_tiers","fixed":{"name":"list_pricing_tiers","description":"List active pricing tiers (credit packs), cheapest first; price is a dollar string. credit_type_ids lists the credit types a tier can be bought for; [] means every active credit type. The credit_type_id filter returns every tier purchasable for that type: tiers scoped to it plus tiers with [] (400 if it is not a UUID). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type UUID: tiers scoped to it plus all-type tiers"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":302,"tokensAfter":302},{"name":"list_referrals","fixed":{"name":"list_referrals","description":"List the project's referrals, filterable by status, referrer or credit type (program). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Results per page (max 100, default 50)"},"offset":{"type":"number","description":"Pagination offset"},"status":{"type":"string","description":"Filter by status"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Only this credit type's program"},"referrer_email":{"type":"string","description":"Filter by referrer email"},"referrer_user_id":{"type":"string","description":"Filter by referrer external ID"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":330,"tokensAfter":330},{"name":"list_subscriptions","fixed":{"name":"list_subscriptions","description":"List recurring credit subscriptions (newest 100): status, credits_per_period, quantity, price, interval, current_period_end, cancel_at_period_end. status: \"active\" matches active, trialing and past_due. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Filter by customer email"},"status":{"type":"string","description":"active (live states) or an exact Stripe status, e.g. canceled"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"Filter by external user ID"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":308,"tokensAfter":308},{"name":"list_swap_pairs","fixed":{"name":"list_swap_pairs","description":"List credit swap pairs (exchange_rate, fee_percent, min/max_swap_amount, is_bidirectional). Optionally filter by source or target credit type. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"include_inactive":{"type":"boolean","description":"Include inactive pairs"},"source_credit_type_id":{"type":"string","description":"Filter by source credit type"},"target_credit_type_id":{"type":"string","description":"Filter by target credit type"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":292,"tokensAfter":292},{"name":"list_x402_receipts","fixed":{"name":"list_x402_receipts","description":"List this project's x402 stablecoin payments, newest first: kind, status, payer, amount_usd, transaction_hash, credits_granted, error. Authenticated (API key). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","description":"Max 200, default 50"},"status":{"type":"string","description":"Filter by status, settled, pending or failed"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":269,"tokensAfter":269},{"name":"onboard_payout_account","fixed":{"name":"onboard_payout_account","description":"Create (or reuse) a Stripe Express connected account for an end user and return an onboarding URL for them to complete. The resulting stripe_account_id (acct_…) is stored on the user; pass it as destination to redeem_credits. return_url and refresh_url must be https on a Cred host or a domain listed under Dashboard → Payments → Allowed redirect domains, else 400 REDIRECT_NOT_ALLOWED. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs not","inputSchema":{"type":"object","required":["return_url","refresh_url"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"country":{"type":"string","description":"ISO country code for the account (default US)"},"user_id":{"type":"string","description":"External user ID"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"return_url":{"type":"string","description":"Where Stripe sends the user after onboarding"},"user_email":{"type":"string","description":"User email (alternative)"},"refresh_url":{"type":"string","description":"Where Stripe sends the user if the link expired"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":400,"tokensAfter":400},{"name":"refund_credits","fixed":{"name":"refund_credits","description":"Refund or reverse credits. MOVES MONEY for purchases: with purchase_id or stripe_payment_intent_id it refunds the Stripe charge (prorated when partial; refund_payment: false skips the money) and claws the purchased credits back. With transaction_id (or reference_id = latest matching transaction) it reverses that ledger entry: an issue is clawed back, a deduct is returned to the user. Pass exactly one source. amount refunds part (default: all). idempotency_key is required here: retry with the sam","inputSchema":{"type":"object","required":["idempotency_key"],"properties":{"amount":{"type":"number","description":"Credits to refund (default: the full original amount)","exclusiveMinimum":0},"reason":{"type":"string","description":"Reason, shown in the ledger"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"metadata":{"type":"object","description":"Extra metadata stored on the refund transaction"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"purchase_id":{"type":"string","description":"Cred purchase ID (refunds the payment + credits)"},"reference_id":{"type":"string","description":"Reverse the latest non-refund transaction with this reference_id"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"refund_payment":{"type":"boolean","description":"Purchases only: false reverses credits without refunding money (default true)"},"transaction_id":{"type":"string","description":"Ledger transaction ID to reverse"},"idempotency_key":{"type":"string","maxLength":255,"description":"Unique key for this refund (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY_KEY_REUSED. Generate a fresh key (e.g. a UUID) per intended operation and reuse it only to retry that operation."},"stripe_payment_intent_id":{"type":"string","description":"Stripe pi_… of the purchase (alternative to purchase_id)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":617,"tokensAfter":617},{"name":"save_referral_settings","fixed":{"name":"save_referral_settings","description":"Create or update a referral program: credits awarded to the referrer and to the referred user. With credit_type_id this writes THAT credit type's program (creating it if needed); without it, the project's default program. Only fields you pass change. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"is_active":{"type":"boolean","description":"Enable/disable the program"},"is_default":{"type":"boolean","description":"true makes this program the default — the one requests without credit_type_id use (only true is accepted)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_id":{"type":"string","description":"Credit type whose program to write (and award)"},"referee_credits":{"type":"number","minimum":0,"description":"Credits for the referred user"},"referrer_credits":{"type":"number","minimum":0,"description":"Credits for the referrer"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":396,"tokensAfter":396},{"name":"set_user_wallet","fixed":{"name":"set_user_wallet","description":"Attach an EVM address to an end user so on-chain credits mint to them. No signature required — the address is recorded as asserted by the operator, not proved (changing it clears any earlier verification). Only later deposits match it: a deposit already recorded as unattributed stays uncredited. Pass wallet_address as null to detach; balances are unaffected. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results inclu","inputSchema":{"type":"object","required":["wallet_address"],"properties":{"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"user_email":{"type":"string","description":"User email (checked first)"},"external_id":{"type":"string","description":"External user ID"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"wallet_address":{"type":["string","null"],"description":"0x-prefixed 40-hex-character EVM address, or null to detach"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":353,"tokensAfter":353},{"name":"update_pricing_tier","fixed":{"name":"update_pricing_tier","description":"Update a pricing tier by id; only fields you pass change (same price rules as create). Pass credit_type_ids to re-scope it ([] = all credit types), is_active: false to stop selling it without deleting. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Pricing tier ID"},"name":{"type":"string"},"price":{"type":"number","minimum":0,"description":"Price in dollars"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"credits":{"type":"integer","minimum":1},"currency":{"type":"string"},"is_active":{"type":"boolean","description":"Whether the tier can be purchased"},"is_popular":{"type":"boolean"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"description":{"type":"string"},"billing_type":{"enum":["one_time","recurring","both"],"type":"string","description":"Which checkouts may sell the tier. A subscription is created only when checkout is sent billing: \"recurring\"; recurring-only tiers cannot be used for saved-card charges or auto top-up."},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"credit_type_ids":{"type":"array","items":{"type":"string"},"description":"Credit type UUIDs; [] = all"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":452,"tokensAfter":452},{"name":"update_subscription_quantity","fixed":{"name":"update_subscription_quantity","description":"Change a live subscription's quantity (seats/packs, 1–10000). CHANGES FUTURE BILLING: from the next renewal the customer pays unit price × quantity and receives unit credits × quantity; no proration now. With user_id/email the customer must have exactly one live subscription (else 409 — pass subscription_id). Same quantity is a no-op. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it ","inputSchema":{"type":"object","required":["quantity"],"properties":{"email":{"type":"string","description":"Customer email (alternative to subscription_id)"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"user_id":{"type":"string","description":"External user ID (alternative to subscription_id)"},"quantity":{"type":"integer","maximum":10000,"minimum":1,"description":"New quantity"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"subscription_id":{"type":"string","description":"Cred subscription ID or Stripe sub_… ID"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":384,"tokensAfter":384},{"name":"update_user","fixed":{"name":"update_user","description":"Update an existing end user (identify by user_email, checked first, or external_id). Only fields you pass change (none at all is 400 NO_FIELDS_TO_UPDATE); metadata replaces the whole object, except referral_code (kept unless you send it) and stripe_account_id (Cred-only: the stored value stays and a value you send is silently dropped). signup_* fields overwrite attribution (use to correct it). 404 USER_NOT_FOUND. To change a wallet use set_user_wallet. Costs 1 CRD (platform credit) per call, cha","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"New name"},"email":{"type":"string","description":"New email"},"api_key":{"type":"string","description":"Cred API key (optional if set via the x-api-key header)"},"metadata":{"type":"object","description":"New metadata (replaces existing)"},"project_id":{"type":"string","description":"Cred project ID (optional; the API key already identifies the project)"},"signup_url":{"type":"string","description":"Corrected signup URL (also re-derives signup_host)"},"user_email":{"type":"string","description":"Current email of the user to update"},"external_id":{"type":"string","description":"External ID of the user to update"},"signup_host":{"type":"string","description":"Corrected signup host"},"x402_payment":{"type":"string","description":"Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD"},"signup_credit_type_id":{"type":"string","description":"Corrected signup credit type"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":439,"tokensAfter":439}],"toolsChanged":37,"tokensSaved":0,"todo":[{"tool":"capture_escrow_hold","params":["reason","metadata"]},{"tool":"create_escrow_hold","params":["reason","metadata"]},{"tool":"create_subscription_portal_link","params":["flow"]},{"tool":"list_deposits","params":["status"]},{"tool":"list_escrow_holds","params":["offset","status","reference_id"]},{"tool":"release_escrow_hold","params":["reason"]},{"tool":"update_pricing_tier","params":["name","credits","currency","is_popular","description"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}