freelance-tax-mcp
A local MCP server for 2026 US freelancer/sole-proprietor federal tax planning and deductions.
Estimate quarterly federal tax, including SE tax, income tax, safe-harbor payment, and due dates.
Calculate 2026 self-employment tax, including Social Security, Medicare, Additional Medicare Tax, and the deductible half.
Get IRS quarterly estimated tax due dates adjusted for weekends and holidays.
Compute IRS standard mileage deductions by trip date or split totals, and look up mileage rates/sources.
Compare simplified vs regular home office deduction methods with income limits and carryovers.
Estimate maximum 2026 SEP IRA vs Solo 401(k) contributions and potential tax savings.
Retrieve 2026 tax brackets, standard deductions, SE tax figures, and official sources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@freelance-tax-mcp estimate my 2026 quarterly taxes on $80,000 net profit"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
freelance-tax-mcp
A free Model Context Protocol (MCP) server for US freelancer and sole-proprietor taxes in 2026: quarterly estimated tax with the safe harbor, self-employment tax (Schedule SE, with the Additional Medicare Tax), the Section 199A QBI deduction (Form 8995 / 8995-A), the hourly rate you need to charge, IRS due dates, the IRS mileage deduction (including the July 1, 2026 rate change), the home office deduction, the most you can put into a SEP IRA vs a Solo 401(k), and official GSA per diem rates with the self-employed meal deduction. Everything runs locally: no API key, no account, no network calls.
Tools
Tool | What it does |
| 2026 federal estimate from |
| 2026 Schedule SE: 15.3% on 92.35% of net profit (none under $400), Social Security 12.4% up to the $184,500 wage base minus your W-2 wages, Medicare 2.9% with no cap, 0.9% Additional Medicare Tax over $200,000 / $250,000 (mfj) / $125,000 (mfs) split into the SE and wage parts, the deductible half, quarterly share and effective rate. Options |
| 2026 Section 199A Qualified Business Income deduction for one business (Form 8995 / 8995-A): 20% of QBI at or below the $201,750 threshold ($403,500 mfj), the phase-in range up to $276,750 ($553,500 mfj) with the W-2 wage / UBIA limit, the SSTB phase-out, 20% of REIT/PTP income and the cap of 20% of taxable income minus net capital gain. Needs |
| Hourly and day rate needed to take home a target income after tax, business costs, weeks off, non-billable hours and a slow-month buffer; |
| Quarterly estimated tax due dates for a year, moved past weekends and DC legal holidays. |
| Standard mileage deduction priced by the date of each trip (business 72.5 cents Jan to Jun 2026, 76 cents from Jul 1), from a trip log or split totals. |
| IRS mileage rates by period with sources. |
| Simplified ($5 per sq ft, up to 300 sq ft) vs regular Form 8829 method, with the income limit and carryovers. |
| 2026 SEP IRA vs Solo 401(k) maximum contribution for a sole proprietor or single-member LLC (IRS Pub. 560 rate worksheet): employer share, $24,500 deferral, catch-up ($8,000 at 50+, $11,250 at 60 to 63), the $72,000 cap, which plan allows more and estimated income tax saved. Options |
| Official GSA CONUS per diem rates (FY2026 and FY2027) by ZIP, city or state: lodging maximum by month and the M&IE breakdown. |
| Maximum per diem for a trip under GSA/FTR rules: lodging per night, M&IE with 75% on the first and last day, minus provided meals. |
| Self-employed meal deduction with the IRS standard meal allowance (Pub. 463): federal M&IE rate, 3/4 on travel days (or full), times 50% (or 80% for DOT hours-of-service workers). |
| GSA meals and incidentals tiers (breakfast, lunch, dinner, incidentals, first/last day). |
| 2026 brackets, standard deductions, SE tax figures and official IRS/SSA sources. |
Figures come from IRS Rev. Proc. 2025-32, the SSA 2026 wage base ($184,500), Form 1040-ES (2026), IRS Announcement 2026-11, Pub. 587, Pub. 560, IRS Notice 2025-67 (2026 retirement plan limits), Forms 8995 and 8995-A (Section 199A), Pub. 463 and GSA per diem rates (api.gsa.gov, fetched 2026-10-20; public domain). Planning estimates only; not tax, legal or accounting advice.
Related MCP server: statetakehome-mcp
Install
Requires Node.js 18 or newer.
npx -y freelance-tax-mcpAdd to your MCP client's config (for Cursor, ~/.cursor/mcp.json):
{
"mcpServers": {
"freelance-tax": { "command": "npx", "args": ["-y", "freelance-tax-mcp"] }
}
}From source: git clone https://github.com/NarwhalThePong/freelance-tax-mcp.git && cd freelance-tax-mcp && npm install && npm test.
Example
estimate with { "net_profit": 80000 } (single, no other income) returns self-employment tax of $11,303.64, total 2026 federal tax of $16,647.47 and a quarterly payment of $4,161.87, with the four due dates.
self_employment_tax with { "net_profit": 250000, "w2_wages": 50000 } (single) returns Social Security of $16,678 (only $134,500 of wage base left), Medicare of $6,695.38, self-employment tax of $23,373.38 (deductible half $11,686.69) and $727.88 of Additional Medicare Tax on the self-employment income.
qbi_deduction with { "qbi": 150000, "taxable_income": 240000, "sstb": true, "w2_wages": 40000 } (single, a consulting-type service business inside the phase-in range) keeps 49% of the QBI and wages, so 20% of $73,500 is $14,700, the wage limit is $9,800 and the phase-in reduction is $2,499, giving a QBI deduction of $12,201.
freelance_hourly_rate with the defaults ($60,000 take-home, $6,000 costs, 30% tax, 6 weeks off, 40 hours a week, 65% billable, 10% buffer) returns $85.21 an hour ($681.64 a day) over 1,196 billable hours.
retirement_contribution with { "net_profit": 100000 } (under 50) returns a SEP IRA maximum of $18,587.04 and a Solo 401(k) maximum of $43,087.04 ($24,500 deferral + $18,587.04 employer share).
meal_deduction with { "zip": "10001", "start": "2026-11-03", "end": "2026-11-06" } (New York City, 4 days) returns a standard meal allowance of $322 ($69 + $92 + $92 + $69) and a 50% deduction of $161.
Prefer a web page?
Free 2026 self-employment tax calculator: https://narwhalthepong.github.io/gumroad-license-check/self-employment-tax-calculator
Free 2026 QBI deduction calculator: https://narwhalthepong.github.io/gumroad-license-check/qbi-deduction-calculator
Free freelance hourly rate calculator: https://narwhalthepong.github.io/gumroad-license-check/freelance-hourly-rate-calculator
Free freelance quarterly estimated tax calculator: https://narwhalthepong.github.io/gumroad-license-check/freelance-quarterly-estimated-tax-calculator
Free 2026 mileage deduction calculator: https://narwhalthepong.github.io/gumroad-license-check/2026-mileage-deduction-calculator
Free home office deduction calculator: https://narwhalthepong.github.io/gumroad-license-check/home-office-deduction-calculator
Free SEP IRA vs Solo 401(k) contribution calculator: https://narwhalthepong.github.io/gumroad-license-check/self-employed-retirement-contribution-calculator
Free self-employed per diem meal deduction calculator: https://narwhalthepong.github.io/gumroad-license-check/self-employed-per-diem-meal-deduction-calculator
Free GSA per diem calculator: https://narwhalthepong.github.io/gumroad-license-check/gsa-per-diem-calculator
Disclosure: these are our own free pages.
Prefer a spreadsheet?
Freelancer Quarterly Tax Planner 2026 (Excel + Google Sheets), $9: logs each payment and expense, works out how much of every dollar to set aside, the safe-harbor and full quarterly payments, and tracks what you've paid against the 2026 due dates.
Home Office Deduction Worksheet (Excel + Google Sheets), $9: simplified vs regular (Form 8829) method side by side, with depreciation, the income limit and carryovers.
Both are our own paid products (the MCP server stays free). Not tax advice.
License
MIT
Available Tools
8 toolsdue_datesEstimated tax due datesA
IRS quarterly estimated tax due dates for a tax year, moved past weekends and DC legal holidays.
Inputs: year.
estimate2026 quarterly estimated taxB
US federal 2026 estimate for a freelancer or sole proprietor: self-employment tax, income tax, safe-harbor quarterly payment and IRS due dates. Planning estimate, not tax advice.
Inputs: qbi, months, w2_wages, net_profit, +7 more.
home_officeHome office deductionA
Home office deduction: simplified ($5/sq ft, up to 300 sq ft) vs regular Form 8829 method, with the business income limit and carryovers. Give home_sqft and costs to compare both.
Inputs: office_sqft (required), rent, basis, direct, +14 more.
mileageIRS mileage deductionB
Standard mileage deduction priced by the date each mile was driven (2026 business rate 72.5 cents Jan-Jun, 76 cents from Jul 1). Pass trips, or 2026 split totals such as business_jan_jun and business_jul_dec.
Inputs: trips, parking_tolls, moving_jan_jun, moving_jul_dec, +6 more.
mileage_ratesIRS mileage ratesA
IRS standard mileage rates by period with official sources.
Inputs: no named parameters.
retirement_contribution2026 SEP IRA vs Solo 401(k) max contributionA
Most a sole proprietor or single-member LLC owner can put into a SEP IRA vs a Solo 401(k) for 2026 (IRS Pub. 560 rate worksheet, 2026 limits: $72,000 total, $24,500 deferral, $8,000 catch-up at 50+, $11,250 at 60-63), plus estimated income tax saved. Planning estimate, not tax or investment advice.
Inputs: net_profit (required), bracket, w2_wages, age_group, +2 more.
self_employment_tax2026 self-employment taxC
Social Security and Medicare (SE) tax on 2026 net self-employment profit, the deductible half and Additional Medicare Tax.
Inputs: months, w2_wages, net_profit, ytd_profit, +2 more.
tax_figures2026 tax figures and sourcesB
2026 brackets, standard deductions, SE tax figures and official IRS/SSA sources used.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct targets: estimate is an aggregate planning calculation, self_employment_tax breaks out the SE tax component, due_dates lists dates, and tax_figures provides reference values. There is some overlap because estimate also includes SE tax and due dates, so an agent may occasionally choose it when a narrower tool would suffice, but the distinctions are generally clear.
All names use snake_case and mostly follow a predictable domain-noun pattern such as self_employment_tax, due_dates, and home_office. The lone single-word estimate and the near-pair mileage/mileage_rates are minor deviations, but the set remains readable and consistent overall.
Eight tools are well-scoped for a freelance tax planning server, with one tool per major calculation or reference area. Each tool earns its place and there is no excessive surface area.
The surface covers core freelance tax planning: aggregate estimates, SE tax, due dates, tax figures, mileage, home office, and retirement contributions. Minor gaps remain, such as QBI deduction handling or more detailed payment scheduling, but agents can work around them for most planning workflows.
Maintenance
Related MCP Connectors
2026 quarterly tax estimates, SE tax, safe harbor and mileage for 1099 gig workers.
US federal + state quarterly estimated tax estimates, SE tax, and quarterly payment due dates.
2026 state, city and platform tax profiles for gig workers and creators, plus Roth IRA signups.
Current source-cited 2026 US tax constants and calculators for AI agents; every answer cites IRS.
Related MCP Servers
- AlicenseBqualityBmaintenance39 tax tools for US individual taxpayers — federal/state tax calculations, credits, deductions, retirement strategies, audit risk, and tax planning. All calculations run locally, no data leaves the machine. Supports TY2024 and TY2025 (One Big Beautiful Bill Act).45588 npm13MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to compute US take-home pay, self-employment taxes, and capital gains taxes for the 2026 tax year using the engine from statetakehome.com.353 npmMIT
- AlicenseNot gradedqualityCmaintenanceCurrent, source-cited US federal tax constants and freelancer calculators for tax year 2026, including the July 1 mid-year mileage change. Every response carries its IRS/SSA primary source and a last-verified date; refuses rather than guesses.MIT
- AlicenseNot gradedqualityCmaintenanceEnables 1099 gig workers and freelancers to calculate 2026 quarterly federal estimates, self-employment tax, safe-harbor minimum payments, and mileage or actual-expense deductions, including the mid-year business mileage rate change from 72.5 to 76 cents. It also compares standard mileage against actual vehicle costs and exposes every tax constant with its source.MIT