list-invoices
List invoices with the account payment method (paginated).
LABSCO SUMMARY
You can see every tool, and the scope it needs, before you authorize anything.
The catalogue at /mcp/tools answers without a token, so you can check what mcp:read and mcp:write would open up before an OAuth flow starts, and every tool carries annotations such as readOnlyHint. Watch the consent step: a client that asks for no scope gets both read and write. There is no shared sandbox, so rehearse in an organization of your own, where follow-ups can be paused per account. For a product that chases customers for money, that rehearsal is not optional.
What it is
Billabex's MCP endpoint for their receivables product, at https://next.billabex.com/mcp.
What you get
Tools across the collection workflow, each carrying annotations such as readOnlyHint so a client can tell reads from writes before calling. The full current list, with schemas and scopes, is public at GET /mcp/tools and needs no credential.
Requirements
OAuth 2.1 with PKCE and standards-based discovery. If the client asks for no scope, consent covers both mcp:read and mcp:write. There is no shared sandbox, so testing needs an organization of your own.
Setup effort
Paste a URL, then authorize — add the endpoint to your client, then approve the OAuth consent screen
USE CASES
01
Reading collection status
Start with mcp:read consent and query the receivables state before granting anything more.
02
Checking what you would grant before connecting
Fetch the public catalogue at /mcp/tools, which lists every tool with its schema and the scope it needs, without a token.
03
Rehearsing before touching real debtors
There is no shared sandbox, so test in an organization of your own, pause follow-ups on the accounts you use, and preview a message's price before sending it.
99 tools
Listed in project docs. Your client may show a different list.
export-invoices
Export every filtered invoice to .xlsx : returns a download link valid for 15 minutes.
get-aging-balance
Net aging balance totals per currency.
list-aging-balance-by-account
Net breakdown per account and per currency, paginated.
get-invoice
Get invoice by ID, or by number within an account or an org.
create-invoice
Create invoice with base64 file upload and optional sourceId .
update-invoice-paid-amount
Set the total paid on an invoice, with expectedPaidAmount (the amount read) to refuse a conflict.
update-invoice-payment-schedule
Replace or remove an invoice payment schedule.
block-invoice-dunning
Exclude one invoice from reminders; it stays due, the account keeps going.
unblock-invoice-dunning
Put an excluded invoice back into reminders.
update-invoice-due-date
Correct the due date of an already issued invoice.
delete-invoice
Delete an invoice.
list-accounts
List accounts with type, payment method and external source ID.
get-account
Get account type, details and contacts.
get-account-financial-overview
Explain the account balance and list every invoice installment.
create-account
Create an account with an optional type and payment method.
update-account
Update account type, name, currency, address or payment method.
delete-account
Delete a customer account.
list-contacts
List contacts on an account.
get-contact
Get a specific contact.
create-contact
Add a contact to an account.
update-contact
Update a contact.
delete-contact
Remove a contact.
upsert-contact
Create or update contact by email/name match.
set-contact-enabled
Enable or disable a contact on an account.
list-credit-notes
List credit notes with the account payment method (paginated).
get-credit-note
Get credit note details, by ID or by number.
create-credit-note
Create a credit note, with an optional sourceId .
update-credit-note-refunded-amount
Record a partial or full cash refund.
delete-credit-note
Delete a credit note.
apply-credit-allocation
Apply credit from a credit note to an invoice.
remove-credit-allocation
Remove a credit allocation.
add-account-tags
Attach existing labels to an account.
remove-account-tag
Detach a label from an account.
link-account-source
Link an external source to an account.
update-account-source
Update account source last-sync timestamp.
unlink-account-source
Unlink an external source.
check-account-bodacc
Check French collective proceedings and propose SIREN candidates.
get-account-portal-link
Read the customer’s document page link of an account.
ensure-account-portal-link
Get or create that link; never replaces an existing one.
regenerate-account-portal-link
Replace that link; every previous copy stops working.
list-customer-balances
List customer outstanding balances (paginated).
get-customer-balance
Get balance details with invoices/credit notes.
list-communications
List incoming and outgoing emails at once, filterable server-side.
list-silent-accounts
List accounts emailed at least once that have never replied.
list-outgoing-communications
List outgoing reminder emails (paginated).
get-outgoing-communication
Get outgoing communication details.
list-outgoing-communications-by-account
List outgoing communications for an account.
update-outgoing-communication
Update a scheduled outgoing email.
send-outgoing-communication
Send an email immediately on behalf of the agent, to free-form recipients.
preview-outgoing-message
Preview and price an SMS or postal reminder without returning a PDF.
send-outgoing-message
Send a paid message with a required idempotency key.
get-outgoing-message
Get a sent SMS or postal reminder and its delivery state.
refresh-outgoing-message-tracking
Refresh a letter’s postal history and receipt, without sending or credits.
preview-outgoing-letter
Deprecated alias for postal previews.
send-outgoing-letter
Deprecated alias for postal sends.
list-incoming-communications
List incoming (reply) communications.
get-incoming-communication
Get incoming communication details.
list-incoming-communications-by-account
List incoming communications for an account.
get-account-dunning-status
Read whether an account is being chased, and the one reason it is not.
pause-account-dunning
Suspend reminders with a fact reason, or until a date for a dated wait.
resume-account-dunning
Lift human-resumable pauses and return any protections that remain.
withdraw-account-payment-date-request
Take back the instruction to ask the debtor for a payment date.
list-emails
List all emails (incoming + outgoing).
list-incoming-emails
List incoming emails (paginated).
get-incoming-email
Get incoming email with simplified body.
list-outgoing-emails
List outgoing emails (paginated).
get-outgoing-email
Get outgoing email with simplified body.
list-organizations
List organizations for the user, with their credits.
get-organization
Get organization details, including the credit balance.
update-organization
Update organization name or email domain.
update-organization-settings
Update reminder delays and the reminder threshold.
set-organization-logo
Set or remove the organization logo (base64 image).
list-organization-members
List members and their profile picture metadata.
remove-organization-member
Remove a member from an organization.
set-my-avatar
Set or replace the authenticated user’s profile picture.
remove-my-avatar
Remove the authenticated user’s profile picture.
get-my-notification-preferences
Read the authenticated user’s notification preferences.
set-my-notification-preferences
Update digest frequency or newsletter subscription.
create-organization-invitation
Invite a user. Pending invitations expire after 7 days.
cancel-organization-invitation
Cancel a pending invitation.
list-tags
List the organization’s labels plus the standard ones.
create-tag
Create a label owned by the organization.
list-account-tasks
Search the organization’s tasks (paginated).
get-account-task
Get task details and required input format.
cancel-account-task
Cancel an account task, with an optional reason . Refused on a payment check.
close-account-task
End a task dealt with elsewhere, without a model or an email. Only a NeedUserInput asking for information.
set-pending-account-task
Set an account task aside, with an optional pendingUntil date it should come back. Without one it comes back after 30 days.
add-account-task-text-interaction
Add a text response to a task.
decide-account-task-eligibility
Decide contact eligibility.
decide-account-task-contact-change
Approve or refuse proposed contact changes.
decide-account-task-first-outreach
Authorize or refuse first outreach.
provide-account-task-contact
Provide the requested contact.
decide-account-task-next-action
Choose the next action.
decide-account-task-payment-arrangement
Grant, refuse or keep a payment arrangement.
decide-account-task-email-draft
Send or discard the pending draft.
confirm-account-task-recipients
Confirm reminder recipients.
confirm-account-task-resume
Confirm resume or keep reminders paused.
acknowledge-unknown-account-task
Acknowledge an Unknown task.
BEFORE YOU INSTALL
What to know first
Tools you get
99 tools named in the project's documentation. Each tool states its scope: reads take mcp:read, writes take mcp:write. SMS and postal reminders (send-outgoing-message) and contact searches spend your prepaid Billabex credits. Emails are free.
Requires
- an MCP client that can reach a remote endpoint
- OAuth 2.1 with PKCE, discovered per RFC 9728 and RFC 8414; if the client omits a scope, consent covers mcp:read and mcp:write
INSTALLATION
Connect your client
Add the endpoint to your client, then approve the OAuth consent screen.
Server setup
ENDPOINT URL
https://next.billabex.com/mcpRequirements
- OAuth 2.1 Authorization Code + PKCE, discovered via RFC 9728/8414; scopes mcp:read mcp:write; Authorization: Bearer <YOUR_TOKEN> header (required)
MCP Clients
Any MCP client
Add https://next.billabex.com/mcp to your client as a remote (Streamable HTTP) MCP server — Claude Desktop, a compatible IDE, or your own agent. There is no key to paste.
On first connection the server answers 401 and your client starts the OAuth 2.1 flow with PKCE: sign in with your Billabex account and approve the consent screen (mcp:read for reads, mcp:write for writes — a client that asks for no scope gets both).
Check the connection by asking the assistant for your overdue invoices.
