# Obolus

> Obolus is a free MCP server for finance and payments. Read-only take-home pay and cross-country tax comparisons for eight countries. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://www.obolusfinanz.de/en/developers
- **Repository:** https://github.com/sanzation/obolus-finance-api
- **MCP Registry name:** io.github.sanzation/obolus
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Obolus exposes a small, deliberately narrow payroll API to agents. Two tools do the work: berechne produces a detailed payroll calculation for one country, and taxcompare lines up two or more countries for the same salary and tax year. Both are read-only and need no login or API key.

Supported countries are Germany, Austria, Switzerland, the United States, the United Kingdom, Ireland, Canada and Australia. Salaries go in as minor currency units, so 6000000 with currency eur and an annual period means EUR 60,000. The README suggests asking an assistant to compare EUR 60,000 in Germany and Austria for 2026, and says the assistant should ask for missing profile details rather than invent them.

Results are payroll and tax estimates, and the README warns not to present net pay as disposable income, because housing, groceries and other costs are separate models. Other Obolus features such as Cockpit, Budget and Invest are not part of the public API. The same scope is also available as REST with an OpenAPI spec, and rate limits apply, for example 20 comparison requests per five minutes over REST.

## Features

- **Single-country payroll:** berechne gives a detailed gross-to-net calculation for one country.
- **Multi-country comparison:** taxcompare compares two or more countries for one salary and tax year.
- **Eight countries:** Germany, Austria, Switzerland, the US, UK, Ireland, Canada and Australia.
- **No key needed:** Public read-only tools work without login or API key.
- **REST and OpenAPI:** The same tools are available over REST with a schema.
- **Returned assumptions:** Results include assumptions and sources to inspect.

## Good for

- Compare take-home pay for a salary in Germany and Austria
- Estimate net pay for a job offer in another country
- Build a salary calculator on top of the API
- Let an assistant explain a payroll breakdown

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http obolus https://www.obolusfinanz.de/api/mcp/public
```

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

```sh
https://www.obolusfinanz.de/api/mcp/public
```

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

```json
{
  "mcpServers": {
    "obolus": {
      "url": "https://www.obolusfinanz.de/api/mcp/public"
    }
  }
}
```

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

```json
{
  "servers": {
    "obolus": {
      "type": "http",
      "url": "https://www.obolusfinanz.de/api/mcp/public"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "obolus": {
      "serverUrl": "https://www.obolusfinanz.de/api/mcp/public"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "obolus": {
      "type": "http",
      "url": "https://www.obolusfinanz.de/api/mcp/public"
    }
  }
}
```

## Tools

- `berechne`: Detailed payroll calculation for a single country.
- `taxcompare`: Compare payroll and tax results across two or more countries.

## FAQ

### Do I need an API key?

No for the public read-only tools; keys are optional and not self-service today.

### Which countries are covered?

Germany, Austria, Switzerland, the United States, the United Kingdom, Ireland, Canada and Australia.

### Is net pay the same as disposable income?

No. It is a payroll and tax result and excludes housing, groceries and other living costs.

### Are there rate limits?

Yes. For example REST taxcompare allows 20 requests per 5 minutes, and MCP POST allows 200 per 5 minutes.

### Is Obolus free?

Yes. Obolus is free to use.

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

Run this command in your terminal: claude mcp add --transport http obolus https://www.obolusfinanz.de/api/mcp/public

### What are the best alternatives to Obolus?

The closest alternatives to Obolus 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/obolus-2
