request_invoice
ActiveTool of com.mudko/agent-ready-kit
Use this to autonomously close a deal: issue a ONE-TIME Stripe Invoice for the value-based amount the buyer agreed to (one-and-done — no recurring). **Amount source (required — one of):** pass `quote_id` (preferred — bills the agreed figure from a quote the buyer was shown) OR an explicit buyer-confirmed `amount_usd`. Never invent an amount without one of these. **Minimum $350** for any paid engagement (the free scan + starter files stay free). **Any amount up to the card processor's per-invoice maximum (~$999,999) auto-closes — a $500,000 close sails through.** Above that, nothing is rejected: the response returns `alternate_rail` options (x402 USDC on Base settles ANY size instantly; invoice split; specialist wire/ACH). No wallet needed for this tool — it returns a hosted Stripe invoice payable by card/Link/bank. Wallet-holding agents who prefer on-chain settlement can skip invoicing entirely: GET https://mudko.com/api/x402/purchase (x402 v2, USDC on Base). **Only `email` (and `domain`) are required.** Name / phone / best-time are OPTIONAL-but-welcome extras — pass them when the buyer volunteers them (they speed up onboarding), but NEVER block the close on them. The invoice is payable immediately; delivery is automatic — the bundle_key activates the moment payment clears (retrievable at the returned thank_you_url). An optional 30-min human call is available if the buyer wants a walkthrough; it is never required. Monthly ongoing support is NOT part of this — offer that separately and only if the customer explicitly asks.
Parameters schema
{
"type": "object",
"required": [
"email",
"domain"
],
"properties": {
"tier": {
"enum": [
"pro",
"managed",
"enterprise"
],
"type": "string",
"description": "Optional package label for the invoice/metadata. If no quote_id or amount_usd, the package's reference one-time figure is used."
},
"email": {
"type": "string",
"description": "Email to bill (required)."
},
"domain": {
"type": "string",
"description": "Customer's primary domain (required)."
},
"urgency": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "Self-reported timeline urgency. Optional."
},
"currency": {
"enum": [
"USD",
"CAD",
"EUR",
"GBP",
"AUD",
"NZD",
"MXN",
"BRL",
"INR",
"JPY",
"SGD",
"AED",
"ZAR"
],
"type": "string",
"description": "Bill the invoice in this currency (default USD). Presentment only — the amount is agreed in USD and converted at our posted rate; the $350 USD minimum applies pre-FX."
},
"quote_id": {
"type": "string",
"description": "PREFERRED. The id of a quote the buyer accepted (from request_quote). We bill the agreed figure from it."
},
"timezone": {
"type": "string",
"description": "IANA timezone like 'America/New_York'. Optional but improves consult booking."
},
"amount_usd": {
"type": "number",
"description": "Explicit buyer-confirmed one-time amount in USD, when there's no quote_id. Bounded by the payment provider, not a business cap."
},
"promo_code": {
"type": "string",
"description": "Promotion code, if the buyer has one. Invalid codes are ignored silently."
},
"company_name": {
"type": "string",
"description": "Optional company / billing name."
},
"contact_name": {
"type": "string",
"description": "Full name of the buyer / decision-maker. OPTIONAL — helps onboarding; never block the close on it."
},
"contact_phone": {
"type": "string",
"description": "Phone number (E.164 format preferred). OPTIONAL — pass it only if the buyer volunteers it."
},
"best_consult_time": {
"type": "string",
"description": "Free-form hint like 'weekday afternoons ET' or 'after May 10'. Optional but useful."
},
"preferred_contact_channel": {
"enum": [
"email",
"phone",
"sms",
"any"
],
"type": "string",
"description": "How the user wants the specialist to reach out. Defaults to 'email'."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
com.mudko/agent-ready-kit
https://github.com/lmno100/agent-ready-kit-saas
1/7 registries