Skip to content
MCP server

Obolus

Read-only take-home pay and cross-country tax comparisons for eight countries

Install
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/public

Add to Settings → Connectors → Add custom connector

https://www.obolusfinanz.de/api/mcp/public
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "obolus": {
      "url": "https://www.obolusfinanz.de/api/mcp/public"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government