Income Tax Brackets SkillIncome Tax Brackets Skill

OnlineCredit Usage:1 per callTool:IncomeTaxBracketsSkill

The tool

Give your agent US federal tax brackets. Call it as an MCP tool to fetch rates, income ranges and standard deductions for any year.

Once your client is connected to the VerveKit MCP server, this appears in its tool list as IncomeTaxBracketsSkill. It is read-only and open-world: it fetches, it never mutates anything on your side, so most clients will call it without asking you to confirm.

Tool call
{
  "name": "IncomeTaxBracketsSkill",
  "arguments": {
    "country": "US"
  }
}

What that looks like in a conversation

You don't name the tool — the model picks it. Asking about US in the terms this source covers is enough for it to reach for IncomeTaxBracketsSkill on its own.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth — the client opens a browser once and there is no key to paste into a config file.

Client config
{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}
Endpoint
https://api.vervekit.com/v1/mcp

Per-client setup — Claude Desktop, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made.

ArgumentTypeExampleDescription
countryRequiredstringUSThe country code (currently only 'US' is supported)
yearPremiuminteger2024The tax year to retrieve brackets for. Defaults to the previous year.

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client can read fields without parsing prose. status is "ok" on success and error is null; a null field means the value wasn't available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "year": 2025,
    "country": "US",
    "type": "federal",
    "brackets": {
      "single": [
        {
          "rate": 0.1,
          "min": 0,
          "max": 11924
        },
        {
          "rate": 0.12,
          "min": 11925,
          "max": 48474
        },
        {
          "rate": 0.22,
          "min": 48475,
          "max": 103349
        },
        {
          "rate": 0.24,
          "min": 103350,
          "max": 197299
        },
        {
          "rate": 0.32,
          "min": 197300,
          "max": 250524
        },
        {
          "rate": 0.35,
          "min": 250525,
          "max": 626349
        },
        {
          "rate": 0.37,
          "min": 626350,
          "max": 999999999
        }
      ],
      "married_filing_jointly": [
        {
          "rate": 0.1,
          "min": 0,
          "max": 23849
        },
        {
          "rate": 0.12,
          "min": 23850,
          "max": 96949
        },
        {
          "rate": 0.22,
          "min": 96950,
          "max": 206699

Fields

Fields marked Premium need a paid plan. On a plan without them the key is absent rather than wrong, so a model never reasons over a substituted value.
FieldTypeExampleDescription
yearnumber2025Tax year for the bracket data
countrystringUSCountry code for tax data
typestringfederalWhich tax the brackets describe, such as federal
bracketsobject{…}Array of tax brackets with rates and income ranges
brackets.singlearray[7]list of rowsRate bands for a single filer
brackets.single.0.ratenumber0.1
brackets.single.0.minnumber0
brackets.single.0.maxnumber11924
brackets.married_filing_jointlyarray[7]list of rowsRate bands for married filers filing jointly
brackets.married_filing_jointly.0.ratenumber0.1
brackets.married_filing_jointly.0.minnumber0
brackets.married_filing_jointly.0.maxnumber23849
brackets.married_filing_separatelyarray[7]list of rowsRate bands for married filers filing separately
brackets.married_filing_separately.0.ratenumber0.1
brackets.married_filing_separately.0.minnumber0
brackets.married_filing_separately.0.maxnumber11924
brackets.head_of_householdarray[7]list of rowsRate bands for a head of household filer
brackets.head_of_household.0.ratenumber0.1
brackets.head_of_household.0.minnumber0
brackets.head_of_household.0.maxnumber16999
standard_deductionobject{…}Standard deduction amounts by filing status
standard_deduction.singlenumber15000
standard_deduction.married_filing_jointlynumber30000
standard_deduction.married_filing_separatelynumber15000
standard_deduction.head_of_householdnumber22500
lastUpdatedstring2026-02-07T06:02:41.898ZWhen the bracket table was last refreshed
marriagePenaltyPremiumobject{…}Where filing jointly stops being worth twice a single filer's thresholds; null when the schedule doubles all the way up
marriagePenalty.appliesFromRatePremiumnumber0.37The rate band at which the doubling first breaks
marriagePenalty.singleThresholdPremiumnumber626350Income at which a single filer enters that band
marriagePenalty.jointThresholdPremiumnumber751600Income at which a couple filing jointly enters the same band
marriagePenalty.jointShortfallPremiumnumber501100How far the joint threshold falls short of twice the single threshold
effectiveRateCurvePremiumobject{…}Effective and marginal rate at a fixed ladder of incomes, for each filing status, showing the shape of the schedule
effectiveRateCurve.singlearray[5]list of rows
effectiveRateCurve.single.0.incomenumber25000
effectiveRateCurve.single.0.taxableIncomenumber10000
effectiveRateCurve.single.0.taxnumber1000
effectiveRateCurve.single.0.effectiveRatenumber0.04
effectiveRateCurve.single.0.marginalRatenumber0.1
effectiveRateCurve.married_filing_jointlyarray[5]list of rows
effectiveRateCurve.married_filing_jointly.0.incomenumber25000
effectiveRateCurve.married_filing_jointly.0.taxableIncomenumber0
effectiveRateCurve.married_filing_jointly.0.taxnumber0
effectiveRateCurve.married_filing_jointly.0.effectiveRatenumber0
effectiveRateCurve.married_filing_jointly.0.marginalRatenumber0.1
effectiveRateCurve.married_filing_separatelyarray[5]list of rows
effectiveRateCurve.married_filing_separately.0.incomenumber25000
effectiveRateCurve.married_filing_separately.0.taxableIncomenumber10000
effectiveRateCurve.married_filing_separately.0.taxnumber1000
effectiveRateCurve.married_filing_separately.0.effectiveRatenumber0.04
effectiveRateCurve.married_filing_separately.0.marginalRatenumber0.1
effectiveRateCurve.head_of_householdarray[5]list of rows
effectiveRateCurve.head_of_household.0.incomenumber25000
effectiveRateCurve.head_of_household.0.taxableIncomenumber2500
effectiveRateCurve.head_of_household.0.taxnumber250
effectiveRateCurve.head_of_household.0.effectiveRatenumber0.01
effectiveRateCurve.head_of_household.0.marginalRatenumber0.1
changesPremiumobject{…}How the table moved since the previous tax year; null when there is no prior year to compare against
changes.versusYearPremiumnumber2024The tax year being compared against
changes.indexingPercentPremiumnumber2.794Average shift across every indexed threshold, which is the inflation adjustment the tax authority actually applied
changes.bracketShiftsPremiumobject{…}Each band's threshold before and after, per filing status, with the percentage it moved

Failure modes

Errors come back as tool errors with a sentence the model can act on, not a bare status code.

StatusWhat it means
400 / 422The arguments didn't validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Out of credits. Not a bad key — the month's allowance is spent.
404This skill isn't part of VerveKit. Check the catalog.
429Brief rate limit. Retrying after a moment succeeds.

Other ways to use Income Tax Brackets Skill

Set up Income Tax Brackets Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an X-API-Key header, with SDKs for Node, Python and .NET.APIVerveReference →
Use it in Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheetsReference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContextReference →

Frequently asked questions

Do I have to tell the agent to use IncomeTaxBracketsSkill?

No. The tool's name and description are in the model's context once the server is connected, so it selects the tool when the question calls for it. Naming it explicitly works too and is useful when you want to force the call.

Does connecting the server expose every tool at once?

Yes — one connection lists the whole VerveKit catalog. Clients with a tool budget can usually filter the list; the credit cost is per call, so an unused tool costs nothing.

What does a call cost?

1 credit each time the tool actually runs. A model that reasons about the tool without calling it costs nothing.

Is there a REST version of this?

Yes — the same source is available as a plain HTTPS endpoint on APIVerve, linked above. Same data, same credits, same account.

What's Next?

Continue your journey with these recommended resources

Was this page helpful?