# Dividend Calculator — REST API endpoint `dividend-calculator`

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.

- Category: finance
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/dividend-calculator/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/dividend-calculator/
- Same tool on the other surface: https://findutils.com/mcp/dividend-calculator/

## Call the endpoint (verified example)

```bash
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
curl https://api.findutils.com/api/tools/dividend-calculator
```

## Input 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):

```json
{
  "initial_investment": 10000,
  "share_price": 50,
  "dividend_yield": 4,
  "dividend_growth": 5,
  "share_price_growth": 7,
  "monthly_contribution": 500,
  "years": 20
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:dividend_calculator`. Full MCP reference: https://findutils.com/mcp/dividend-calculator/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt