MCP Server

The CoinsBucket MCP server lets you connect your budget to any Model Context Protocol-compatible AI assistant, including Claude Desktop. Ask questions like “How much can I spend today?” or “Log $12 for lunch” in natural language.

Requires Max plan

Generate an API key in Settings → API Keys before proceeding.

Setup

Claude Desktop

Add the following to your Claude Desktop config file.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "repikue": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://repikue.com/api/mcp"],
      "env": {
        "API_KEY": "rpk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving. You should see “repikue” appear in the MCP tools list.

Other MCP clients

Any client that supports HTTP/SSE MCP transport can connect directly:

text

Endpoint:  https://repikue.com/api/mcp
Auth:      Authorization: Bearer rpk_your_key_here
Protocol:  MCP 2024-11-05 (JSON-RPC 2.0)

Example prompts

“How much can I spend today?”
“Log $12.50 for lunch.”
“Show me my expenses from this week.”
“Am I on track to hit my savings goal this month?”
“What did I spend the most on this period?”

Available tools

get_budget

Returns the current budget status: income, daily budget, money left, days remaining, total spent today, and on-track status.

list_expenses

Lists recent expenses from the active budget period, optionally filtered by date.

Parameters

limit	number	Max expenses to return. Default 20, max 50.
since	string	Filter expenses on or after this date (YYYY-MM-DD).

add_expense

Adds a new expense to the active budget period.

Parameters

amount*	number	Expense amount (positive number).
description*	string	Description or note for the expense.
date	string	Date in YYYY-MM-DD format. Defaults to today.
tags	string[]	Optional category tags.

Raw protocol

The server speaks JSON-RPC 2.0 over HTTP POST. You can call it directly without an MCP client:

bash

# Initialize session
curl -X POST https://repikue.com/api/mcp \
  -H "Authorization: Bearer rpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# List tools
curl -X POST https://repikue.com/api/mcp \
  -H "Authorization: Bearer rpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# Call a tool
curl -X POST https://repikue.com/api/mcp \
  -H "Authorization: Bearer rpk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_budget","arguments":{}}}'

← REST API reference