# Freelancer Budget Prover MCP MCP

> The Freelancer Budget Prover takes your hourly rate and projected hours, then forces a brutally honest financial audit. It calculates five critical axes—realistic revenue, complete costs, cash flow buffers, minimum viable pricing, and profitability with scope creep analysis. Stop guessing your income; see the actual net take-home pay after taxes, insurance, and slow payments.

## Overview
- **Category:** finance
- **Price:** Free
- **Tags:** freelancer, budget, pricing, cash-flow, utilization-rate, scope-creep

## Description

You're used to estimating things based on what 'feels right.' You assume 100% billable time and that clients will pay immediately. That math doesn't exist in the real world of self-employment.

This MCP connects your AI client directly to a set of financial rules designed for freelancers. It moves you past simple gross revenue projections by forcing consideration of everything: mandatory self-employment taxes, health insurance costs, liability coverage, and the fact that 42% of invoices get paid late. The tool doesn't just calculate potential earnings; it calculates your minimum sustainable rate based on total annual expenses. When you use this MCP through Vinkius, your agent runs a deep check against industry standards for utilization rates, cash flow lags, and hidden costs. It gives you the real picture so you know exactly what number to quote clients.

## Tools

### validate_freelancer_budget
Runs a comprehensive financial audit on your business model, forcing calculations across revenue utilization, mandatory costs, cash flow buffers, pricing floor, and scope creep risk.

## Prompt Examples

**Prompt:** 
```
I charge $95/hour. Potential income: $95 × 2,080 = $197,600. Low expenses. Clients pay on time.
```

**Response:** 
```
REVENUE_FANTASY — 2,080h ignores 35% non-billable. 'Low expenses' ignores $75K+ invisible costs. 'Clients pay on time' contradicts 42% late rate.
```

**Prompt:** 
```
Revenue: $95/hr × 1,352h (65%) = $128,440. Costs: $79,764 total. Net: $48,676. Cash flow: Net-30, 18% late, $24K emergency. Pricing: min $79.20/hr, current $95. Profit: 37.9% margin, scope creep 3/12 projects +40%.
```

**Response:** 
```
BUDGET_PROVEN — All five axes validated.
```

**Prompt:** 
```
Revenue: $110/hr × 1,400h. Costs: $76,462. Cash flow: 'clients pay on time.' Pricing: 'based on what competitors charge.'
```

**Response:** 
```
CASHFLOW_BLIND — No late payment buffer, no emergency fund, no seasonal gap plan. Pricing from competitors not from YOUR costs.
```

## Capabilities

### Determine realistic revenue
Calculates potential earnings using actual utilization rates (e.g., 60-70%), factoring out time spent on proposals and admin work.

### Account for hidden costs
Adds mandatory expenses like self-employment tax, health insurance premiums, and accounting fees to your total cost base.

### Model cash flow lag
Simulates income based on real payment terms (Net-30/60/90) and accounts for seasonal gaps or periods of no work.

### Calculate minimum viable pricing
Determines the absolute lowest hourly rate you must charge to cover all your annual costs, ensuring you don't lose money on a project.

### Analyze scope creep impact
Quantifies how undefined deliverables or extra 'quick favors' reduce your effective hourly profit margin.

## Use Cases

### The New Client Onboarding
A new client asks for a quote. Instead of citing an arbitrary rate, the agent runs `validate_freelancer_budget`. The resulting minimum viable pricing gives the freelancer a confident, defensible number that covers all overhead.

### Correcting Over-Optimistic Projections
The consultant assumes clients pay on time and ignores taxes. Running `validate_freelancer_budget` immediately flags the gap, showing the massive shortfall caused by forgetting self-employment tax and payment delays.

### Setting a Monthly Retainer
The small agency owner needs to set a monthly retainer. The tool calculates not only the service cost but also the required emergency fund buffer, ensuring stable income through slow months.

## Benefits

- Know Your True Floor: The `validate_freelancer_budget` tool determines your minimum viable rate, so you never accidentally price yourself out of business.
- Account for Taxes and Insurance: It automatically factors in self-employment tax (15.3%), health insurance premiums, and other mandatory costs that aren't 'visible' on a paycheck stub.
- Manage Cash Flow Risk: By modeling payment delays (Net-60/90) and seasonal gaps, you build cash flow buffers instead of hoping for timely payments.
- Identify Scope Creep Costs: The tool quantifies how many free hours or unlimited revisions cost you in lost revenue, protecting your profit margin.
- Increase Utilization Awareness: You learn the difference between ideal 2,080 hours and realistic billable time (60-70%), making proposals more honest.

## How It Works

The bottom line is that you get a single, defensible number for your income floor, backed by real-world financial rules.

1. Input your initial assumptions: your current hourly rate, the projected number of hours, and any known annual expenses.
2. The MCP runs these numbers through five financial axes, cross-referencing them with established industry averages for tax rates, insurance costs, and typical payment delays.
3. You get a validated report showing your true net take-home pay, your minimum viable hourly rate, and the percentage impact of non-billable activities.

## Frequently Asked Questions

**Why is $100/hr × 2,080 a fantasy?**
Freelancers are billable 60-70% of working hours after admin, sales, learning, and vacation. Real: 1,352 hours × $100 = $135,200 — not $208,000.

**How do I calculate minimum viable rate?**
Total costs ($82K) ÷ (1 - target margin 20%) = $102,500 ÷ 1,300 billable hours = $78.85/hr minimum. Below this you lose money.

**How does scope creep destroy profitability?**
20h project at $100/hr = $2,000. Client adds 'small changes.' Actual: 35h. Effective rate: $57.14/hr — 43% reduction. If minimum viable is $79/hr, you worked 15 hours below cost.

**When running `validate_freelancer_budget`, what data inputs should I prioritize for the most accurate results?**
You must provide your actual utilization rate, not 100%. The tool needs specific figures for annual overhead costs (tools, insurance) and expected payment terms to build a complete picture. This level of detail prevents financial blind spots.

**If my initial input is flawed when calling `validate_freelancer_budget`, how does the MCP alert me?**
The tool compares your inputs against established industry averages, such as the 15.3% self-employment tax rate or standard cash flow gaps. It flags discrepancies and highlights missing 'invisible costs' in the final report summary.

**Is there a limit on how many times can I call `validate_freelancer_budget` to test different pricing models?**
The MCP allows for multiple simulations. For extensive testing, you can run batches of financial data sets. Consult the Vinkius documentation within your AI client for current rate limits and bulk processing instructions.

**How does the MCP handle security and privacy when I use `validate_freelancer_budget`?**
Your financial data remains secure within your connected AI environment. Vinkius manages transmission using standard encryption protocols, ensuring that results are displayed only to you.

**When the tool calculates cash flow, how is the 42% late payment rate applied?**
The system doesn't just apply a flat discount. It models your expected revenue based on stated net-30/60/90 terms and then reduces the projected income by the historical late payment percentage to build in necessary emergency buffers.