
Obolus
Read-only take-home pay and cross-country tax comparisons for eight countries
- Pricing
- Free
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 1.0.4
- Listing updated
- 2 days ago
About Obolus
Obolus is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http obolus https://www.obolusfinanz.de/api/mcp/publicAdd to Settings → Connectors → Add custom connector
https://www.obolusfinanz.de/api/mcp/publicAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"obolus": {
"url": "https://www.obolusfinanz.de/api/mcp/public"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"obolus": {
"type": "http",
"url": "https://www.obolusfinanz.de/api/mcp/public"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"obolus": {
"serverUrl": "https://www.obolusfinanz.de/api/mcp/public"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"obolus": {
"type": "http",
"url": "https://www.obolusfinanz.de/api/mcp/public"
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- berechne
- Detailed payroll calculation for a single country.
- taxcompare
- Compare payroll and tax results across two or more countries.
What it does
- 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
Pricing
Free
Public read-only tools need no key; terms and rate limits apply
Prices change. Check obolusfinanz.de before you buy.
Obolus 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 to Obolus

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government