API & MCP
Everything a person can do on Sizewise Money Stack, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://sizewisemoneystack.usefulweb.app/api/v1/calculate– run Sizewise Money StackGET https://sizewisemoneystack.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Sizewise Money Stack
Turns an amount of money into banknotes: how many notes, how high the stack, what it weighs, the area laid flat and how many EUR-pallets it fills, compared with real objects. US dollar and euro note sizes from the issuers, or your own notes.
| Field | Type | Default | Description |
|---|---|---|---|
amount | text | "1 million" | Amount. For example 10000, 1 million, 2.5 billion or 1e12. |
currency | select (usd, eur, custom) | "usd" | Notes |
denomination | number | 100 | Value of one note |
thicknessMm | number | 0.11 | Thickness of one note (euro and own notes) |
massG | number | 0 | Mass of one note (own notes, optional) |
noteLengthMm | number | 150 | Note length (own notes) |
noteWidthMm | number | 70 | Note width (own notes) |
loadHeightM | number | 1 | Load height on a pallet |
Example request
One million dollars in $100 notes
curl -X POST https://sizewisemoneystack.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"amount":"1 million","currency":"usd","denomination":100}'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://sizewisemoneystack.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
sizewise_money_stack - Local stdio connector:
node src/mcp-stdio.ts --tool=sizewise-money-stack
{
"mcpServers": {
"sizewise-money-stack": { "type": "http", "url": "https://sizewisemoneystack.usefulweb.app/mcp" }
}
}