Free MCP Server for US Paycheck & Tax Math
Connect your AI assistant (Claude, Cursor, or anything else that speaks MCP) to the real calculator engine behind this site, so it computes your paycheck instead of guessing at it.
What this is
MCP, the Model Context Protocol, is an open standard that lets an AI assistant call outside tools instead of answering from memory. This endpoint exposes the same 2026 US tax engine that generates every calculator page on this site, wrapped as four tools an assistant can call.
So when you ask your assistant what you take home on $80,000 in Ohio, it runs the real arithmetic and the figure it gives you matches the page on this site to the cent, instead of being a plausible-looking number a language model produced from memory.
What your AI can do with it
Four tools. You do not have to name them: an assistant that has connected to the server picks the right one from a plain question.
| Tool | What it answers | Ask it like this |
|---|---|---|
| compute_take_home | Full paycheck breakdown for a salary in any state: federal income tax, Social Security, Medicare, state income tax, state payroll programs, net pay and effective rate. | "What's my take-home on $80,000 in Ohio?" |
| compute_bonus_withholding | What is actually withheld from a bonus: the federal flat 22% supplemental rate (37% above $1,000,000 of supplemental wages), how the state treats supplemental wages, and FICA. | "How much of a $15,000 bonus do I keep in Georgia?" |
| compare_states | The same salary across several states, ranked best-first, with each state's gap to the winner. | "Compare $120,000 in Texas, California and New York." |
| get_state_rates | One state's 2026 schedule: flat rate or bracket ladder, standard deduction, payroll programs, bonus method, and the statutory source behind the figures. | "What are Ohio's 2026 income tax brackets?" |
Coverage is all 50 states plus the District of Columbia, tax year 2026.
The endpoint
- Transport
- Streamable HTTP (POST to that URL)
- Protocol
- JSON-RPC 2.0, a plain-JSON request format
- Auth
- None. No signup, no API key, no account.
- Price
- Free.
Also reachable at its Cloudflare alias, https://tools-berry-mcp.edydaherz.workers.dev, if you ever need to bypass the custom domain. Both serve the same worker.
Connect
Claude Code (CLI)
claude mcp add --transport http tools-berry https://mcp.tools-berry.com
Claude Desktop or claude.ai
Add it as a custom connector and paste the URL. There is nothing else to fill in, because there is no key and no account:
https://mcp.tools-berry.com
Cursor
Add the server to ~/.cursor/mcp.json (or the per-project .cursor/mcp.json):
{
"mcpServers": {
"tools-berry": {
"url": "https://mcp.tools-berry.com"
}
}
}
Anything else, or just to see it work
It is plain JSON-RPC over HTTPS, so curl is enough to try it:
curl -sS https://mcp.tools-berry.com \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"compute_take_home",
"arguments":{"state":"ohio","salary":80000}}}'
A GET on the same URL returns a plain-JSON description of the server and its tools, and GET /health returns {"ok":true}.
What you can rely on
- The same engine as the pages. The server imports this site's own paycheck engine and the same 2026 data files, rather than a second copy of the math. This site's test suite recomputes the server's answers against that engine and requires them to match to the cent across all 51 jurisdictions, and the server you are calling runs that same tested code.
- Nothing you ask is stored. No account, no session, no database: your questions and the figures that come back are not written down anywhere. The one thing the server holds is a request counter keyed by IP address, covering the last minute and living in memory only, which is what the rate limit below is counted from.
- A generous ceiling. Two limits apply, both there to stop a runaway loop rather than to meter you: about 120 requests a minute per IP address, and at most 50 messages in a single JSON-RPC batch. The first is counted separately by each server instance, so treat it as a rough ceiling rather than an exact quota.
- Estimates, not advice. Figures are withholding-style estimates for a single filer by default, one job, no pre-tax deductions and no credits beyond the standard deduction. Local and city income taxes are not included. This is not tax advice and it is not a filed return.
- Every answer points back here. Each response ends with an attribution line and a deep link to the matching page on this site, so a figure you are handed can always be checked against the page that publishes it.
Source
The server's code and the tax data behind it are open at github.com/edyda99/tools-berry-mcp. If an answer from the server ever disagrees with a page on this site, that is a bug, and the repository is where to report it.