API en MCP-server

Wat kun je ermee?

• Rekentools aanroepen: box 1, eigenwoningforfait, dividend, inflatiecorrectie op CBS-data en zeven bedrijfsratio's.
• Begrippen met definitie, veelgestelde vragen en cijfers met bronnen ophalen of doorzoeken.
• Een AI-assistent koppelen via MCP, zodat hij met gecontroleerde Nederlandse cijfers kan rekenen.

Hoe gebruik je de API in een paar regels?

curl "https://dftonline.nl/api/v1/box1?income=48000"
curl "https://dftonline.nl/api/v1/inflatie?amount=1000&from=2000&to=2025"
curl "https://dftonline.nl/api/v1/begrippen/box-3"
curl "https://dftonline.nl/api/v1/zoeken?q=eigenwoningforfait"

De volledige beschrijving staat in /openapi.json (OpenAPI 3.1). CORS staat open, dus je kunt de API ook vanuit een browser aanroepen.

Welke rekenendpoints zijn er?

Endpoint	Wat het doet	Parameters (* verplicht)
/api/v1/box1	Inkomstenbelasting in box 1 (2026) na heffingskortingen, voor mensen onder de AOW-leeftijd.	income*, works
/api/v1/eigenwoningforfait	Eigenwoningforfait 2026 en effect van hypotheekrenteaftrek en Wet Hillen op de belasting in box 1.	woz*, rente, income_ex_woning
/api/v1/dividend	Netto dividend na dividendbelasting (15%), box 2 of buitenlandse bronheffing.	gross*, kind, box2_other, foreign_rate
/api/v1/dividendrendement	Dividendrendement van een aandeel.	price*, dps*, shares
/api/v1/inflatie	Wat is een bedrag uit jaar A waard in jaar B, op basis van de CBS-jaarmutatie van de CPI (1963 tot 2025).	amount*, from*, to*
/api/v1/samengestelde-rente	Eindsaldo met samengestelde rente (jaarlijkse bijschrijving, inleg aan het einde van het jaar).	start*, add, rate*, years*
/api/v1/ratios/ebitda-berekenen	EBITDA berekenen: EBITDA = nettowinst + belastingen + rentelasten + afschrijvingen en amortisatie	nw*, bel*, rente*, afs*, oms*
/api/v1/ratios/current-ratio-berekenen	Current ratio berekenen: Current ratio = vlottende activa / kortlopende schulden	va*, ks*
/api/v1/ratios/quick-ratio-berekenen	Quick ratio berekenen: Quick ratio = (vlottende activa - voorraden) / kortlopende schulden	va*, vo*, ks*
/api/v1/ratios/solvabiliteit-berekenen	Solvabiliteit berekenen: Solvabiliteit = eigen vermogen / totaal vermogen × 100%	ev*, tv*
/api/v1/ratios/winstmarge-berekenen	Winstmarge berekenen: Winstmarge = nettowinst / omzet × 100%	nw*, oms*
/api/v1/ratios/break-even-berekenen	Break-even punt berekenen: Break-even afzet = vaste kosten / (verkoopprijs - variabele kosten per stuk)	vk*, p*, vv*
/api/v1/ratios/rentabiliteit-berekenen	Rentabiliteit berekenen: Rentabiliteit eigen vermogen = nettowinst / eigen vermogen × 100%. Rentabiliteit totaal vermogen = (nettowinst + rentelasten) / totaal vermogen × 100%	nw*, rente*, ev*, tv*
/api/v1/begrippen	Alle begrippen met definitie (optioneel ?hub=belasting)	hub
/api/v1/begrippen/{slug}	Eén begrip met veelgestelde vragen, cijfers en bronnen	slug
/api/v1/zoeken	Zoeken in begrippen en aliassen	q*

Hoe koppel je de MCP-server aan een AI-assistent?

De MCP-server draait op https://dftonline.nl/mcp (streamable HTTP, zonder inloggen). In Claude Code:

claude mcp add --transport http financiele-termenlijst https://dftonline.nl/mcp

In andere clients voeg je een externe MCP-server toe met de URL hierboven. De server stelt deze tools beschikbaar:

• box1_berekenen: Inkomstenbelasting in box 1 (2026) na heffingskortingen, voor mensen onder de AOW-leeftijd.
• eigenwoningforfait_berekenen: Eigenwoningforfait 2026 en effect van hypotheekrenteaftrek en Wet Hillen op de belasting in box 1.
• dividend_berekenen: Netto dividend na dividendbelasting (15%), box 2 of buitenlandse bronheffing.
• dividendrendement_berekenen: Dividendrendement van een aandeel.
• inflatie_corrigeren: Wat is een bedrag uit jaar A waard in jaar B, op basis van de CBS-jaarmutatie van de CPI (1963 tot 2025).
• samengestelde_rente_berekenen: Eindsaldo met samengestelde rente (jaarlijkse bijschrijving, inleg aan het einde van het jaar).
• bedrijfsratio_berekenen: EBITDA, current ratio, quick ratio, solvabiliteit, winstmarge, break-even en rentabiliteit
• begrippen_zoeken: zoek een begrip
• begrip_opzoeken: definitie, vragen, cijfers en bronnen van één begrip

Een beschrijving voor automatische ontdekking staat in /.well-known/mcp/server-card.json en in /llms.txt.

Welke afspraken gelden voor gebruik van de API?

• Limiet: 60 verzoeken per minuut per IP-adres. Bij meer krijg je een 429.
• Bronvermelding: vrij te gebruiken met vermelding van dftonline.nl.
• Geen advies: de berekeningen zijn indicatief en gebaseerd op openbare parameters van 2026. Controleer bij belangrijke beslissingen de bron die in het antwoord staat.
• Privacy: we slaan geen IP-adressen, parameters of cookies op. Alleen aantallen per endpoint en per dag.
• Versie: 1.0.0. Parameters worden jaarlijks bijgewerkt; het jaartal staat in elk antwoord.