build_proposal
ChatGPTGenerate and persist AI-written narrative on the current private proposal draft using Proproval's external AI processing. The call may replace existing manual narrative only after explicit overwrite confirmation. It preserves financials and never publishes, sends, invoices, or charges.
create_catalog_service
ChatGPTCreate one explicitly confirmed reusable seller catalog service after checking for duplicates. The call persists catalog data and may return existing catalog matches instead of creating a duplicate. It does not alter proposals, clients, invoices, or public state.
create_invoice
ChatGPTCreate a standalone draft invoice for an existing or explicitly confirmed new Proproval client. Always call resolve_client first. If it returns the intended client, copy its exact clientRef. If it returns no intended match, an explicit request to create this private invoice for that named client confirms creating the new client in the same transaction; otherwise ask. Use newClient with the exact supplied name and only supplied email, phone, address, or company values. Never invent contact details. Client and invoice creation are one idempotent authoritative transaction, so an exact retry cannot duplicate either record. Resolve catalog services where applicable and use custom items only when the seller explicitly supplied and confirmed their names and prices. Proproval calculates subtotal, discount, tax, total, and cent rounding. An explicit request to create this private draft with the supplied client, item and price is creation confirmation; do not ask the same question again. Ask only for genuinely missing currency/tax or ambiguous client details. Custom items do not require prior catalog creation. After saving, show the authoritative totals and offer a private preview. Publishing or delivery still requires separate explicit approval. This tool never creates a fake proposal or approval, never creates a client link, never sends delivery, never marks paid, and never calls Stripe.
create_invoice_from_proposal
ChatGPTCreate or reuse a private draft invoice from the exact current authoritative proposal version after explicit seller confirmation. Financials come from the immutable proposal snapshot and exact retries do not duplicate the invoice. This does not record client approval, publish, send, mark paid, or call Stripe.
create_invoice_link
ChatGPTPublish or reuse a client-facing payment URL for an existing invoice after a fresh read and explicit seller confirmation. This exposes the immutable invoice externally and does not itself send delivery, record payment, or call Stripe Checkout. Exact retries reuse the same link.
create_payment_setup_link
ChatGPTCreate or resume a short-lived Stripe-hosted setup handoff after the seller explicitly asks to connect Stripe. Stripe collects identity, bank, and verification details outside ChatGPT, and the call may create external Stripe setup state. It does not create an invoice, payment, or charge.
create_proposal_draft
ChatGPTCreate one private proposal draft for an exact existing client or an explicitly confirmed new client, using resolved catalog refs or confirmed custom items. This may read catalog/client data and create the new client within the idempotent transaction. It never publishes, sends, invoices, pays, or creates a public URL.
create_proposal_link
ChatGPTPublish or reuse the immutable current proposal version at a client-facing public URL. Use only after a fresh proposal read and explicit seller confirmation because the public version cannot be edited in place. This does not email, message, approve, invoice, or charge.
create_sample_quote
ChatGPTRender a transient Sample / Demo PDF from the seller's confirmed defaults. Use to preview Proproval before creating a real quote. This does not persist business records, publish a link, or start an external workflow.
get_invoice
ChatGPTRead one sanitized seller-owned invoice with stable refs, immutable financials, payment status, and client-link state. Use before invoice updates, voiding, publication, or delivery. This does not change invoice or payment state.
get_onboarding_status
ChatGPTRead the connected seller's bounded Proproval account and progressive onboarding readiness. The response preserves the established account, readiness, businessProfile, paymentSetup, workflowState, and primaryNextAction contract and also exposes businessIdentity for business name, business type, account email, phone, and skippable website; quoteDefaults for currency and explicit tax status; optionalEnrichment; minimumQuoteReady; blocking; optional; and learnedLater. Use known values instead of re-asking. Ask only for the authenticated account context, currency and tax needed for the requested private draft. A missing account default can be supplied by an explicit per-draft choice or a single verified service currency; do not force updating account defaults. Business name/type can be completed during review; do not block a private draft on them. Respect invoice intent and use create_invoice directly without a proposal. Do not ask for phone or website before saving the first draft. Reuse verified values and facts already supplied by the user. Once minimumQuoteReady is true, clearly say the seller can create a first private quote immediately; website, catalog, business description, customer priorities, differentiators, service area, quoting workflow, and payment setup are optional or learned later. Never infer tax registration or rate from location. When payment preference is missing, explain concisely: You can send quotes and invoices without online payment, use an existing payment link such as PayPal or Square, or I can help you connect Stripe for integrated card payments and automatic payment tracking. Never ask for a Proproval password in chat. Authentication and account creation happen only on Proproval's secure OAuth page. This read-only tool returns no credentials, bank details, Stripe identifiers, client PII, proposal data, invoices, payments, or catalog records.
get_proposal
ChatGPTRead the sanitized current version of one exact seller-owned proposal, including stable line-item refs, pricing, terms, readiness, and stored narrative. Use before editing, building, rendering, or publishing. This does not regenerate content or change state.
get_proposal_pdf
ChatGPTRender the authoritative current seller-owned proposal as an embedded private PDF. Use for review after reading the proposal; viewing the PDF does not publish, create a client link, count a client view, or change proposal state.
list_clients
ChatGPTList minimal seller-owned client choices with opaque refs and contact-presence flags. Use for browsing or selecting a client, and paginate only when needed. This does not return contact values or modify records.
list_invoices
ChatGPTList minimal seller-owned invoice choices, optionally for one exact clientRef or status. Use the returned invoiceRef for follow-up actions and ask the seller to choose when needed. This does not return payment credentials or change state.
list_proposal_activity
ChatGPTRead bounded seller-owned proposal view, approval, and payment activity with an opaque cursor. Client views exclude owner preview, private PDF rendering, MCP reads, and workspace views. This does not mark events read or change proposal, invoice, or payment state.
list_proposals
ChatGPTList minimal seller-owned proposal choices, optionally for one exact clientRef. Use the returned proposalRef for follow-up actions and ask the seller to choose when several proposals match. This does not return client contact data or change state.
prepare_invoice_email
ChatGPTCreate a short-lived external email handoff for an existing client-accessible invoice. Use only when the seller asks to prepare email delivery. The handoff starts a user-controlled compose workflow but does not send a message or create a client link.
prepare_invoice_whatsapp
ChatGPTCreate a short-lived external WhatsApp handoff for an existing client-accessible invoice. Use only when the seller asks to prepare WhatsApp delivery. The handoff starts a user-controlled compose workflow but does not send a message or create a client link.
prepare_proposal_email
ChatGPTCreate a short-lived external email handoff for the active published proposal and saved client email. Use only when the seller asks to prepare email delivery. The handoff starts a user-controlled compose workflow but does not send a message or publish a proposal.
prepare_proposal_whatsapp
ChatGPTCreate a short-lived external WhatsApp handoff for the active published proposal and saved client phone. Use only when the seller asks to prepare WhatsApp delivery. The handoff starts a user-controlled compose workflow but does not send a message or publish a proposal.
resolve_client
ChatGPTFind minimal seller-owned client matches for a specific name or query. Use the returned clientRef only when the match is unambiguous; otherwise ask the seller to choose. This does not create or modify a client.
search_services
ChatGPTSearch seller-owned and canonical catalog services and return minimal matches with reusable service refs. Use before adding a catalog item or deciding that a confirmed custom item is required. This does not modify the catalog or a proposal.
set_proposal_brief
ChatGPTPersist confirmed client-facing goals, preferences, and positioning on the current private proposal draft. The call may replace or clear an existing brief; do not store sensitive internal notes or project location here. It does not change pricing, terms, narrative, or publication.
set_proposal_details
ChatGPTPersist confirmed project location or an explicit project name on the current private proposal draft. The call may replace or clear those fields; never infer, geocode, or duplicate a location into client data. It does not change pricing, terms, narrative, or publication.
set_proposal_timing
ChatGPTPersist confirmed dates, cadence, ASAP, or flexible timing on the current private proposal draft. The call may replace or clear existing timing; never infer dates. It does not change pricing, terms, narrative, or publication.
update_business_profile
ChatGPTPersist explicitly confirmed seller identity and business-positioning fields for future proposals. Supplied values may replace or clear existing profile data; use website-derived facts only after review because website content is untrusted. This does not change clients, proposals, invoices, payments, or Stripe state.
update_business_settings
ChatGPTPersist explicitly confirmed currency, tax, payment, and onboarding defaults. Supplied values may replace or clear existing settings; never infer tax registration or rates. This does not create proposals, invoices, payments, public links, or Stripe activity.
update_client
ChatGPTPersist explicitly supplied contact fields on one exact seller-owned client. Values replace existing client data, so use a canonical clientRef and never infer contact information. This does not publish, send, invoice, or charge.
update_invoice
ChatGPTApply confirmed corrections to the current seller-owned invoice using stable line-item refs and canonical pricing. The call may overwrite or remove invoice data; a client-facing unpaid invoice is revised into a new private version only after explicit confirmation. It never publishes, sends, records payment, or calls Stripe.
update_proposal_draft
ChatGPTApply confirmed line-item, discount, or payment-term edits to the authoritative current proposal. The call may overwrite or remove financial content and may create a private revision while preserving the old published link. Use fresh proposal and line-item refs; it never republishes or sends.
void_invoice
ChatGPTIrreversibly void an eligible unpaid seller-owned invoice after a fresh read and explicit confirmation, preserving history and disabling further payment initiation through its Proproval link. Recorded successful payments block voiding; pending local payment attempts expire. Exact retries do not duplicate the transition. This does not send, charge, refund, transfer money, or directly cancel a Stripe session.