Model Context Protocol (MCP) server for freee API integration
Nothing to run from here
Red by Big Red Cloud is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
159
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
Secure MCP access to Big Red Cloud accounting data, workflows, help and training.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http red-by-big-red-cloud-mcp https://red.bigredcloud.com/mcp
# 2 — ask your agent for something these tools do
# brc_start_company_connection, brc_confirm_company_connection, brc_get_company_api_key_status and 156 more
Red by Big Red Cloud costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
BIAll 1 server
BigRedCloud1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http red-by-big-red-cloud-mcp https://red.bigredcloud.com/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
159 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Starts the secure Red / Big Red Cloud connection flow and returns a one-time connection page URL and confirmation code. The secure page supports one or multiple companies, including CSV upload, and keeps API credentials outside chat. Available without an existing company connection.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
Confirms a short-lived company-connection code and returns the connected companies plus a reusable opaque connection reference. Connection credentials are not returned.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| code | string | yes | The connection code from the secure Red connection page success message. |
Returns company connection-status metadata without returning API keys or other credentials.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | no | Optional company context name. If omitted, summarises all contexts. |
Returns connected-company contexts and connection-expiry metadata, including duration, remaining time and timezone details. Connection credentials are not returned.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
Clears the API key for a named company context from MCP server memory.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Clears all connection credentials for all company contexts from MCP server memory.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
Lists BRC accounts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC customers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Unsupported: BRC customers forbid $filter. List with pagination and match locally. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC customer by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Customer id. |
Lists BRC customers without dormant records.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC suppliers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC supplier by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Supplier id. |
Lists BRC products.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC product types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC products without dormant records.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC sales entries.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC sales entry by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales entry id. |
Lists BRC sales invoices.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC sales invoice by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales invoice id. |
Lists BRC purchases.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC purchase by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Purchase id. |
Returns company analysis categories and their book context. Customer-control categories are distinct from Sales analysis categories.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Returns company VAT rates and their associated category identifiers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC VAT analysis types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Returns company VAT categories and their Sales or Purchase context.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC VAT types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC company settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC category types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC owner type groups.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC owner types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC user defined fields.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Lists BRC book transaction types.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Returns nominal accounts and period movements. Monthly values represent movements rather than monthly balances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Returns one nominal account ledger and its period movements. Monthly values represent movements rather than monthly balances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Nominal account id. |
Lists BRC quotes. List and get may not return the same fields (for example note or analysis account codes); treat those as representation differences, not as create or update failures. Quote references are not necessarily unique — identify a quote by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC quote by id. List and get may not return the same fields (for example note or analysis account codes); treat those as representation differences, not as create or update failures.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Quote id. |
Lists BRC sales credit notes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC sales credit note by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales credit note id. |
Lists BRC sales reps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC sales rep by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales rep id. |
Gets full BRC company setup configuration, including general details, financial year, reference settings, and processing options.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Gets the company logo from BRC.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Gets BRC company financial year.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Creates a BRC customer from explicit code and name fields. Optional address, contact, credit and VAT fields are omitted when absent. Opening-balance fields are not posted. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | yes | Raw BRC-compatible payload for this endpoint. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Updates a BRC customer using merged fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Customer id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC customer by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | customer id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Gets a customer's opening balance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Customer item id. |
Gets a customer's opening balance transaction list.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Customer item id. |
Returns customer account transactions. Transaction IDs and types are endpoint- and company-specific.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Customer item id. |
Gets quotes for a specific customer.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Customer item id. |
Creates a BRC supplier using a raw BRC payload. Does not create or update opening balance transactions. Opening-balance fields are not posted by this tool; supplier opening balances are entered directly in Big Red Cloud. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | yes | Raw BRC-compatible payload for this endpoint. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Updates a BRC supplier using merged fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Supplier id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC supplier by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | supplier id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Gets a supplier's opening balance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Supplier item id. |
Gets a supplier's opening balance transaction list.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Supplier item id. |
Returns supplier account transactions. Transaction IDs and types are endpoint- and company-specific.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| itemId | string | yes | Supplier item id. |
Creates a purchase with a caller-supplied reference when manual purchase references are configured. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns co
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| supplierId | string | yes | Supplier id, for example 26180406. |
| acCode | string | yes | Supplier account code, for example SUP001. |
| note | string | yes | Purchase note. |
| entryDate | string | yes | Entry date in ISO format. |
| procDate | string | yes | Processing date in ISO format. |
| bookTranTypeId | integer | yes | Purchase book transaction type id. |
| analysisCategoryId | integer | yes | Purchases analysis category id. |
| accountCode | string | yes | Nominal/account code. |
| description | string | yes | Analysis line description. |
| netAmount | number | yes | Net amount before VAT. |
| vatRateId | integer | yes | VAT rate id. |
| vatPercentage | number | yes | VAT percentage. |
| reference | string | no | Required when the company is configured for manual purchase references. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Creates a purchase using the company's generated-reference configuration. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| supplierId | integer | yes | — |
| acCode | string | yes | — |
| note | string | yes | — |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| bookTranTypeId | integer | yes | — |
| analysisCategoryId | integer | yes | — |
| accountCode | string | yes | — |
| description | string | yes | — |
| netAmount | number | yes | — |
| vatRateId | integer | yes | — |
| vatPercentage | number | yes | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates a BRC purchase using structured MCP fields. Historical transaction dates are not automatically blocked. Existing historical purchases may support text, monetary, date and delete operations; the BRC endpoint is the source of truth. When changing monetary values, preserve the existing unpaid/unallocated state and allow BRC to recalculate allocation fields where required. Requires a valid rou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Purchase id. | |
| supplierId | string | no | — |
| acCode | string | no | — |
| note | string | no | — |
| entryDate | string | no | — |
| procDate | string | no | — |
| bookTranTypeId | integer | no | — |
| analysisCategoryId | integer | no | — |
| accountCode | string | no | — |
| description | string | no | — |
| netAmount | number | no | — |
| vatRateId | integer | no | — |
| vatPercentage | number | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC purchase by id using timestamp confirmation. Historical purchases are not automatically blocked because they belong to an earlier financial year. The BRC endpoint determines whether the historical deletion is supported. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Purchase id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Creates a BRC sales entry using structured MCP fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. co
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| customerId | integer | yes | — |
| acCode | string | yes | — |
| note | string | yes | — |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| bookTranTypeId | integer | yes | — |
| analysisCategoryId | integer | yes | — |
| accountCode | string | yes | — |
| description | string | yes | — |
| netAmount | number | yes | — |
| vatRateId | integer | yes | — |
| vatPercentage | number | yes | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates a sales entry while preserving the existing BRC unpaid value. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales Entry id, normally the bookTranId returned by customer account transactions. | |
| note | string | no | Optional. BRC "Note" field on the sales document (JSON field note). Leave blank to default it to the customer name (BRC customer "Name" / JSON name). Do not use the product name as the note. Only |
| reference | string | no | Optional. BRC "Reference" field (JSON field reference). BRC "Our Ref" (JSON ourReference) and BRC "Your Ref" (JSON yourReference) default to this value when not supplied separately. |
| details | string | no | Sales Entry details/description field. |
| entryDate | string | no | Entry date in ISO format. Historical dates may be attempted; BRC determines whether the change is permitted. |
| procDate | string | no | Processing date in ISO format. Historical dates may be attempted; BRC determines whether the change is permitted. |
| customerId | integer | no | Customer id. |
| acCode | string | no | Customer account code. |
| bookTranTypeId | integer | no | Book transaction type id. Sales Entries normally use the existing record's transaction type. |
| vatTypeId | integer | no | VAT type id. |
| totalNet | number | no | New total net value. For monetary edits this must be supplied together with totalVAT, total, acEntries and vatEntries. |
| totalVAT | number | no | New total VAT value. For monetary edits this must be supplied together with totalNet, total, acEntries and vatEntries. |
| total | number | no | New gross total. For monetary edits this must equal totalNet + totalVAT. |
| acEntries | array | no | Complete BRC accounting-entry collection. For monetary edits, the sum of each entry's value must equal totalNet. |
| vatEntries | array | no | Complete BRC VAT-entry collection. Each entry should contain the BRC vatRateId, percentage and net amount used to calculate VAT. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC sales entry by id using timestamp confirmation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload prev
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Sales entry id. |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Creates a sales invoice with a caller-supplied reference and reconciled product, VAT and Sales-analysis lines. Missing customer contact values remain absent. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| customerId | integer | yes | — |
| customerName | string | no | Optional. The selected customer's name (BRC customer "Name" / JSON name). Used as the default sales document note (BRC "Note" / JSON note) when no explicit note is given. |
| acCode | string | yes | — |
| note | string | no | Optional. BRC "Note" field on the sales document (JSON field note). Leave blank to default it to the customer name (BRC customer "Name" / JSON name). Do not use the product name as the note. Only |
| deliveryTo | no | Optional. BRC "Delivery To" address (JSON field deliveryTo). Leave blank unless the user explicitly provides a delivery address. Do not invent or default a delivery address (for example "MCP Test"). | |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| bookTranTypeId | integer | yes | — |
| analysisCategoryId | integer | yes | — |
| accountCode | string | yes | — |
| description | string | yes | Product line description shown on the document line (BRC product line description / JSON tranNotes, also used on the line's analysis entry description). This is the line narrative, not the BRC "Note |
| netAmount | number | yes | — |
| vatRateId | integer | yes | — |
| vatPercentage | number | yes | — |
| productId | integer | yes | productCode is the BRC product "Code" (JSON productCode); productId is the BRC product "Id" (JSON productId) from brc_list_products. The product name is not a payload field — do not place it in th |
| productCode | string | yes | productCode is the BRC product "Code" (JSON productCode); productId is the BRC product "Id" (JSON productId) from brc_list_products. The product name is not a payload field — do not place it in th |
| quantity | integer | yes | — |
| unitPrice | number | yes | — |
Creates a sales invoice using generated references and reconciled product, VAT and Sales-analysis lines. Missing customer contact values remain absent. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requir
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | yes | Raw BRC payloads for multi-line sales invoices must use productTrans[] (one object per product line). Each product line must include its own nested acEntries[] for Sales analysis posting — do not |
| priceBasis | string | no | Required when Gross Price Entry is enabled. Use gross when unit prices are VAT-inclusive/gross. Use net when unit prices are VAT-exclusive/net. |
| confirmCrAnalysisCategory | boolean | no | Set true only after the user confirms a CR sales analysis account code is intentional for this product line. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates a sales invoice. Supplied monetary changes must be explicit and reconciled. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_requi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales invoice id. | |
| note | string | no | Optional. BRC "Note" field on the sales document (JSON field note). Leave blank to default it to the customer name (BRC customer "Name" / JSON name). Do not use the product name as the note. Only |
| reference | string | no | Optional. BRC "Reference" field (JSON field reference). BRC "Our Ref" (JSON ourReference) and BRC "Your Ref" (JSON yourReference) default to this value when not supplied separately. |
| ourReference | string | no | — |
| yourReference | string | no | — |
| details | string | no | — |
| entryDate | string | no | Entry date. Historical dates are permitted as an attempted update; BRC may accept or reject them. |
| procDate | string | no | Processing date. Historical dates are permitted as an attempted update; BRC may accept or reject them. |
| customerId | integer | no | — |
| saleRepId | integer | no | — |
| vatTypeId | integer | no | — |
| bookTranTypeId | integer | no | — |
| totalNet | number | no | — |
| totalVAT | number | no | — |
| total | number | no | — |
| productTrans | array | no | Complete BRC productTrans collection. Use this when changing invoice lines, quantities, unit prices, VAT or line amounts. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC sales invoice by id using timestamp confirmation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload pr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales invoice id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Creates a quote with a caller-supplied reference and reconciled product, VAT and Sales-analysis lines. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| companyId | integer | yes | Required BRC company id for the quote payload. Use the connected company's id from existing records such as customers, products, or sales reps. Do not omit this field. |
| customerOwnerId | integer | yes | — |
| acCode | string | yes | — |
| customerOwnerName | string | yes | — |
| comments | string | yes | — |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| vatTypeId | integer | no | — |
| saleRepId | integer | yes | Sales rep id from brc_list_sales_reps. |
| saleRepCode | string | yes | Sales rep code from brc_list_sales_reps. |
| reference | string | no | Optional manual quote reference, max 6 characters. Required when quote references are manual, or when the quote reference setting is unknown. Quote reference must be 6 characters or fewer because Big |
| poNumber | string | no | — |
| ddNumber | string | no | — |
| confirmQuotesAutoGenerateInBrc | boolean | no | Set true only after the user confirms quotes are auto-generated in Big Red Cloud. Required for brc_create_quote_gen_ref when Quotes reference setting is Unknown. |
| layoutType | integer | no | — |
| productId | integer | yes | — |
| productCode | string | yes | — |
| quantity | number | yes | — |
Creates a quote using generated references and reconciled product, VAT and Sales-analysis lines. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| companyId | integer | yes | Required BRC company id for the quote payload. Use the connected company's id from existing records such as customers, products, or sales reps. Do not omit this field. |
| customerOwnerId | integer | yes | — |
| acCode | string | yes | — |
| customerOwnerName | string | yes | — |
| comments | string | yes | — |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| vatTypeId | integer | no | — |
| saleRepId | integer | yes | Sales rep id from brc_list_sales_reps. |
| saleRepCode | string | yes | Sales rep code from brc_list_sales_reps. |
| reference | string | no | Optional manual quote reference, max 6 characters. Required when quote references are manual, or when the quote reference setting is unknown. Quote reference must be 6 characters or fewer because Big |
| poNumber | string | no | — |
| ddNumber | string | no | — |
| confirmQuotesAutoGenerateInBrc | boolean | no | Set true only after the user confirms quotes are auto-generated in Big Red Cloud. Required for brc_create_quote_gen_ref when Quotes reference setting is Unknown. |
| layoutType | integer | no | — |
| productId | integer | yes | — |
| productCode | string | yes | — |
| quantity | number | yes | — |
Updates a BRC quote's manual reference only. Quote.note is not persisted by this update and is not accepted here. Loads the current quote, preserves all other fields (including timestamp, product lines, analysis entries, totals, customer, sales rep, dates, comments, and closed state), applies the new reference, then PUTs the full record. Manual quote references must be 6 characters or fewer becaus
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Quote id. | |
| reference | string | no | Optional manual quote reference, max 6 characters. Required when quote references are manual, or when the quote reference setting is unknown. Quote reference must be 6 characters or fewer because Big |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Closes a BRC quote. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies the previe
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Quote id. | |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Reopens a BRC quote. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies the previ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Quote id. | |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC quote by id using timestamp confirmation. Loads the quote once to obtain its timestamp and to preview id, reference, customer, total, open or closed state, any linked sales invoice, and timestamp before asking for confirmation. A successful delete is the result; if a later lookup by quote id returns an unexpected error, treat that check as inconclusive rather than as a failed delete.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Quote id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Generates a sales invoice from a BRC quote. Preview-before-posting shows the exact POST /v1/quotes/generateSaleInvoice body (quoteId and optional entryDate/procDate only). Nothing is written until you confirm. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeTok
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| quoteId | integer | yes | Quote id. |
| entryDate | string | no | Optional invoice entry date in ISO format. |
| procDate | string | no | Optional invoice processing date in ISO format. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Creates a sales credit note with a caller-supplied reference and reconciled negative document amounts. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| customerId | integer | yes | — |
| acCode | string | yes | — |
| note | string | yes | — |
| entryDate | string | yes | — |
| procDate | string | yes | — |
| bookTranTypeId | integer | yes | — |
| analysisCategoryId | integer | yes | — |
| accountCode | string | yes | — |
| description | string | yes | — |
| netAmount | number | yes | — |
| vatRateId | integer | yes | — |
| vatPercentage | number | yes | — |
| productId | integer | yes | — |
| productCode | string | yes | — |
| quantity | number | yes | — |
| unitPrice | number | yes | — |
| saleRepId | integer | yes | Sales rep id from brc_list_sales_reps. |
| saleRepCode | string | yes | Sales rep code from brc_list_sales_reps. |
Creates a sales credit note using generated references and reconciled negative document amounts. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | yes | — |
| confirmCrAnalysisCategory | boolean | no | Set true only after the user confirms a CR sales analysis account code is intentional for this product line. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates a sales credit note while preserving the existing BRC unpaid value. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales credit note id. | |
| note | string | no | — |
| reference | string | no | — |
| ourReference | string | no | — |
| yourReference | string | no | — |
| details | string | no | — |
| entryDate | string | no | Entry date. Historical dates may be attempted; BRC determines whether the update is permitted. |
| procDate | string | no | Processing date. Historical dates may be attempted; BRC determines whether the update is permitted. |
| customerId | integer | no | — |
| saleRepId | integer | no | — |
| vatTypeId | integer | no | — |
| totalNet | number | no | — |
| totalVAT | number | no | — |
| total | number | no | — |
| productTrans | array | no | Complete BRC productTrans collection. Preserve existing line ids and accounting/VAT data when modifying an existing credit note. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC sales credit note by id using timestamp confirmation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payloa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales credit note id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Creates a BRC sales rep using structured MCP fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. conf
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| code | string | yes | Sales rep code. |
| name | string | yes | Sales rep name. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Updates a BRC sales rep using structured MCP fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. conf
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales rep id. | |
| code | string | no | — |
| name | string | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC sales rep by id using timestamp confirmation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload previe
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Sales rep id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Returns nominal-account ledgers for supplied account IDs. Monthly values represent movements rather than monthly balances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| ids | string | yes | Comma-separated nominal account ids. |
Returns a grouped nominal-account report with period movements rather than monthly balances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Returns a multi-company nominal-account report with period movements rather than monthly balances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyNames | array | yes | The company names to report on. |
Lists BRC cash payments.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC cash payment by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Cash payment id. |
Creates a cash payment in supplier-ledger, bank-lodgement or analysed-expense mode. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_requi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| note | string | yes | — |
| entryDate | string | no | Entry date in ISO format. Defaults to today. |
| procDate | string | no | Processing date in ISO format. Defaults to entryDate. |
| bookTranTypeId | integer | no | Cash Payment book transaction type id. |
| total | number | yes | — |
| supplierId | integer | no | Supplier id for ledger payments. |
| acCode | string | no | Supplier account code for ledger payments. |
| ledger | number | no | Ledger amount; must equal total for supplier payments. |
| discount | number | no | — |
| bankAccountId | integer | no | Bank account id for lodgements. |
| bankAccountCode | string | no | Bank account code for lodgements. |
| lodgement | number | no | Lodgement amount; must equal total when lodging to bank. |
| analysisCategoryId | integer | no | Cash Payments analysis category id (categoryTypeId 1391170). |
| accountCode | string | no | Analysis account code matching analysisCategoryId, for example CP01. |
| description | string | no | Analysis line description. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates an existing Cash Payment by merging supplied fields onto the current record. Fields that can be merged include total, entryDate, procDate, supplierId, acCode, note, ledger, discount, bankAccountId, bankAccountCode, lodgement, analysisCategoryId, accountCode, and description. This update flow is a verified action on the existing record. Requires a valid routeToken issued for the matching ac
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Cash payment id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC cash payment by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true appl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | cash payment id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes cash payments in supplier-ledger, bank-lodgement or analysed-expense mode. Results are reported per submitted item and partial success is possible. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Lists BRC cash receipts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter using entryDate only. Other fields are unsupported. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC cash receipt by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Cash receipt id. |
Creates a BRC cash receipt. Accepts either a raw payload object or common flat fields. Customer-ledger receipts require both customerId and acCode resolved for the same customer; neither field alone is sufficient. Analysed receipts may instead supply an analysis allocation without a customer. entryDate defaults to today; procDate defaults to entryDate. The preview shows these resolved dates; carry
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | no | Raw cash-receipt fields. Customer-ledger mode requires both customerId and acCode for the same resolved customer; analysed mode uses analysis allocation instead. |
| note | string | no | — |
| reference | string | no | Cash receipts do not support reference in the documented BRC API. Use detailCollection for audit or bank-reference text. |
| details | string | no | — |
| entryDate | string | no | Entry date; defaults to today and is shown in the preview. |
| procDate | string | no | Processing date; defaults to entryDate and is shown in the preview. |
| bookTranTypeId | integer | no | — |
| total | number | no | — |
| customerId | integer | no | Resolved customer id. Customer-ledger receipts also require acCode for the same customer; analysed receipts can omit both. |
| acCode | string | no | Resolved customer account code. Customer-ledger receipts also require customerId for the same customer; analysed receipts can omit both. |
| ledger | number | no | — |
| analysisCategoryId | integer | no | — |
| accountCode | string | no | — |
| description | string | no | — |
| discount | number | no | — |
| vatRateId | integer | no | — |
| vatPercentage | number | no | — |
| percentage | number | no | — |
Updates a BRC cash receipt using merged fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Cash receipt id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC cash receipt by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true appl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | cash receipt id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes a batch of BRC cash receipts. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Lists BRC payments.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC payment by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Payment id. |
Creates a bank payment in supplier or analysed-account mode. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload previ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| note | string | yes | — |
| entryDate | string | no | Entry date in ISO format. Defaults to today. |
| procDate | string | no | Processing date in ISO format. Defaults to entryDate. |
| bookTranTypeId | integer | no | Cheques Entry / Payments book transaction type id. |
| total | number | yes | — |
| bankAccountId | integer | yes | — |
| bankAccountCode | string | yes | — |
| supplierId | integer | no | Supplier id for supplier payments. |
| acCode | string | no | Supplier account code for supplier payments. |
| analysisCategoryId | integer | no | Payments book analysis category id for the selected bank. |
| accountCode | string | no | Analysis account code matching analysisCategoryId, for example BP01. |
| description | string | no | Analysis line description. |
| reference | string | no | — |
| discount | number | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Updates a BRC payment using merged fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Payment id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC payment by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | payment id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes supplier or analysed bank payments in a batch. Results are reported per submitted item and partial success is possible. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Lists BRC bank accounts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Gets one BRC bank account by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Bank account id. |
Creates a bank account after an unconfirmed preview. confirmCreate applies the previewed creation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | no | Optional raw bank account payload. |
| acCode | string | no | Bank account code, for example 1603. |
| details | string | no | Bank account description/name. |
| nominalAcCode | string | no | Existing linked nominal account code. This must already exist in Big Red Cloud and will be sent to the API as account.acCode. |
| lastChq | string | no | Last cheque number, for example 000001. |
| categoryId | integer | no | Bank Payments category type id from brc_list_category_types. |
| balance | number | no | Opening/current starting balance. |
| isDefaultBank | boolean | no | — |
| address | array | no | — |
| accountName | string | no | — |
| businessIdentifierCode | string | no | — |
| internationalBankAccountNumber | string | no | — |
| creditorScheme | string | no | — |
| sortCode | string | no | — |
| accountNumber | string | no | — |
| bankFeedsSource | integer | no | — |
| confirmCreate | boolean | no | Must be true only after the user explicitly confirms creation. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Updates a BRC bank account using merged fields. An unconfirmed call returns a plain-English change preview. Explicit confirmation is required before the update is applied. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Bank account id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes the specified bank account after explicit confirmation. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload pr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | bank account id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Gets one BRC product by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Product id. |
Creates a BRC product using a raw BRC payload. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWri
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| payload | object | yes | Raw BRC-compatible payload for this endpoint. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Updates a BRC product using merged fields. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | Product id. | |
| updates | object | no | Fields to merge into the existing record. |
| payload | object | no | Alias for updates. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Deletes a BRC product by id. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | yes | product id. | |
| confirmDelete | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes purchases in a batch using structured generated-reference purchase items. Results are reported per submitted item and partial success is possible. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| confirmCrAnalysisCategory | boolean | no | Applies to every sales document item in this batch. Set true only after the user confirms a CR (customer) sales analysis account code is intentional for these product lines. |
| priceBasis | string | no | Applies to every sales invoice/credit note item in this batch. Required when Gross Price Entry is enabled. Use gross when unit prices are VAT-inclusive/gross. Use net when unit prices are VAT-excl |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Processes a batch of quotes using either verified flat creator fields or a complete nested BRC Quote payload. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| confirmCrAnalysisCategory | boolean | no | Applies to every sales document item in this batch. Set true only after the user confirms a CR (customer) sales analysis account code is intentional for these product lines. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Processes sales credit notes in a batch using reconciled product, VAT and Sales-analysis lines. Results are reported per submitted item and partial success is possible. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-co
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| confirmCrAnalysisCategory | boolean | no | Applies to every sales document item in this batch. Set true only after the user confirms a CR (customer) sales analysis account code is intentional for these product lines. |
| priceBasis | string | no | Applies to every sales invoice/credit note item in this batch. Required when Gross Price Entry is enabled. Use gross when unit prices are VAT-inclusive/gross. Use net when unit prices are VAT-excl |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Processes a batch of sales entries using verified structured creator fields. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: tr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| confirmCrAnalysisCategory | boolean | no | Applies to every sales document item in this batch. Set true only after the user confirms a CR (customer) sales analysis account code is intentional for these product lines. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Processes sales invoices in a batch using reconciled product, VAT and Sales-analysis lines. Results are reported per submitted item and partial success is possible. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confir
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| confirmCrAnalysisCategory | boolean | no | Applies to every sales document item in this batch. Set true only after the user confirms a CR (customer) sales analysis account code is intentional for these product lines. |
| priceBasis | string | no | Applies to every sales invoice/credit note item in this batch. Required when Gross Price Entry is enabled. Use gross when unit prices are VAT-inclusive/gross. Use net when unit prices are VAT-excl |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
| confirmCounterpartyExplicit | boolean | no | Must be true only after the user explicitly named or confirmed the customer, supplier, or other counterparty in the current conversation. Never set true because a customer or supplier appeared in an e |
Processes a batch of sales representatives using explicit code and name fields. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes a batch of suppliers using explicit identity, VAT classification, and optional contact fields. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A c
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes a batch of customers using explicit identity, VAT classification, and optional contact fields. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A c
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Processes a batch of products using explicit product type, VAT classification, price, and description fields. Maximum 20 items per batch request. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| items | array | yes | Batch items to process. Maximum 20 items per request. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Lists combined BRC sales entries, sales invoices and sales credit notes.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| page | integer | no | — |
| pageSize | integer | no | — |
| filter | string | no | Optional OData $filter expression, only if this endpoint supports filtering. |
| orderBy | string | no | Optional OData $orderby expression, only if this endpoint supports ordering. |
| top | integer | no | — |
| skip | integer | no | — |
Processes VAT rates for VAT categories via POST /v1/vatCategories/vatRates. Requires a full vatCategoryRates array and confirmProcess=true. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| vatCategoryRates | array | no | Full BRC payload array for POST /v1/vatCategories/vatRates, e.g. [{ vatCategoryId: 1, vatRates: [...] }]. |
| effectiveDate | string | no | Not a valid standalone payload. Use vatCategoryRates instead. |
| payload | object | no | Deprecated. Use vatCategoryRates instead of a raw payload object. |
| confirmProcess | boolean | no | — |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Returns the deployment capability and permission summary, including enabled action groups and development-mode status.
No parameter schema on file.
Checks whether a proposed transaction date is inside the connected BRC company's current financial year.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| transactionDate | string | yes | Date to validate in YYYY-MM-DD format. |
Returns overall company readiness across connection, financial year, reference data, VAT, analysis categories and settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
Resolves a company-specific bookTranTypeId against live transaction-type reference data. Descriptions and numeric IDs are not globally stable.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| bookTranTypeId | integer | yes | — |
Classifies a supplied request as help, action, correction or unsupported. Classification covers read, create, update, delete, correct, undo, reverse, email and batch actions, including creating a sales invoice or add a customer, plus help wording such as how do I. Action results include allowed tools and an opaque routeToken. Help and correction results do not issue transactional route tokens.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| message | string | yes | The user's complete original message to classify, for example add a customer or how do I add a customer. |
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
Returns Big Red Cloud help and manual Big Red Cloud instructions for how-to questions, including how do I queries and tutorials. Covers topics including sales invoices, purchases, customers, suppliers, banking, VAT, reports and company setup. Searches Freshdesk, YouTube, BRC Edu, webinars and screenshots. Read-only and available without a connected company.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Text after the red-help command, for example how do I add a sales invoice or add a customer manually. |
Searches Big Red Cloud customer help across Freshdesk support articles, customer documentation, recorded webinar videos and upcoming webinars. Returns a synthesized answer, ordered guidance and public source metadata. Read-only and available without a connected company.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| question | string | yes | Plain-English help question, for example how do bank feeds work or how do I reconcile my bank account. |
| category | string | no | Optional help category filter, for example bank_feeds or sales. |
| maxResults | integer | no | Maximum number of matching resources to return. Defaults to 5. |
| source | string | no | Optional source filter: freshdesk, customer_docs, recorded_webinar, youtube_video, upcoming_webinar, or all. |
Returns detailed public help-resource content, ordered instruction blocks, signed screenshot links, source metadata and optional image content. Read-only and available without a connected company.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| resourceId | string | yes | Resource ID from brc_red_help or brc_find_help_resources, for example customer_docs:bank-reconciliation or freshdesk:1001. |
| includeImages | boolean | no | When true, Freshdesk articles may include screenshot presentation. Defaults to true. |
| maxImages | integer | no | Maximum Freshdesk screenshots to return. Defaults to 5. Hard maximum 8. |
| question | string | no | Optional customer question used to select the matching Freshdesk workflow screenshots, for example an existing-customer opening balance question versus adding a new customer. |
| imagePresentation | string | no | How to present Freshdesk screenshots. Defaults to links (signed Markdown links only). Use inline for MCP image blocks, or both for Markdown plus image blocks. |
Returns the protected education-administration URL. Access requires Microsoft Entra sign-in and does not bypass authentication. The response contains no upload secret or bypass parameter.
No parameter schema on file.
Returns current-session audit entries scoped to currently connected companies. Entries from other sessions, connections or companies are excluded.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| includeTechnicalDetails | boolean | no | Only set this to true if the user asks for technical details. Sensitive values are still redacted. |
Returns a downloadable support diagnostic and a concise summary for the current session.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Currently connected company to include in the diagnostic report. |
Clear the Red audit log for this MCP server session. A call without confirmWrite: true returns confirmation_required and a payload preview. confirmWrite: true applies the previewed change after explicit confirmation. Passing preflight is not confirmation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| confirmClear | boolean | no | Must be true to confirm that the session audit log should be cleared. |
| confirmWrite | boolean | no | Must be true only after a plain-English preview before posting has been shown in the current conversation and the user explicitly confirmed posting (for example yes, create it / post it now / confirm) |
Sends a sales-invoice email to the customer address or an explicit recipient override. An unconfirmed call returns an email preview; confirmSend applies the send. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirma
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| salesInvoiceId | integer | yes | BRC field: salesInvoiceId. |
| fromAddress | string | no | Optional sender address override. |
| toAddress | string | no | Optional single recipient override. If omitted or empty, BRC uses the customer's email address. |
| toAddresses | array | no | Optional list of recipients. If more than one is provided, ask the user whether to send one email with BCC or separate individual emails. |
| sendMode | string | no | How to handle multiple recipients. Use separate only when the user explicitly asks to send separate individual emails. |
| bccAddresses | array | no | Optional BCC email addresses. Only use if the user explicitly provides BCC addresses or chooses one email with BCC. |
| messageBody | string | no | Optional custom email message body. |
| confirmSend | boolean | no | Must be true only after the user has reviewed the email preview and explicitly confirmed sending. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Sends a customer-statement email to the customer address or an explicit recipient override. An unconfirmed call returns an email preview; confirmSend applies the send. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-con
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| customerId | integer | yes | BRC field: customerId. |
| fromPeriod | string | no | Statement period start (ISO date-time, e.g. 2026-01-01T00:00:00). |
| toPeriod | string | no | Statement period end (ISO date-time, e.g. 2026-05-31T00:00:00). |
| minBalance | number | no | Minimum balance threshold for transactions included on the statement. |
| fromAddress | string | no | Optional sender address override. |
| toAddress | string | no | Optional single recipient override. If omitted or empty, BRC uses the customer's email address. |
| toAddresses | array | no | Optional list of recipients. If more than one is provided, ask the user whether to send one email with BCC or separate individual emails. |
| sendMode | string | no | How to handle multiple recipients. Use separate only when the user explicitly asks to send separate individual emails. |
| bccAddresses | array | no | Optional BCC email addresses. Only use if the user explicitly provides BCC addresses or chooses one email with BCC. |
| messageBody | string | no | Optional custom email message body. |
| confirmSend | boolean | no | Must be true only after the user has reviewed the email preview and explicitly confirmed sending. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Sends a quote email to the customer address or an explicit recipient override. An unconfirmed call returns an email preview; confirmSend applies the send. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation req
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| quoteId | integer | yes | BRC field: quoteId. |
| fromAddress | string | no | Optional sender address override. |
| toAddress | string | no | Optional single recipient override. If omitted or empty, BRC uses the customer's email address. |
| toAddresses | array | no | Optional list of recipients. If more than one is provided, ask the user whether to send one email with BCC or separate individual emails. |
| sendMode | string | no | How to handle multiple recipients. Use separate only when the user explicitly asks to send separate individual emails. |
| bccAddresses | array | no | Optional BCC email addresses. Only use if the user explicitly provides BCC addresses or chooses one email with BCC. |
| messageBody | string | no | Optional custom email message body. |
| confirmSend | boolean | no | Must be true only after the user has reviewed the email preview and explicitly confirmed sending. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Returns company processing settings that affect VAT-sensitive accounting workflows.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| includeRaw | boolean | no | If true, includes the raw BRC settings record for operator review. Customer-facing responses should normally leave this false. |
Returns quote and transaction reference settings. An Unknown quote-reference setting does not establish automatic reference generation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| includeRaw | boolean | no | If true, includes the raw BRC company setup record for operator review. Customer-facing responses should normally leave this false. |
Returns processing-setting warnings for one specified transaction workflow. It does not provide an overall company-readiness score.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| workflow | string | yes | The workflow to check against the company processing settings. |
Returns receiver transactions eligible for allocation updates.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| bookTranId | integer | yes | Book transaction id to allocate from, for example 1001. |
Updates transaction allocations using eligible receiver transactions and an unconfirmed payload preview. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true retur
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| bookTranId | integer | yes | Book transaction id to allocate from, for example 1001. |
| allocationResolvers | array | yes | Allocations to create or update. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms posting the allocation update. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Returns existing transaction allocations and their identifiers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| bookTranId | integer | yes | Book transaction id to allocate from, for example 1001. |
Reverses or deletes the specified allocation after returning an unconfirmed preview. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_requ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Allocation resolver id to reverse/delete. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms reversing/deleting this allocation. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Returns nominal journal batches with identifiers and concurrency timestamps.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| filter | string | no | Optional OData filter. Filtering is allowed by entryDate, for example: entryDate ge 2024-01-01T00:00:00 |
| orderBy | string | no | Optional OData order by. Ordering is allowed by id, for example: id desc. |
| top | integer | no | Optional page size. |
| skip | integer | no | Optional number of records to skip. |
Returns information about a single Nominal Journal Batch by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Nominal Journal Batch id. |
Creates a nominal journal batch after returning an unconfirmed payload preview. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| bookTranTypeId | integer | no | Book transaction type id. Nominal Journal Batch is usually 7. |
| entryDate | string | yes | Entry date, for example 2024-01-15T00:00:00. |
| procDate | string | yes | Processing date, for example 2024-01-15T00:00:00. |
| total | number | yes | Total journal amount. |
| accountTransactions | array | yes | Nominal journal account transaction lines. Debits and credits should balance. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms creating this Nominal Journal Batch. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Updates a nominal journal batch using its current concurrency timestamps. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Nominal Journal Batch id. |
| bookTranTypeId | integer | no | Book transaction type id. Nominal Journal Batch is usually 7. |
| entryDate | string | yes | Date/time string, for example 2024-01-15T00:00:00. |
| procDate | string | yes | Date/time string, for example 2024-01-15T00:00:00. |
| total | number | yes | — |
| timestamp | string | yes | Base64 timestamp for the nominal journal batch. |
| accountTransactions | array | yes | Updated nominal journal account transaction lines. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms updating this Nominal Journal Batch. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Deletes a nominal journal batch using its current concurrency timestamp. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Nominal Journal Batch id. |
| timestamp | string | yes | Base64 timestamp returned by the Nominal Journal Batch, for example 7aIZQIbL3gg=. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms deleting this Nominal Journal Batch. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Returns a list of the company's Accruals. Supports optional OData filtering by entryDate. Supports optional ordering by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| filter | string | no | Optional OData filter. Filtering is allowed by entryDate, for example: entryDate ge 2024-03-01T00:00:00. |
| orderBy | string | no | Optional OData order by. Ordering is allowed by id, for example: id desc. |
| top | integer | no | Optional page size. |
| skip | integer | no | Optional number of records to skip. |
Returns information about a single parent Accrual by id. Child accruals are not exposed by the public API.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent accrual id. |
Creates an accrual after returning an unconfirmed payload preview. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| acCode | string | yes | Nominal account code, for example 4000. |
| entryDate | string | yes | Entry date, for example 2024-03-01T00:00:00. |
| procDate | string | yes | Processing date, for example 2024-03-15T00:00:00. |
| reference | string | yes | Accrual reference, for example ACC0001. |
| total | number | yes | Accrual total amount. |
| firstDetail | string | no | First detail text. |
| secondDetail | string | no | Second detail text. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms creating this accrual. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Updates an accrual using its current concurrency timestamp. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload previe
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent accrual id. |
| acCode | string | yes | Nominal account code, for example 4000. |
| entryDate | string | yes | Entry date, for example 2024-03-01T00:00:00. |
| procDate | string | yes | Processing date, for example 2024-03-15T00:00:00. |
| reference | string | yes | Accrual reference, for example ACC0001. |
| total | number | yes | Accrual total amount. |
| timestamp | string | yes | Base64 timestamp returned by the accrual, for example K94UQIbL3gg=. |
| firstDetail | string | no | First detail text. |
| secondDetail | string | no | Second detail text. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms updating this accrual. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Deletes an accrual using its current concurrency timestamp. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload previe
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent accrual id. |
| timestamp | string | yes | Base64 timestamp returned by the accrual, for example K94UQIbL3gg=. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms deleting this accrual. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Returns a list of the company's Prepayments. Supports optional OData filtering by entryDate. Supports optional ordering by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| filter | string | no | Optional OData filter. Filtering is allowed by entryDate, for example: entryDate ge 2024-03-01T00:00:00. |
| orderBy | string | no | Optional OData order by. Ordering is allowed by id, for example: id desc. |
| top | integer | no | Optional page size. |
| skip | integer | no | Optional number of records to skip. |
Returns information about a single parent Prepayment by id. Child prepayments are not exposed by the public API.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent prepayment id. |
Creates a prepayment after returning an unconfirmed payload preview. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a paylo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| acCode | string | yes | Nominal account code, for example 4000. |
| entryDate | string | yes | Entry date, for example 2024-03-01T00:00:00. |
| procDate | string | yes | Processing date, for example 2024-03-15T00:00:00. |
| reference | string | yes | Prepayment reference, for example PRE0001. |
| total | number | yes | Prepayment total amount. |
| firstDetail | string | no | First detail text. |
| secondDetail | string | no | Second detail text. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms creating this prepayment. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Updates a prepayment using its current concurrency timestamp. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload prev
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent prepayment id. |
| acCode | string | yes | Nominal account code, for example 4000. |
| entryDate | string | yes | Entry date, for example 2024-03-01T00:00:00. |
| procDate | string | yes | Processing date, for example 2024-03-15T00:00:00. |
| reference | string | yes | Prepayment reference, for example PRE0001. |
| total | number | yes | Prepayment total amount. |
| timestamp | string | yes | Base64 timestamp returned by the prepayment, for example bgUcQIbL3gg=. |
| firstDetail | string | no | First detail text. |
| secondDetail | string | no | Second detail text. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms updating this prepayment. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Deletes a prepayment using its current concurrency timestamp. Requires a valid routeToken issued for the matching action workflow. The token remains valid through lookup, preview and the permitted transaction. Placeholder tokens are invalid. A routeToken does not bypass preview or explicit-confirmation requirements. A call without confirmWrite: true returns confirmation_required and a payload prev
| Parameter | Type | Required | Notes |
|---|---|---|---|
| connectionRef | string | no | Opaque Red connection reference returned by brc_confirm_company_connection. Pass this exact value on every later tool call when the MCP client rotates session ids (for example Vibe/Mistral). Keep reus |
| companyName | string | yes | Company context name, for example YOUR-COMPANY-NAME. |
| id | integer | yes | Parent prepayment id. |
| timestamp | string | yes | Base64 timestamp returned by the prepayment, for example bgUcQIbL3gg=. |
| confirmWrite | boolean | no | Must be true only after the user explicitly confirms deleting this prepayment. |
| routeToken | string | yes | Opaque routeToken from brc_route_request for this action workflow. Required for transactional tools. Routing permission only — does not replace preview-before-posting or confirmWrite. |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Red by Big Red Cloud or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.4.0.
1.4.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Red by Big Red Cloud can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.