get_balance
Get your Xendit account balance. Returns available balance by account type (CASH, HOLDING, TAX).
LABSCO SUMMARY
The first tool asks a question about your own setup, which is an unusual thing for a server to offer and exactly right for a payments one.
get_workspace_mode reports which actions the current configuration enables and names the safest next step towards more, and guided_setup writes the configuration for the mode you choose — read-only, invoices or guarded payouts — with allowLive, allowedAccounts, maxDailyAmount and maxDisbursementAmount as explicit ceilings. Escalating from reading to moving money is therefore a deliberate configuration change rather than a call that happens to be available. The reads themselves are plain and useful: get_balance separates CASH, HOLDING and TAX, and list_transactions puts payments in, payouts, refunds, transfers and balance adjustments in one place.
What it is
A Xendit client with 6 tools: account balance, invoice listing and detail, and transaction listing, plus a mode report and a guided setup that writes the configuration snippet for read-only, invoices or guarded payouts.
What you get
- get_workspace_mode explains the current mode, which actions it enables, and the safest next step towards more access.
- guided_setup generates a Claude Code or Claude Desktop configuration snippet for read-only, invoices or guarded payouts mode, with allowLive, allowedAccounts, maxDailyAmount and maxDisbursementAmount as the ceilings, using a form where the client supports MCP elicitation.
- get_balance returns the account balance by account type across CASH, HOLDING and TAX.
- list_invoices filters by status, currency and a created-after and created-before window with a limit; get_invoice returns one invoice by ID.
- list_transactions covers payments received, payouts, refunds, transfers and balance adjustments, filterable by type, status, currency and creation window.
Requirements
A Xendit account and its API key in XENDIT_API_KEY. What that key is permitted to do depends on the configured mode, and get_workspace_mode reports which one is active.
Setup effort
One command plus a key — npm install -g xendit-mcp, then supply credentials
USE CASES
01
Finding out what this connection is currently allowed to do
The mode report names the enabled actions and the safest next step; the setup tool writes the configuration for whichever mode you decide on.
02
Checking the balance before promising a payout
Balance is split by account type, so available cash is distinguishable from what is being held or set aside for tax.
03
Chasing an unpaid invoice
Status and a creation window narrow the list to what is actually outstanding, and the detail read gives one invoice in full.
04
Reconciling a period's money movement
One transaction read covers money in, money out and the adjustments between, with the balance and invoice lists to check it against.
6 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_invoice
Get details of a specific Xendit invoice by ID.
get_workspace_mode
Explain the current Xendit MCP mode, what actions are enabled, and the safest next step to enable more access.
guided_setup
Generate a safe Claude Code or Claude Desktop setup snippet for read-only, invoices, or guarded payouts mode. Uses a form when the client supports MCP elicitation.
list_invoices
List invoices from your Xendit account with optional filters for status, date range, and pagination.
list_transactions
List transactions from your Xendit account. Includes payments received, payouts, refunds, transfers, and balance adjustments.
BEFORE YOU INSTALL
What to know first
Tools you get
6 tools when we connected; the project documents 14. Read-only is the default since 0.2.0. XENDIT_ENABLE_INVOICE_MUTATIONS=true adds invoice tools; XENDIT_ENABLE_DISBURSEMENTS=true adds payout tools, and create_disbursement also needs XENDIT_ENABLE_LEGACY_ONE_SHOT_DISBURSEMENT=true.
Requires
- npx on PATH
- XENDIT_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g xendit-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"xendit": {
"command": "npx",
"args": [
"-y",
"xendit-mcp"
],
"env": {
"XENDIT_API_KEY": "<YOUR_XENDIT_API_KEY>"
}
}
}
}claude_desktop_config.json
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add xendit --env XENDIT_API_KEY=<YOUR_XENDIT_API_KEY> -- npx -y xendit-mcpAny MCP client — Setup helper
ANY MCP CLIENT — SETUP HELPER · TERMINAL
npx xendit-mcp setup
