{
  "markdown": "# Tools Berry MCP server\n\nAn [MCP](https://modelcontextprotocol.io) server that answers US paycheck and payroll-tax\nquestions for 2026 with real arithmetic instead of a guess: take-home pay, bonus withholding,\nstate comparisons, and per-state rate schedules for all 50 states and DC.\n\nIt is already hosted and free to use. You do not need to install or run anything.\n\n**Endpoint:** `https://mcp.tools-berry.com` — Streamable HTTP, JSON-RPC 2.0 over POST.\nAlias: `https://tools-berry-mcp.edydaherz.workers.dev`.\n\n## Connect\n\n**Claude Code**\n\n```sh\nclaude mcp add --transport http tools-berry https://mcp.tools-berry.com\n```\n\n**Claude.ai / Claude Desktop** — Settings → Connectors → Add custom connector, and paste:\n\n```\nhttps://mcp.tools-berry.com\n```\n\n**Cursor** — in `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):\n\n```json\n{\n  \"mcpServers\": {\n    \"tools-berry\": {\n      \"url\": \"https://mcp.tools-berry.com\"\n    }\n  }\n}\n```\n\n**Anything else** — it is plain JSON-RPC, so curl works:\n\n```sh\ncurl -s https://mcp.tools-berry.com \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\n        \"name\":\"compute_take_home\",\n        \"arguments\":{\"state\":\"ohio\",\"salary\":80000}}}'\n```\n\nThat call returns a net of **$63,294.38** on an $80,000 Ohio salary — the same number the\nmatching page on the site shows, to the cent.\n\n## Tools\n\n| Tool | Answers | Required arguments |\n|---|---|---|\n| `compute_take_home` | Full paycheck breakdown for a salary in one state: federal income tax, Social Security, Medicare, state income tax, state payroll programs, net annual/monthly/biweekly, effective rate | `state`, `salary` |\n| `compute_bonus_withholding` | What is actually withheld from a bonus: the federal 22% supplemental rate (37% above $1,000,000), the state's bonus treatment, and FICA | `state`, `bonusAmount` |\n| `compare_states` | Net pay on the same salary across several states, ranked best-first with each state's gap to the winner | `states`, `salary` |\n| `get_state_rates` | One state's 2026 schedule: flat rate or bracket ladder, standard deduction, employee payroll programs, supplemental method, and the statute the figures come from | `state` |\n\n`state` accepts a full name (`Ohio`), a two-letter code (`OH`), or a slug (`ohio`,\n`district-of-columbia`). `filingStatus` is optional on every tool and defaults to `single`;\nit accepts `single`, `married`, `head_of_household`, and the usual aliases (`mfj`, `mfs`, `hoh`).\nEvery response carries both readable text and a `structuredContent` object of raw numbers.\n\n## Probing it in a browser\n\nThe endpoint answers GETs so you can check it without a client:\n\n| Request | Returns |\n|---|---|\n| `GET /` | A JSON self-description: server info, protocol version, instructions, tool list |\n| `GET /health` | `{\"ok\":true}` |\n| `GET /?rpc=<url-encoded JSON-RPC request>` | Executes a single read-only request and returns the JSON-RPC response |\n\nThe `?rpc=` form is a convenience for smoke tests, not part of MCP. It exists because some\nnetworks block `*.workers.dev` or drop POST probes, and a server nobody can reach is\nindistinguishable from a server that is down.\n\n```sh\ncurl -sG https://mcp.tools-berry.com \\\n  --data-urlencode 'rpc={\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\n## Design\n\n- **No forked math.** `tools.js` imports `src/engine/paycheck-engine.js` and\n  `src/engine/bonus-tax.js` directly and feeds them the same data files the public pages are\n  built from. Nothing is re-derived for the MCP layer; that layer only shapes input, picks a\n  link, and formats text. `test/test-mcp-server.js` asserts the server's answers equal the\n  engine called directly, to the cent, across all 51 jurisdictions — so the server cannot\n  quietly drift away from the site.\n- **No dependencies.** The protocol surface needed here is `initialize`, `tools/list`,\n  `tools/call`, plus `ping` and the empty `resources/list` / `prompts/list` probes, so it is\n  implemented by hand in `mcp.js` rather than pulling in an SDK. `npm install` is a no-op;\n  `npm test` runs on plain Node.\n- **Stateless and read-only.** No auth, no session, no storage, no bindings, no writes.\n  Nothing you send is retained.\n- **Rate limit:** 120 requests per minute per IP. Every call is a few microseconds of\n  arithmetic, so the ceiling only has to stop a runaway loop.\n- **Attribution built in.** Every tool response ends with a source line and a deep link to the\n  page on tools-berry.com that shows the same figure.\n\n## The numbers\n\nTax year **2026**, all 50 states plus the District of Columbia. Covered: federal income tax,\nSocial Security and Medicare (including the additional 0.9%), state income tax, and state\nemployee payroll programs such as SDI and PFML. Figures are withholding-style estimates for a\nsingle job with no pre-tax deductions and no credits beyond the standard deduction. Local and\ncity income taxes are not included. This is not tax advice and it is not a filed return.\n\n`get_state_rates` returns a `source` field naming the statute or department schedule each\nstate's figures come from, so any number here can be traced back.\n\n**Provenance and refresh.** The engine and the two data files are maintained on\n[tools-berry.com](https://tools-berry.com) and mirrored into this repository. The hosted server\nis deployed from the site's own repository, so this repo is the readable, reusable copy rather\nthan the deployment source. When rates change on the site, the mirror is refreshed here.\nIf you need a guarantee that you are on current figures, call the hosted endpoint.\n\n## Citation\n\nIf figures or code from here feed something you publish, please cite **tools-berry.com**.\nThat request is the whole business model behind giving the engine away.\n\n## Deploy your own\n\nYou do not need to — the hosted instance is free and open. But if you want your own copy:\n\n```sh\nnpx wrangler deploy\n```\n\nIt is a single Cloudflare Worker with no bindings and no secrets. `wrangler.toml` has the\ncustom-domain block commented out; uncomment it and point it at a hostname you control, or\njust use the `workers.dev` URL wrangler prints.\n\n## License\n\nMIT — see [LICENSE](LICENSE). Copyright 2026 Edmond Daher.\n",
  "bytes": 6202,
  "sha": "4d06d0f3c0dc862eb7b787e4296cd41bf3388d5cd3c83f1b6fe5870bfcad08ff",
  "repo_slug": "edyda99/tools-berry-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_tools_berry_paycheck_e88bd883/readme"
}