MCP Server

Use BudgetAI as an MCP tool for MCP-capable clients, and connect external MCP tools.

BudgetAI speaks the Model Context Protocol (MCP) in both directions: it can use external MCP tools, and it can act as an MCP server for other MCP-capable clients.

Run as an MCP server

budgetai mcp-server run

This exposes BudgetAI's runtime — routing, tools, memory — to any MCP client. The MCP server bridge requires the mcp extra:

uv tool install --python 3.12 "budgetai[recommended,mcp]"

Use external MCP tools

BudgetAI can register external MCP servers and call their tools inside a turn, subject to the same sandbox and approval policy as built-in tools.

MCP tools are treated like any other tool: they run behind the sandbox and can require approval based on your permission posture.