Nue Billing & Collections
Nue Billing & Collections
The Nue Billing & Collections server exposes Nue's Everything Billing and collections capabilities as MCP tools. It covers the stage of the revenue lifecycle that begins once an order is activated: issuing billing transactions, recording their settlement, and maintaining an accurate view of accounts receivable across every system that holds a copy of them.
Nue draws a deliberate distinction between two classes of transaction, and that distinction shapes the tool set. Billing transactions — invoices, credit memos, and debit memos — are owned by Nue and managed end to end through this server. Payment transactions — payments and refunds — are executed in the payment system of record, whether that is Stripe, QuickBooks, NetSuite, or another provider. Nue records their relationship to the underlying billing transactions as payment applications, so the effect of every settlement, application, reversal, and write-off on the receivable balance remains auditable from within Nue. The server also exposes the synchronization operations behind the Transaction Hub, through which finance teams confirm that each transaction has reached its downstream systems intact and retry those that have not.
Collections is, in the end, the discipline of converting issued invoices into received cash, and it is material to the health of the business rather than a matter of administrative tidiness. The work is periodic, high in volume, and unforgiving of small errors, since an error on an invoice is one the customer sees. A substantial share of the effort is not judgement but assembly: identifying the transactions that match a given description, applying the correct credit to the correct document, pursuing balances that remain outstanding, and confirming that each record has reached the accounting and CRM systems that depend on it. That assembly work is what an assistant connected to this server is well suited to undertake, with the commercial and accounting decisions remaining with your finance and billing operators.
A billing manager can ask for every overdue invoice on a named account and have the balances summarised. A collections specialist can apply an existing credit memo to the invoices it should offset, and see immediately what remains outstanding. An operations lead can set up a recurring billing schedule described in ordinary language — the first Monday of each month, say — without translating that into a scheduling expression by hand. Each of these is a request that would otherwise mean several screens and a good deal of care.
Before you begin
- The Nue Billing & Collections server is available but not connected by default. An administrator enables it from the MCP Servers list in your Nue tenant.
- Connection is made through the Nue MCP Gateway. See Connecting to Nue MCP for the one-click, per-user sign-in flow.
- Permissions follow the person or key that connected, so an assistant can only see and change what that user could see and change themselves.
- Several of these tools move real money or produce documents a customer will receive. Activating an invoice, refunding a payment, or writing off a balance are consequential acts. We recommend that assistants be asked to describe what they are about to do and wait for confirmation before carrying out anything of that kind.
What it covers
This is the broadest of Nue's MCP servers. The breadth reflects the reality of billing, where the same document may need to be created, corrected, activated, cancelled, synchronised, and reported on, and where each of those steps is a distinct operation with its own rules.
Because the set is large, the gateway's tool search does meaningful work here: an assistant finds the handful of tools relevant to your request rather than reasoning over the whole surface at once. Tools appear under the billing_ prefix.
The sections below group the tools the way a billing team thinks about its own work.
Invoices
Invoices are the centre of the server. These tools cover a document's whole life, from correction and activation through to cancellation, along with the operations that keep invoice records aligned with connected systems. Activation is the step that makes an invoice real and visible to the customer, and several operations exist in both an immediate and a background form so that large runs do not have to be processed one document at a time.
Tool | What it does |
|---|---|
updateInvoice | Amends an invoice before it is activated, which is where corrections are made once something has been spotted. |
activateInvoices | Activates one or more invoices, making them final and available to the customer. |
asyncActivateInvoices | Activates a large batch of invoices in the background, for month-end runs where volume makes an immediate response impractical. |
cancelInvoices | Cancels one or more invoices that should not have been issued. |
asyncCancelInvoices | Cancels a large batch of invoices in the background. |
deleteCanceledInvoices | Removes invoices that have already been cancelled, for tenants that prefer not to retain them. |
asyncDeleteCanceledInvoices | Removes a large batch of cancelled invoices in the background. |
getPdfByInvoiceIdAndTemplateId | Produces the PDF of an invoice using a chosen template, which is what a customer ultimately receives. |
getCreditMemosByAppliedInvoiceId | Lists the credit memos that have been applied to a given invoice, so the full picture of what has offset a balance is visible in one place. |
resyncInvoicesToPayment | Re-sends invoices to the payment system when the two have fallen out of step. |
syncUpdatedInvoiceItem | Synchronises a single amended invoice line. |
syncUpdatedInvoiceItems | Synchronises several amended invoice lines together. |
syncUpdatedInvoiceItemDetail | Synchronises the detail behind a single invoice line, where that detail is held separately. |
syncUpdatedInvoiceItemDetails | Synchronises the detail behind several invoice lines together. |
fetchInvoices | Retrieves invoices. This tool is retained for compatibility; for customer-scoped enquiries the Lifecycle Manager server offers a more convenient equivalent. |
Credit memos
Credit memos record amounts owed back to a customer, whether from an overcharge, a cancellation, a negotiated concession, or the conversion of unused credit. They follow the same shape as invoices — created, amended, activated, and sometimes cancelled — and they carry the additional question of what they have been applied to.
Tool | What it does |
|---|---|
upsertStandaloneCreditMemo | Creates a credit memo that stands on its own rather than arising from a specific invoice, or updates one that already exists. |
updateCreditMemo | Amends a credit memo before it is activated. |
activateCreditMemos | Activates one or more credit memos, making the credit real and available to be applied. |
asyncActivateCreditMemos | Activates a large batch of credit memos in the background. |
cancelCreditMemos | Cancels one or more credit memos. |
asyncCancelCreditMemos | Cancels a large batch of credit memos in the background. |
deleteCanceledCreditMemos | Removes credit memos that have already been cancelled. |
asyncDeleteCanceledCreditMemos | Removes a large batch of cancelled credit memos in the background. |
creditConvertToCreditMemo | Converts a customer's unused credit into a formal credit memo, so it can be applied against what they owe. |
getInvoicesByCreditMemoAppliedId | Lists the invoices a given credit memo has been applied to. |
getDebitMemosByCreditMemoAppliedId | Lists the debit memos a given credit memo has been applied to. |
syncUpdatedCreditMemoItem | Synchronises a single amended credit memo line. |
syncUpdatedCreditMemoItems | Synchronises several amended credit memo lines together. |
syncUpdatedCreditMemoItemDetail | Synchronises the detail behind a single credit memo line. |
syncUpdatedCreditMemoItemDetails | Synchronises the detail behind several credit memo lines together. |
fetchCreditMemos | Retrieves credit memos. Retained for compatibility; the Lifecycle Manager server offers a customer-scoped equivalent. |
fetchCreditMemoById | Retrieves a single credit memo. Retained for compatibility. |
fetchCustomerCreditMemos | Retrieves a customer's credit memos. Retained for compatibility. |
fetchCustomerCreditMemoById | Retrieves one of a customer's credit memos. Retained for compatibility. |
Debit memos
Debit memos record additional amounts a customer owes beyond what has already been invoiced, and are the natural counterpart to credit memos.
Tool | What it does |
|---|---|
createDebitMemo | Raises a new debit memo against a customer. |
updateDebitMemo | Amends a debit memo before it is activated. |
activateDebitMemos | Activates one or more debit memos, making the additional charge final. |
cancelDebitMemos | Cancels one or more debit memos. |
Payments and payment rules
Payment rules describe how and when payment should be taken. Setting them up well is what turns collection from a manual chase into something that largely runs itself, and these tools cover their whole life, including the ability to copy an existing rule as the starting point for a new one.
Tool | What it does |
|---|---|
createPaymentRule | Creates a new payment rule describing how payment should be collected. |
modifyPaymentRule | Amends an existing payment rule as terms or practice change. |
duplicatePaymentRule | Copies an existing rule, which is the quickest way to create a variant without rebuilding it from scratch. |
activatePaymentRules | Brings one or more payment rules into effect. |
deactivatePaymentRules | Takes one or more payment rules out of effect while retaining them for future use. |
deletePaymentRules | Removes payment rules permanently. |
processPaymentRules | Runs the payment rules, which is the step that actually collects against the invoices they cover. |
Billing schedules
A billing schedule determines when billing runs happen and which customers and products they cover. Describing a schedule in ordinary language — the first Monday of the month at two in the morning — is exactly the kind of translation an assistant handles well, and the server accepts the resulting definition directly.
Tool | What it does |
|---|---|
createBillingSchedule | Creates a billing schedule, including how often it should run and which customers and products fall within it. |
updateBillingSchedule | Amends an existing billing schedule as billing practice changes. |
duplicateBillingSchedule | Copies an existing schedule as the basis for a new one. |
activateBillingSchedules | Brings one or more billing schedules into effect, so they begin running. |
cancelBillingSchedules | Stops one or more billing schedules from running. |
deleteBillingSchedule | Removes a billing schedule permanently. |
downloadFile | Retrieves the output file a billing run produced, for review or for passing to another system. |
Collections
Collections is the work of turning issued invoices into received money, and of resolving the cases where that does not happen cleanly. These are the most consequential tools on the server, because each one moves money or forgives it.
Tool | What it does |
|---|---|
payInvoices | Records or takes payment against one or more invoices. |
applyCreditMemoToInvoices | Applies an existing credit memo to the invoices it should offset, reducing what the customer owes. |
unapplyCreditMemo | Reverses the application of a credit memo, returning the credit to the customer's balance and restoring the invoice. |
refundInvoice | Refunds an invoice that has been paid. |
cancelPayments | Cancels payments that were recorded in error. |
writeOffInvoices | Writes off invoice balances that will not be collected, which is how uncollectable debt is formally recognised. |
Keeping Salesforce in step
For tenants running Nue on Salesforce, billing documents need to appear in the CRM as well. These tools drive that synchronisation and let an assistant confirm it has completed, which matters when a sales team is about to have a conversation informed by what they see in Salesforce.
Tool | What it does |
|---|---|
createSyncJob | Starts a synchronisation job to bring Nue records into Salesforce. |
createBatchSyncJobForInvoicesToSalesforce | Starts a batch synchronisation of invoices into Salesforce, for volumes that warrant batching. |
createSyncOrdersJob | Starts a synchronisation of orders into Salesforce. |
findSyncJobById | Reports the status of a synchronisation job. |
getInvoicesSyncJobStatus | Reports specifically on the progress of an invoice synchronisation. |
getFieldsSyncJobStatus | Reports on the progress of a field synchronisation. |
reSyncInvoiceToCrm | Re-sends a single invoice to the CRM when it did not arrive correctly the first time. |
reSyncCreditMemoToCrm | Re-sends a single credit memo to the CRM. |
syncCustomerToCrm | Synchronises a customer record to the CRM. |
syncCreditTypesAndPools | Synchronises credit types and credit pools, keeping the credit configuration consistent across both systems. |
Orders and customer-facing links
A small number of tools sit at the boundary between billing and the order it came from, or between billing and the customer who receives it.
Tool | What it does |
|---|---|
invoicesPreview | Shows what a customer would be invoiced for a given order before anything is committed, which is how a billing question is answered ahead of time rather than explained afterwards. |
patchOrderProducts | Amends order product records where billing requires a correction at source. |
patchSubscriptions | Amends subscription records where billing requires a correction at source. |
getMagicLink | Produces a secure link a customer can use to view and act on their billing documents without needing an account. |
getMagicLinkWithTemplate | Produces the same kind of secure link using a specific template, where the presentation matters. |
findAsyncJobById | Reports the status of a background job, so an assistant can follow a long-running operation to its conclusion. |
Stripe integration
For tenants collecting through Stripe, the server also covers the configuration that keeps the two systems describing the same thing in the same way. Field mapping is the substance of this: deciding which Nue field corresponds to which Stripe field, so information arrives where it is expected.
Tool | What it does |
|---|---|
listMetadataMappings | Lists the field mappings currently in place between Nue and Stripe. |
createMetadataMappings | Creates new field mappings between Nue and Stripe. |
listSourceObjects | Lists the Nue objects available to map from. |
getSourceObjectFields | Lists the fields available on a chosen Nue object. |
listTargetObjects | Lists the Stripe objects available to map to. |
getTargetObjectFields | Lists the fields available on a chosen Stripe object. |
updateInvoiceNumberType | Sets how invoice numbers are formed for the Stripe integration, so numbering stays consistent across both systems. |
Typical requests
- "Show me every overdue invoice for this account and tell me what the total outstanding balance is."
- "Apply the credit memo we raised last week to that customer's open invoices and tell me what is still owed."
- "Set up a billing schedule that runs on the first Monday of each month at two in the morning."
- "Activate the draft invoices from last night's run, but list them for me first so I can check them."
- "This invoice was raised in error — cancel it and confirm nothing has already been paid against it."
- "Did last night's invoice synchronisation to Salesforce finish, and did anything fail?"
- "Produce a secure link so this customer can view their latest invoice."
Working alongside the other servers
Billing questions rarely stop at the billing system. The Nue MCP Gateway federates every server behind one connection, so an assistant can follow a question wherever it leads without being reconnected.
In practice this means a query that begins with an unpaid invoice can move to the subscription that produced it through the Nue Lifecycle Manager server, and from there to the pricing that governs it through Nue Price Builder. Where an enquiry is simply about what a named customer owes, the Lifecycle Manager server already provides convenient customer-scoped views of invoices and credit memos, and is often the shorter path.
Related
- Nue MCP Servers Overview — how the gateway works and which servers are available.
- Connecting to Nue MCP — how to connect from ChatGPT, Claude, Cursor, and other clients.
- Nue Admin — system settings, data import and export, and webhook endpoints.
- Nue Lifecycle Manager — opportunities, quotes, orders, and subscriptions.
- Nue Price Builder — products, pricing rules, bundles, and pricing plugins.