# BillOS

> BillOS is a freemium MCP server for finance and payments. Issue, correct and report Israeli tax invoices and receipts in a registered ledger. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://dev.billos.co.il/ai/
- **MCP Registry name:** il.co.billos/billos
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Documents made through this server are numbered in sequence and signed, and the site says BillOS is registered in the Israel Tax Authority software register. A live key opens a real ledger; a test key talks only to a sandbox with a separate database and watermarked PDFs, and cannot touch a real book. Without a key, a coding agent can request one and show you a link to approve with Google sign-in.

Fifteen tools run on the same ledger as the REST API, behind the same key, metering and quotas of 60 calls a minute. Safeguards are explicit: amounts are in agorot, dryRun validates without issuing, idempotencyKey prevents double issue, cancellation is a credit note, issued documents cannot be deleted, there is no delete tool and keys cannot be created over MCP. The example call is create_document with a document type such as an invoice-receipt.

Live use costs 39 shekels a month per business, with unlimited documents; the sandbox is free. The pages are in Hebrew.

## Features

- **Fifteen ledger tools:** Issue, correct and cancel documents, record expenses and pull reports on one ledger.
- **Sandbox first:** Test keys use a separate database and cannot reach a real ledger.
- **Safe issuing:** dryRun checks everything without issuing and idempotencyKey blocks duplicates.
- **Credit-note cancellation:** Cancelling creates a credit note and issued documents are never deleted.
- **Agent key approval:** An agent can request a sandbox key and you approve it through a link.
- **Explained refusals:** Rejections include reason, hint and param.

## Good for

- Issue an invoice-receipt from a chat
- Correct an issued document with a credit note
- Record an expense
- Pull a report from the ledger
- Test an invoicing integration in a sandbox

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http billos https://api.billos.co.il/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.billos.co.il/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "billos": {
      "url": "https://api.billos.co.il/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "billos": {
      "type": "http",
      "url": "https://api.billos.co.il/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "billos": {
      "serverUrl": "https://api.billos.co.il/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "billos": {
      "type": "http",
      "url": "https://api.billos.co.il/mcp"
    }
  }
}
```

## Tools

- `create_document`: Issues a tax document such as an invoice-receipt with customer, lines, payment method and idempotencyKey.

## FAQ

### What does it cost?

The sandbox is free; live is 39 shekels a month per business with no document limit.

### Can an agent delete a document?

No. There is no delete tool and issued documents cannot be deleted.

### Can an agent create API keys over MCP?

No. Key issuing is not available through MCP.

### What are the rate limits?

60 calls a minute per key.

### Is BillOS free?

BillOS has a free plan, with paid plans for more usage or features.

### How do I add BillOS to Claude Code?

Run this command in your terminal: claude mcp add --transport http billos https://api.billos.co.il/mcp

### What are the best alternatives to BillOS?

The closest alternatives to BillOS are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/billos
