home / mcp / budget allocator mcp server

Budget Allocator MCP Server

Provides an interactive budget allocation data source with real-time visualization and benchmarks for decision making.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "achautha-budget-allocator-mcp-app": {
      "command": "npx",
      "args": [
        "-y",
        "--silent",
        "--registry=https://registry.npmjs.org/",
        "@modelcontextprotocol/server-budget-allocator",
        "--stdio"
      ]
    }
  }
}

You can deploy and run the Budget Allocator MCP server to manage interactive budget allocations, visualize distributions in real time, and compare against industry benchmarks. This server exposes a data endpoint and a client-facing UI that updates as you adjust budgets, helping you explore scenarios and track performance trends across categories.

How to use

You will connect an MCP client to the Budget Allocator MCP server using a stdio-based configuration. Once connected, the server provides category definitions, historical allocation data, and industry benchmarks that drive the interactive UI. As you move sliders for each category, the UI updates the donut chart, sparklines, and percentile badges in real time, allowing you to explore different total budgets and stage-specific benchmarks.

How to install

Prerequisites: you need Node.js installed on your machine. Ensure npm is available as well.

# Install dependencies for the project if you have the repository checked out
npm install

# Start the MCP server via the stdio method shown in the configuration
npm run start:stdio

Additional sections

Configuration overview: you connect to the server using MCP client configurations that point to the stdio transport. The server exposes a get-budget-data tool that returns category definitions, historical data, and benchmarks, which the UI consumes to render charts and trends.

Security notes: ensure you run MCP clients and servers in trusted environments. If you expose the server to a network, consider access controls or auth appropriate for your deployment.

Examples: you can test interactive budgeting with presets like $50K, $100K, $250K, or $500K, and switch between Seed, Series A, Series B, and Growth benchmarks to compare how allocations perform under different market conditions.

Available tools

get_budget_data

Provides category definitions with colors and default allocations, ~120 data points of historical per-category data, and ~60 data points of industry benchmarks; the data is used to render UI components and compute percentile rankings.

render_donut_chart

Renders the category allocation as a donut chart using Chart.js, updating as you adjust sliders.

render_sparklines

Displays 24-month historical trends for each category using inline SVG visualizations.

compute_percentiles

Calculates percentile rankings for your allocations relative to industry benchmarks and stage-specific data.

update_ui_reactive

Keeps all UI elements in sync with data changes so sliders, charts, and badges reflect the current state in real time.