Developer Docs

CoinsBucket exposes a REST API and an MCP server so you can read and write your budget data from any app, script, or AI assistant.

REST API

Standard HTTP endpoints for reading budget status, listing expenses, adding expenses, and getting forecasts.

View reference →

MCP Server

Connect CoinsBucket directly to Claude Desktop or any MCP-compatible AI assistant. Ask about your budget in plain language.

View setup →

Requires Max plan

API keys and MCP access are available on the Max plan. Upgrade to unlock.

Quick start

1. Generate an API key

Go to Settings → API Keys and click Generate key. Your key starts with rpk_. Copy it — it won't be shown again.

2. Make your first request

bash

curl https://repikue.com/api/v1/budget \
  -H "Authorization: Bearer rpk_your_key_here"

Response:

json

{
  "period": {
    "startDate": "2026-04-01",
    "endDate": "2026-04-30",
    "income": 3000,
    "fixedExpenses": 1200,
    "savingsGoal": 300,
    "periodType": "monthly"
  },
  "budget": {
    "totalBudget": 1500,
    "dailyBudget": 42.50,
    "spentToday": 18.00,
    "totalSpent": 312.00,
    "moneyLeft": 1188.00,
    "daysLeft": 21,
    "status": "on-track"
  }
}

3. Explore the reference

See the full REST API reference for all endpoints, parameters, and error codes. Or jump to the MCP server guide to connect directly to Claude.