WowInvoice MCP lets you inspect document configurations, check order document status, generate PDFs, create private previews and manage supported document settings in your WooCommerce store using AI assistants.
All tools require a WordPress administrator account. Available operations also depend on your configured MCP access mode, applicable OAuth consent and licensing requirements.
Supported Capabilities and Example Prompts
| Capability | What You Can Do | Example Prompt |
|---|---|---|
| Document overview | Retrieve document types, publication status, access mode and Pro license status. | Show my available document types and which are published. |
| Order documents | Check document status and find eligible or issued documents. | Find my eligible order documents without changing anything. |
| Templates | List available templates, layouts, license requirements and view sample thumbnails. | Show the available document templates. |
| Document settings | Inspect effective settings, defaults, available options and readiness. | Check my document setup and identify readiness issues. |
| PDF generation | Generate a PDF for an eligible order using a published document configuration. | Prepare PDF generation for my order and ask for confirmation. |
| Private previews | Create a private, watermarked PDF preview. | Show a private preview for an order I select. |
| Configuration management | Plan, apply, publish, enable or disable reviewed document configurations. | Prepare a settings-change plan without applying it. |
| Snapshot reset | Reset a saved template snapshot while retaining its issued document number. | Explain the impact of resetting this order’s document snapshot. |
| Issued originals | View a retained original in the private WordPress viewer. | Open the retained original for my selected order document. |
| Print records | Record or correct a confirmed physical-printing assertion. | Prepare a print record for this document and ask for confirmation. |
Inspect Document Setup and Order Status
With Read only access, you can inspect document types, publication status, templates, effective settings and document readiness.
Use check-document-setup to inspect exact settings and channel readiness, optionally for a specific order or refund.
Use list-order-documents to find eligible or issued documents. Its results omit customer details and distinguish delivery, printing and legacy rendering evidence.
Template Previews vs. Document Previews
These are different operations:
| Preview Type | What It Displays | Required Access |
|---|---|---|
| Template preview | A packaged sample thumbnail and text fallback. | Read only or higher |
| Document preview | A private, watermarked PDF using actual order data. | Full access |
Use view-template to inspect an available template without generating an order document.
Generate a PDF for an Order
The generate-document tool generates a PDF from a published document configuration for an eligible order after confirmation.
It requires Manage or Full access and can issue a document number.
- Identify the order ID and document type.
- Check publication status, eligibility and document readiness.
- Review the intended generation action.
- Confirm generation and inspect the returned result.
Example prompt:
Generate a PDF for an order using WowInvoice. Ask for the order ID and document type, check its setup and publication status and wait for my confirmation before generating it.
PDF generation does not establish that a document was delivered to a customer or physically printed. Do not repeat generation solely because delivery or printing evidence is absent.
Preview Documents Before Applying Changes
The preview-document tool creates a private, watermarked PDF using the latest WooCommerce order or a selected order.
It requires Full access.
Use previews to inspect document output for the intended order before approving configuration changes.
Example prompt:
Create a private, watermarked document preview. Ask for the document type and order ID first. Do not publish configuration changes.
Keep private previews and customer information out of unnecessary chat messages and public support requests.
Review, Apply and Publish Document Configuration
WowInvoice separates configuration planning, applying changes, publication, enablement and PDF generation. These configuration-management operations require Full access.
Follow this workflow:
- Use
get-settingsandget-setting-optionsto inspect effective settings, their sources, defaults, allowed choices and Pro requirements. - Use
plan-settings-changeto prepare the proposed settings, publication or enablement changes. - Review the exact proposal and confirm the intended action.
- Use
apply-settings-changeto apply the approved review to the exact draft or active revision. - If publication is intended, explicitly approve the reviewed draft before using
publish-document.
Applying changes to a draft keeps it unpublished. Publication runs readiness checks and sample rendering.
Use set-document-enabled to apply a reviewed enable or disable action to one configured document while retaining its saved configuration.
Example prompt:
Prepare a WowInvoice settings-change plan based on my requirements. Show the proposed changes and the affected draft or active revision. Wait for my approval before applying, publishing or changing enablement.
Understand the Different Document Operations
| Operation | Effect |
|---|---|
| Plan changes | Prepare a proposal for review. |
| Apply changes | Apply the approved configuration to its exact revision. |
| Publish | Publish a reviewed draft configuration after confirmation. |
| Enable or disable | Change document availability while retaining its saved configuration. |
| Generate PDF | Generate an order document using a published configuration. |
Clearly identify which operation you are approving.
Reset a Saved Document Snapshot
The reset-document-snapshot tool resets the saved template snapshot after confirmation.
The next PDF uses current settings while retaining its issued document number. This operation requires Full access.
Review the affected order and document type before approving a reset.
Example prompt:
Identify the document snapshot I want to reset. Show its order ID and document type, explain the expected changes and wait for my confirmation.
Resetting a snapshot is not the same as issuing a new document number or generating a PDF.
Open an Issued Document Original
The view-issued-document tool opens a retained original in the private WordPress viewer. It requires Full access.
If the original is missing, the tool reports its absence without regenerating it.
A newly generated PDF or preview should not be treated as the retained original.
Record Physical Printing
The mark-document-printed tool records or corrects a staff assertion for one exact document after explicit confirmation of physical printing.
It requires Full access.
This operation records printing information. It does not send a document to a printer.
Verify that physical printing occurred before confirming the record.
Available WowInvoice MCP Tools
Navigate to WooCommerce → WowInvoice → AI Tools → Tools to view each tool’s description, required access and current status.
WowInvoice provides 17 MCP tools across three access categories.
| Tool Category | Number of Tools | Required Access |
|---|---|---|
| Read | 8 | Read only or higher |
| Manage | 1 | Manage or Full access |
| Full access | 8 | Full access |
All tools require a WordPress administrator. Additional OAuth consent and licensing requirements may apply.
Read Tools
Required access: Read only, Manage or Full access.
| Tool | Description |
|---|---|
wowinvoice-get-document-overview | Retrieve document types, publication status, access mode and Pro license status. |
wowinvoice-get-order-document | Retrieve the saved document status for a specific WooCommerce order. |
wowinvoice-list-templates | List built-in templates, current selections, layouts and license requirements. |
wowinvoice-view-template | View a packaged sample thumbnail and text fallback. |
wowinvoice-get-settings | Retrieve effective settings and their sources. |
wowinvoice-get-setting-options | Retrieve setting defaults, available choices and Pro requirements. |
wowinvoice-check-document-setup | Check document settings and channel readiness, optionally for an exact order or refund. |
wowinvoice-list-order-documents | Find eligible or issued documents without customer details and distinguish delivery, printing and legacy rendering evidence. |
Manage Tool
Required access: Manage or Full access.
| Tool | Description |
|---|---|
wowinvoice-generate-document | Generate a PDF for an eligible order after confirmation. This can issue a document number. |
Full Access Tools
Required access: Full access.
| Tool | Description |
|---|---|
wowinvoice-reset-document-snapshot | Reset a saved template snapshot while retaining the issued document number. |
wowinvoice-preview-document | Create a private, watermarked PDF preview using the latest or a selected order. |
wowinvoice-plan-settings-change | Prepare configuration, publication or enablement changes for review. |
wowinvoice-apply-settings-change | Apply an approved review to its exact draft or active revision. Applying a draft keeps it unpublished. |
wowinvoice-publish-document | Publish the exact reviewed draft after confirmation, readiness checks and sample rendering. |
wowinvoice-set-document-enabled | Apply a reviewed enable or disable action while retaining the saved configuration. |
wowinvoice-view-issued-document | Open a retained original in the private WordPress viewer without regenerating missing originals. |
wowinvoice-mark-document-printed | Record or correct a staff printing assertion after explicit confirmation of physical printing. |
A tool marked Blocked by mode is unavailable under your currently selected access mode.
Free and Pro Availability
Some WowInvoice templates, layouts, settings and operations may have licensing requirements.
To check what is available on your installation:
- Use
get-document-overviewto check Pro license status. - Use
list-templatesto inspect template license requirements. - Use
get-setting-optionsto identify settings that require Pro.
A tool appearing in the available tools list does not mean every template, setting or operation is available without Pro.
Important Operational Limitations
Keep the following distinctions in mind when using WowInvoice MCP:
- Applying draft settings does not publish the document configuration.
- Publishing a configuration is separate from generating an order PDF.
- PDF generation does not confirm customer delivery or physical printing.
- Private previews are not retained issued originals.
- Missing retained originals are not automatically regenerated by the issued-original viewer.
- Resetting a snapshot does not issue a new document number.
- Recording physical printing does not send a document to a printer.
Use WowInvoice MCP Safely
Start with Read only access. Enable Manage for PDF generation or Full access for operations that specifically require it.
Review the exact document type order ID, configuration revision and expected outcome before approving sensitive operations.
Inspect actual tool results rather than assuming a request was completed successfully.
For setup, permissions and credential security, see Getting Started with WowInvoice MCP.