Documentation
Build on vokse.
Everything you need to build on vokse: the REST API, webhooks, the data model and the MCP server. Start with the reference, or browse the guides.
Build on the same tools the app uses
The REST API, the MCP server and signed webhooks run through the same audited functions as the web app.
MCP server
Plug Claude, ChatGPT or any MCP client into your household over one URL with OAuth 2.1. Grants are read-only or full, per household.
Set up the MCP serverAPI reference
Every resource and operation, generated from the OpenAPI 3.0 spec the server ships. Scoped API keys, idempotent writes, one household per key.
Open API reference- operations documented
- 188
- resource groups
- 28
Webhooks
Signed deliveries for the events your integration cares about, with a dead-letter queue and replay when an endpoint was down.
Read the webhooks guideBrowse by topic
Pick a topic. Each card opens the page that documents it today.
Getting started
Create your first household · Connect a bank · Categorise your first transactions · Your first AI conversation
Read moreBudgeting
Zero-based budgeting model · Assigning + moving money · Categories + goals + recurrences
Read moreBank connections
How bank connections work (US and Canada today, European banks next) · Re-authentication every 90 days · Mapping bank accounts to vokse accounts
Read moreAI assistant
The tools the assistant uses · Pending actions + confirmation flow · Forecasts + AI refinement · Embeddings + similarity search
Read moreDeveloper
REST API · OpenAPI 3.0 spec · Webhooks · HMAC signatures · MCP server · Claude Desktop setup
Read morePrivacy & data
What we store · where · How to export your data (DSAR) · How to delete your account · GDPR data-processor contract
Read morevokse
OpenAPI 3.0 spec · auto-generated from the NestJS server. Try requests live in the browser.