API & MCP
Everything a person can do on Ledgerly Is It Peanuts? Relative Scale, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://ledgerlyrelativescale.usefulweb.app/api/v1/calculate– run Ledgerly Is It Peanuts? Relative ScaleGET https://ledgerlyrelativescale.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Ledgerly Is It Peanuts? Relative Scale
Compares a big amount — a donation, a fine, a bonus or a price — with the wealth of whoever pays it and scales the same share to your net worth, your hourly income and a median household. The reverse check scales your own gift up to their fortune. Part of Ledgerly’s Reality Check.
| Field | Type | Default | Description |
|---|---|---|---|
currency | text | "EUR" | Currency |
amount | number | 100000000 | The big amount (gift, fine, price …) |
theirWealth | number | 50000000000 | Net worth of the giver or payer |
yourWealth | number | 120000 | Your net worth |
yourIncome | number | 42000 | Your net income per year |
workHoursPerYear | number | 1700 | Your working hours per year |
population | number | 0 | Population to share it among (0 = skip) |
yourGift | number | 0 | Your own gift for the reverse check (0 = skip) |
country | select (none, EA, AT, BE, HR, CY, CZ, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PT, SK, SI, ES) | "none" | Also compare with a typical household in |
Example request
$100 million gift from a $50 billion fortune
curl -X POST https://ledgerlyrelativescale.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"currency":"USD","amount":100000000,"theirWealth":50000000000,"yourWealth":120000,"yourIncome":52000,"workHoursPerYear":1800}'Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://ledgerlyrelativescale.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
ledgerly_relative_scale - Local stdio connector:
node src/mcp-stdio.ts --tool=ledgerly-relative-scale
{
"mcpServers": {
"ledgerly-relative-scale": { "type": "http", "url": "https://ledgerlyrelativescale.usefulweb.app/mcp" }
}
}