# Paycheck Allocation Planner MCP. AI Agent Connect > Paycheck Allocation Planner helps you split your income between fixed bills, debt payments, and savings goals. By connecting your AI client to this MCP via Vinkius, you can use your agent to run math on your paycheck, check if your budget rules actually work, and get a clear list of exactly how much money to move where. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_iDZVy2zZszvGi2T9MhuNOm0tWE1uX6NLn8Q62wpc/ai-agent-connect - **Tags:** budgeting, paycheck, allocation, savings, financial-planning ## Description Managing a paycheck shouldn't feel like a math exam. This MCP gives your AI agent the logic needed to handle complex income distribution. Instead of manually calculating percentages and leftover balances, you tell your agent your rules, and it does the heavy lifting. You can set fixed dollar amounts for rent or utilities, then assign percentages of the remaining balance to savings or debt. The MCP ensures your math is sound before you move a single cent. It handles the logic of splitting funds, checking for rule conflicts, and summarizing where your money is going. Once the math is settled, your agent can provide a clean set of instructions for your bank transfers. It turns a messy list of obligations into a structured financial roadmap. ## Tools ### generate_transfer_plan This tool turns raw allocation data into a clear, readable list of transfer instructions. ### get_category_summary This tool aggregates your individual allocations into high level spending categories. ### validate_rule_consistency Use this to check if your financial rules are mathematically possible before you try to allocate funds. ### calculate_allocation This tool computes the exact distribution of a single paycheck based on your specific rules. ## Prompt Examples **Prompt:** ``` I have a paycheck of $3000. I need to pay $1200 for rent and $300 for utilities. I want to put 10% of the total paycheck into savings and 20% of the remaining balance into debt repayment. How should I allocate this? ``` **Response:** ``` Your $3000 paycheck will be allocated as follows: $1200 for Rent, $300 for Utilities, $300 for Savings, and $300 for Debt Repayment. You will have $900 in residual cash. ``` **Prompt:** ``` Can you check if my rules are valid? I have $1000 total. Fixed rules: $500 for car loan. Percentage rules: 60% of total for groceries. ``` **Response:** ``` No, your rules are not valid. The total allocation ($500 fixed + $600 percentage) exceeds your $1000 paycheck. ``` **Prompt:** ``` Give me the transfer instructions for my $2000 paycheck where I have $500 for rent and 10% of the total for savings, with 'Buffer' as my residual account. ``` **Response:** ``` Transfer $500 to Rent, transfer $200 to Savings, and transfer $1300 to Buffer. ``` ## Capabilities ### Rule Validation Your agent checks if your budget rules exceed your actual income. ### Percentage Math The MCP calculates distributions based on both fixed amounts and percentage-based rules. ### Spending Summaries Your agent groups individual line items into broader spending categories. ### Transfer Instructions The MCP generates a list of specific actions for moving money between accounts. ## Use Cases ### Debt Repayment Calculate how much of a paycheck goes to debt after essential bills are covered. ### Savings Automation Set a rule to move a specific percentage of every paycheck into a savings account. ### Budget Verification Check if a new set of spending rules will actually fit within a specific paycheck amount. ### Transfer Planning Get a list of exact amounts to move to different accounts after a deposit hits. ## Benefits - Eliminates manual math errors when splitting income. - Prevents over-budgeting by validating rules against total income. - Converts complex allocation logic into simple transfer instructions. - Provides high level views of spending through category summaries. ## How It Works Connect your AI client to the MCP via Vinkius to start managing your money. 1. Connect your AI client to the Paycheck Allocation Planner MCP through Vinkius. 2. Provide your paycheck amount and your specific spending or savings rules to your agent. 3. The agent uses the MCP to validate the rules and calculate the math. 4. Receive a clear plan or a list of transfer instructions from your agent. ## Frequently Asked Questions **How do I connect this MCP to my AI client?** You connect once through the Vinkius platform. Vinkius hosts the MCP and manages the connection, so you can use it immediately in Claude, Cursor, or Windsurf. **Can I use percentage-based rules?** Yes. You can define rules based on fixed dollar amounts or percentages of your total paycheck or the remaining balance. **What happens if my budget rules exceed my income?** The MCP includes a validation tool. Your agent will use it to check if your rules are mathematically possible and will alert you if they exceed your total paycheck. **Does this MCP connect to my bank account?** No. This MCP provides the logic and math for your plan. It generates instructions for you to follow, but it does not execute the transfers itself. **Which AI clients are compatible?** This MCP works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **How do I ensure my budget is mathematically possible?** You can use the `validate_rule_consistency` tool to check if your fixed obligations and percentage-based rules fit within your total paycheck amount. **Can I set specific amounts for my rent or mortgage?** Yes, you can define these as fixed-dollar rules. The planner will prioritize these amounts before calculating any percentage-based distributions. **What happens to the money left over after all rules are applied?** The remaining amount is identified as residual cash. You can use `generate_transfer_plan` to receive instructions on how to move this residual cash to a designated buffer account.