Read-only MCP server for accessing Wallet by BudgetBakers financial data, allowing users to query accounts, transactions, categories, budgets, and more via natural language.
SaferSkills independently audited Wallet BudgetBakers MCP (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Read-only MCP server for accessing Wallet by BudgetBakers financial data from Claude.
export WALLET_API_TOKEN=your_token_hereThe project includes .mcp.json — Claude Code auto-discovers the server. Just open the project directory:
cd wallet-bb-mcp
claude
# /mcp should show "wallet-bb" connectedclaude_desktop_config.json in your editor. Add the mcpServers block:{
"mcpServers": {
"wallet-bb": {
"command": "/Users/YOUR_USERNAME/.local/bin/uv",
"args": ["--directory", "/path/to/wallet-bb-mcp", "run", "server.py"],
"env": {
"WALLET_API_TOKEN": "your_token_here"
}
}
}
}command — full path to uv (run which uv in terminal to get it)--directory argument — full path to this projectWALLET_API_TOKEN — your actual token (env var interpolation doesn't work here)The server can be deployed to Google Cloud Run and used as a remote MCP connector:
https://<your-cloud-run-service-url>/mcpThe server supports both local (stdio) and remote (HTTP) transport. Cloud Run deployment is automated via GitHub Actions.
main triggers .github/workflows/deploy.ymlDockerfileeurope-central2gcloud run deploy wallet-bb-mcp \
--source . \
--region europe-central2 \
--project wallet-bb-mcp \
--allow-unauthenticated \
--set-env-vars "WALLET_API_TOKEN=your_token" \
--port 8080MCP_TRANSPORT=streamable-http WALLET_API_TOKEN=your_token uv run server.py
# Health check: curl http://localhost:8080/health
# MCP endpoint: http://localhost:8080/mcp| Tool | Description |
|---|---|
get_accounts | List financial accounts (bank, cash, cards). Start here. |
get_records | Get transactions for an account (requires account ID) |
get_records_by_id | Get specific records by IDs (max 30) |
get_categories | List spending/income categories |
get_budgets | List budgets with limits and spent amounts |
get_goals | List savings goals with progress |
get_labels | List custom labels/tags |
get_standing_orders | List recurring payments |
get_record_rules | List auto-categorization rules |
get_api_usage | Check API usage quota |
All text fields support filter prefixes:
| Prefix | Example | Meaning |
|---|---|---|
eq. | eq.Groceries | Exact match |
contains. | contains.bank | Contains (case-sensitive) |
contains-i. | contains-i.amazon | Contains (case-insensitive) |
Range filters for dates, amounts, and timestamps:
| Prefix | Example | Meaning |
|---|---|---|
gte. | gte.2025-01-01 | Greater than or equal |
lte. | lte.2025-12-31 | Less than or equal |
| Combined | gte.100,lte.500 | Between 100 and 500 |
get_api_usage() to check remaining quotaRetry-After on HTTP 429~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.