Calculate US Capital Gains
calculate_us_capital_gainsCalculate US capital gains tax — short-term (ordinary rates) or long-term (preferential rates). Returns: {tax, gain_type}. See list_bundles for related 'finance-us' calculators.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"purchase_price": "<purchase_price>",
"sale_price": "<sale_price>",
"holding_period_months": "<holding_period_months>"
},
"name": "calculate_us_capital_gains"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sale_price | Yes | Sale price in USD | |
| filing_status | No | Filing status for rate thresholds | single |
| purchase_price | Yes | Original purchase price in USD | |
| holding_period_months | Yes | Holding period in months |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | Computed result. Object whose fields depend on the tool (e.g. {tax, marginal_rate, brackets} for tax tools, {volume_l, gallons} for volume tools). | |
| source | No | Authoritative source for the rule or formula (e.g. "Article 197 CGI", "NF DTU 21"). | |
| formula | No | Human-readable formula or method used (e.g. "I=P·r·t", "Magnus formula"). | |
| reference_url | No | Link to a calcul2 page documenting the calculation in detail. |