API & MCP

Everything a person can do on Ledgerly Income & Wealth Percentile, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://ledgerlywealthpercentile.usefulweb.app/api/v1/calculate – run Ledgerly Income & Wealth Percentile
GET https://ledgerlywealthpercentile.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Ledgerly Income & Wealth Percentile

Places your household net income (Eurostat EU-SILC, 34 European countries) or net wealth (ECB Household Finance and Consumption Survey, euro area) among the people or households of your country, with the published cut points, your household-size equivalent and the EU or euro-area position. Interpolation is explained and every figure carries its source and year.

Inputs of Ledgerly Income & Wealth Percentile
Field	Type	Default	Description
`measure`	select (income, wealth)	"income"	Compare
`country`	select (EA, EU, AL, AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, ME, NL, MK, NO, PL, PT, RO, RS, SK, SI, ES, SE, CH, TR)	"DE"	Country
`amount`	number	52000	Your amount. Income: disposable household income per year after taxes and social contributions, including benefits. Wealth: everything you own (home, savings, investments, vehicles, business) minus all debts.
`currency`	select (EUR, national)	"EUR"	Currency of the amount
`adults`	integer	2	People aged 14 or over in the household
`children`	integer	0	Children under 14 in the household

Example request

Germany: couple with €52,000 net income

curl -X POST https://ledgerlywealthpercentile.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"measure":"income","country":"DE","amount":52000,"currency":"EUR","adults":2,"children":0}'

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://ledgerlywealthpercentile.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: ledgerly_wealth_percentile
Local stdio connector: node src/mcp-stdio.ts --tool=ledgerly-wealth-percentile

{
  "mcpServers": {
    "ledgerly-wealth-percentile": { "type": "http", "url": "https://ledgerlywealthpercentile.usefulweb.app/mcp" }
  }
}