# Rudopo

> Envelope budgeting in many currencies, with a REST API and an MCP server over the same door the app uses. Read with a token; let a script or an assistant propose changes to a review inbox, or make them within limits the person sets.

Every developer page is served as Markdown at its own address with `.md`. Every write example defaults to `dry_run`, because there is no sandbox yet.

## Docs

- [Developers](https://rudopo.app/developers.md): Rudopo's REST API and MCP server: three ways to connect, three access levels, and what makes a write safe.
- [Connect an assistant](https://rudopo.app/developers/mcp.md): Rudopo's MCP server: how an assistant connects, every tool it can call, the three access levels and the review inbox.
- [API reference](https://rudopo.app/developers/reference.md): Every endpoint, parameter and response shape, generated from the OpenAPI description the server is checked against.
- [Errors](https://rudopo.app/developers/errors.md): Every error code the API answers with, its status, what it means and what to do.
- [Changelog](https://rudopo.app/developers/changelog.md): What changed in the API and the MCP server, newest first.
- [The whole surface on one page](https://rudopo.app/developers/llms-full.md): opens with the conventions a client has to know.

## Optional

- [MCP tool catalogue, JSON](https://rudopo.app/developers/mcp.json): every tool with its input and output schema.
- [OpenAPI document](https://rudopo.app/developers/reference): the HTML rendering; the JSON ships in the repository as docs/api/openapi.json.