Home / Servers / Brevo API / get_contact_balances
Get balance list
An MCP tool from the Brevo API server, hosted on mcp.hjlabs.in.
Get balance list Returns contact balances for a given balance definition across all subscriptions. [GET /loyalty/balance/programs/{pid}/contact-balances]
Name on the gateway: brevo_api__get_contact_balances · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
pid required | string | Loyalty Program Id |
includeInternal | boolean | Include balances tied to internal definitions. |
limit | integer | Limit the number of records returned |
offset | integer | Skip a number of records |
sort | asc | desc | Sort order |
sortField | updatedAt | value | Field to sort by |
balanceDefinitionId required | string | Balance Definition ID (required) |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "brevo_api__get_contact_balances",
"arguments": {
"pid": "…",
"balanceDefinitionId": "…"
}
}Or connect the Brevo API server directly, which lists 291 tools including this one:
claude mcp add --transport http hj-brevo-api https://mcp.hjlabs.in/mcp/brevo-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the get balance list tool with pid set to ….