{"schemaVersion":"2025-03-26","name":"budgetbro","title":"BudgetBro","description":"First-party MCP server for BudgetBro, the travel budgeting and expense tracking app for backpackers, solo travellers, digital nomads, couples and groups. Lets AI assistants read a connected user's trip budgets, expenses and spending, and log expenses in natural language across 160+ currencies.","vendor":"Nomu Studios LTD","homepage":"https://budgetbro.app/mcp","documentation":"https://budgetbro.app/developers","contact":"support@budgetbro.app","server":{"type":"stdio","command":"npx","args":["-y","budgetbro-mcp"],"registry":{"type":"npm","name":"budgetbro-mcp","url":"https://www.npmjs.com/package/budgetbro-mcp"}},"transports":["stdio"],"authentication":{"type":"connection-token","description":"Create a connection token in BudgetBro Web (Settings -> Connect to AI). The MCP client passes it as the BBRO_CONNECTION_TOKEN env var; the server exchanges it for a short-lived access token at the token endpoint.","obtainTokenUrl":"https://budgetbro.app/web/settings","tokenEndpoint":"https://budgetbro.app/api/mcp/token"},"capabilities":{"tools":true,"resources":true,"prompts":true},"tools":[{"name":"get_trip_summary","description":"Retrieve the current budget status for a specific BudgetBro trip.\n\nUse this tool when the user asks:\n- whether they are staying within their travel budget\n- how much they have spent on a trip\n- how much budget remains\n- how much they can spend per day\n- whether their current spending pace is likely to exceed their budget\n- how many days of budget they have left\n- what their daily spending rate is compared to their target\n\nReturns: trip name, destination, start and end dates, total budget, amount spent, amount remaining, days elapsed, days remaining, actual daily spend, target daily spend, projected total spend, and budget status."},{"name":"list_trips","description":"List the connected user's BudgetBro trips.\n\nUse this tool when the user asks:\n- to see their trips\n- which trips they have in BudgetBro\n- what their current or upcoming trip is called\n- to resolve a trip name to a tripId before calling get_trip_summary\n\nReturns: trip ids, names, destinations, dates, and status (active, upcoming, completed)."},{"name":"query_spending","description":"Analyse a connected user's BudgetBro travel spending.\n\nUse this tool when the user asks:\n- how much they spent overall or in a specific period\n- how much they spent in a particular category (food, accommodation, transport, etc.)\n- how much they spent in a country or destination\n- their average daily spending\n- spending comparisons between periods or trips\n- what their biggest spending categories are\n- how their spending has changed over time\n\nReturns spending totals and breakdowns using the user's real BudgetBro data."},{"name":"log_expense","description":"Record a new expense in BudgetBro from a natural language description.\n\nUse this tool when the user says they spent money or asks to log, add, or record an expense. Handles currency conversion automatically — the user can say the amount in any currency.\n\nExamples: \"Log 85,000 VND for lunch in Vietnam\", \"Add a 12 pound taxi to my expenses\", \"I spent 200 baht on accommodation today.\"\n\nAlways confirm the details with the user before recording."}],"resources":[{"uri":"budget://spending/overview","description":"Spending overview across all categories and trips."},{"uri":"trip://{tripId}/summary","description":"Live budget summary for a specific trip — spent, remaining, daily pace, and projected total."}],"prompts":[{"name":"trip-budget-check","description":"Check how the user's active trip is tracking against budget, including pace and days remaining."},{"name":"daily-allowance","description":"Calculate how much the user can spend per day for the rest of their trip based on remaining budget."},{"name":"spending-breakdown","description":"Break down the user's trip spending by category and identify where most money went."},{"name":"trip-forecast","description":"Project whether the user will exceed their trip budget if they continue at their current spending rate."}],"remote":{"available":false,"note":"A hosted Streamable HTTP endpoint is not offered yet; use the stdio server above."}}