Return a year-by-year projection of a dividend portfolio: dividends received, DRIP reinvestment, contributions, share count, share price, ending value, plus final yearly and monthly dividend income and yield on cost. All rates are yearly percentages; contributions and reinvested dividends buy shares at the mid-year average price.
This page documents the HTTP endpoint POST /api/tools/dividend-calculator/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/dividend-calculator/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/dividend-calculator/execute \
-H "Content-Type: application/json" \
-d '{
"initial_investment": 10000,
"share_price": 50,
"dividend_yield": 4,
"dividend_growth": 5,
"share_price_growth": 7,
"monthly_contribution": 500,
"years": 20
}'Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/dividend-calculatorInput schema
| Argument | Type | Required | Description |
|---|---|---|---|
| initial_investment | number | yes | Starting amount invested. |
| share_price | number | yes | Current share price. Must be > 0. |
| dividend_yield | number | yes | Starting dividend yield in percent (4 = 4%). |
| dividend_growth | number | no | Yearly dividend growth in percent. Default: 0. |
| share_price_growth | number | no | Yearly share price growth in percent. Default: 0. |
| monthly_contribution | number | no | Amount added every month. Default: 0. |
| years | integer | yes | Projection length in years. |
| reinvest_dividends | boolean | no | Reinvest dividends (DRIP). Default: true. |
Example arguments (verified)
{
"initial_investment": 10000,
"share_price": 50,
"dividend_yield": 4,
"dividend_growth": 5,
"share_price_growth": 7,
"monthly_contribution": 500,
"years": 20
}Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:dividend_calculator after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/More Finance tools
Amortization Calculator
Return a full loan amortization schedule (one row per month with payment, principal, interest, extra payment, balance) plus totals, interest
Auto Loan Calculator
Return the monthly car payment, total interest, financed amount, and a month-by-month amortization schedule for an auto loan.
Break Even Calculator
Return the break-even point of a product or business: contribution margin, contribution margin ratio, break-even units and revenue, plus the
Business Loan Calculator
Return the monthly payment, total interest, origination fee, effective yearly rate (interest plus fees), a yearly summary, and a full monthl
Compound Interest
Compute compound interest growth.
Credit Card Payoff Calculator
Return how long a credit card balance takes to pay off at a fixed monthly payment (mode "payment"), or the payment needed to clear it in a t
Credit Card Validate
Validate a credit card number with the Luhn checksum and detect the brand.
Debt Payoff Calculator
Return a debt payoff plan for several debts using the avalanche (highest rate first) or snowball (lowest balance first) strategy: total mont