AI agent
Agents CLI + MoneySprout
HTTP and terminal clients
Headless debugging uses the same MCP URL. Prefer OAuth in interactive clients; use PATs only on trusted machines.
You
Show curl to call query_spending with my PAT for this month.
Agents CLI
POST /mcp with tools/call and arguments { from, to, categories }—see Settings → Developer for PAT format.
How to connect Agents CLI
- Claude Code: claude mcp add with SSE transport to the MoneySprout URL.
- curl / JSON-RPC: POST to /mcp with Bearer personal access token.
- Claude Desktop: optional local stdio package referenced in Settings → Developer.
- Never commit tokens; rotate PATs if leaked.
MoneySprout MCP server URL
https://moneysprout.app/mcp
cURL tools/list (personal access token)
curl -X POST https://moneysprout.app/mcp \
-H "Authorization: Bearer YOUR_PAT" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'OAuth sign-in is recommended for remote clients. Personal access tokens in Settings → Developer work for local stdio bridges. MCP requires standard encryption mode (not zero-knowledge) so tools can read your linked data.
What you can do with Agents CLI
Claude Code
Interactive terminal with OAuth when available.
curl / HTTP
tools/list and tools/call for integration debugging.
Cursor
.cursor/mcp.json remote URL configuration.
No moneysprout-cli
Clients speak MCP directly—no npm CLI package required.
MoneySprout MCP tools
When connected, Agents CLI can call these tools. Write tools require the matching write scope.
Transactions
- list_transactions
- get_transaction
- query_spending
- update_transaction
- recategorize_transactions
Budgets and categories
- list_budgets
- list_categories
- create_category
- update_category
- delete_category
Accounts, goals, and net worth
- list_accounts
- get_net_worth_history
- list_goals
Insights and briefings
- get_daily_summary
- get_alerts
- get_metrics
- get_life_hub_briefing
Follow-up
- get_tasks
Example prompts
- Difference between remote OAuth MCP and stdio bridge for Desktop.
- List environment variables for the bundled stdio MCP server.
FAQ
- Is MoneySprout preinstalled in ChatGPT or Claude?
- No. Add MoneySprout as a custom MCP connector (or complete OAuth when your client supports remote MCP). Sign in with your MoneySprout account during consent.
- Can an agent change my budgets or add transactions?
- Read tools cannot. With write:transactions an agent can change a transaction's category, note, or follow-up flag, including a bulk recategorize by id or merchant. With write:categories it can create, rename, or delete your custom categories. It still cannot add or delete transactions, edit budgets, goals, or accounts, or move money. Existing grants stay read-only until you reconnect and approve the write scopes.
- Why does MCP require standard encryption mode?
- Read-only tools need server-side access to linked account data. Zero-knowledge mode keeps keys only on your devices, so MCP and API access are disabled until you switch to standard encryption in Settings → Privacy & encryption.
- Does the model see my bank passwords?
- No. OAuth connects the MCP client to MoneySprout. Bank credentials stay with Plaid inside MoneySprout; agents receive structured summaries and transaction rows your account already synced.
- Is there a MoneySprout CLI npm package?
- No standalone CLI. Use MCP-compatible clients or the stdio bridge documented under Settings → Developer.