Invoicebox
MCP server letting AI assistants issue Invoicebox invoices, check payments and process
Invoicebox is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, API, Self-hosted
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add mcp-server --env INVOICEBOX_API_TOKEN='<INVOICEBOX_API_TOKEN>' --env INVOICEBOX_MERCHANT_ID='<INVOICEBOX_MERCHANT_ID>' -- npx -y @invoicebox/mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
"INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
"INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
"INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
"INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@invoicebox/mcp-server"
],
"env": {
"INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
"INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
INVOICEBOX_API_TOKENТокен API Инвойсбокса. Выпускается в личном кабинете; правами токена ограничивается то, что сервер вообще может сделатьRequiredINVOICEBOX_MERCHANT_IDИдентификатор магазина, от имени которого работает серверRequiredINVOICEBOX_ENVКонтур: demo или prod. По умолчанию demo — боевой включается явноINVOICEBOX_TOOLSETSНаборы инструментов через запятую: read по умолчанию, write и refund включаются явноINVOICEBOX_STATE_DIRКаталог состояния: без него защита от дублей действует только в пределах одного запуска
About Invoicebox
The Invoicebox MCP server connects assistants such as Claude Desktop, Cursor and VS Code to the Invoicebox billing API, so an invoice can be drafted, sent as a payment link and tracked from inside a chat instead of the merchant dashboard. Every money-moving action goes through a two-step flow: the first call returns a summary and a one-time token valid for 15 minutes, and only the second call executes it. Amounts above a configurable threshold trigger a separate human confirmation.
Access is read-only by default. Invoice creation, cancellation and shipment confirmation sit in a write toolset, and refunds in a separate refund toolset, both enabled explicitly through configuration. The README recommends starting against the public demo store, which is shared and should not receive real customer data.
The server is aimed at merchants and developers who already use Invoicebox and want assistant-driven billing for business buyers and individuals. It does not send invoices to buyers itself, manage subscriptions, charge saved cards, or list incoming payments, according to the product documentation.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- lookup_company_by_inn
- Company or sole trader details by INN
- get_order
- Invoice by identifier or merchant order number
- find_orders
- Invoice list filtered by number, status, dates and amounts
- find_shipments
- Shipments for an order and their status
- create_order
- Issues an invoice and returns a payment link
- cancel_order
- Cancels an unpaid invoice
- create_shipment
- Confirms a shipment; generates act, invoice and UPD documents
- create_refund
- Refunds a payment in full or by item
What it does
- Two-step confirmation
- Each write action first returns a summary and a short-lived token, and only a second call with that token runs it.
- Read-only default
- Only lookup and listing tools are active until the write or refund toolsets are switched on.
- Large-amount approval
- Transactions above a set threshold require the human operator to confirm rather than accepting the model's figure.
- Duplicate protection
- Operation identifiers are derived from the request content so a repeated call returns the earlier result instead of creating a second invoice.
- Company lookup by tax ID
- Buyer company details can be pulled from the Russian tax identifier (INN) when issuing an invoice.
- Stdio and HTTP transports
- Runs as a local stdio process by default, or as a Streamable HTTP server when a port is set.
Good for
- Issue an invoice to a business buyer from a chat and send the payment link in the same conversation
- Check whether a specific invoice has been paid using the merchant's own order number
- List unpaid invoices for a period to review amounts and due dates
- Confirm a shipment against an invoice so closing documents are generated
- Start a refund for a paid order, in full or for selected items, with explicit approval
Pricing
Open source
Open-source MCP server; it uses the Invoicebox API, which is a commercial service.
Prices change. Check docs.invoicebox.ru before you buy.
Invoicebox FAQ
Which assistants can use Invoicebox?
The README and documentation name Claude Desktop, Claude Code, Cursor, VS Code, Cline and Continue.dev as MCP clients, and note that LangChain and LangGraph agents can connect through an MCP adapter.
Are write operations enabled by default?
No. The default toolset is read only; write and refund toolsets must be enabled explicitly through the INVOICEBOX_TOOLSETS setting.
What does the server not do?
According to the documentation it does not keep a register of incoming payments, send invoices to buyers, manage subscriptions, charge saved cards or manage Витрина storefronts.
Is there a way to try Invoicebox without a contract?
The README describes a public demo store configured with ENV set to demo, which is shared among all readers and should not be used with real data.
Is Invoicebox free?
Yes. Invoicebox is open source, so you can use and self-host it for free.
How do I add Invoicebox to Claude Code?
Run this command in your terminal: claude mcp add mcp-server --env INVOICEBOX_API_TOKEN='<INVOICEBOX_API_TOKEN>' --env INVOICEBOX_MERCHANT_ID='<INVOICEBOX_MERCHANT_ID>' -- npx -y @invoicebox/mcp-server
What are the best alternatives to Invoicebox?
The closest alternatives to Invoicebox are QuickBooks Online MCP Server, QuickBooks Online, BTCPay Server MCP, Alternative Payments and Money Magician.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.