Verktøyene
Verktøyene regner på samme måte som lån.no regner hvert lån. Hvert verktøy er definert én gang og er det samme i MCP-serveren, i det åpne API-et og i chatten på lån.no. Beskrivelsene er på engelsk, slik språkmodellene leser dem.
calculate_loan
Calculate monthly cost, total cost and effective interest rate (Norwegian «effektiv rente») for an annuity loan, the way lån.no calculates every loan it compares. Amounts in Norwegian kroner (NOK), rates in percent per year. Returns the representative example Norwegian law requires next to a loan offer.
REST: https://xn--ln-yia.no/api/v1/calculate_loan
calculate_loan_schedule
Payment plan for a Norwegian loan (boliglån, hyttelån, billån or forbrukslån), as lån.no's loan calculators show it: monthly payment, effective interest rate («effektiv rente»), cost of credit, total paid and a year-by-year plan. Annuity or serial loan, optional interest-only years and fees. The term must be within the calculator's limits (forbrukslån at most 5 years, billån 12, boliglån and hyttelån 30). Amounts in NOK. The rate is the user's own example rate, not an offer.
REST: https://xn--ln-yia.no/api/v1/calculate_loan_schedule
calculate_affordability
How expensive a home someone in Norway can buy («hvor mye bolig har jeg råd til»), as lån.no estimates it from the usual limits in the Norwegian lending regulation (utlånsforskriften): total debt at most 5 × gross yearly income, at least 10 % equity, and a 3 percentage point rate stress test. An estimate, not a credit assessment. Amounts in NOK.
REST: https://xn--ln-yia.no/api/v1/calculate_affordability
calculate_extra_payment
What paying extra on a mortgage saves («ekstra innbetaling på boliglån»), as lån.no calculates it: a fixed extra amount every month, a lump sum now, or both, each against the same loan without extra payments. After a lump sum the payment is kept (shorter term) or lowered (same term). Assumes an unchanged rate. Amounts in NOK.
REST: https://xn--ln-yia.no/api/v1/calculate_extra_payment
calculate_couple_mortgage
How two people buying a home together in Norway can split ownership, the mortgage and the monthly cost («boliglån for par»), as lån.no calculates it. Ownership follows what each finances, is 50/50 or is chosen; the monthly cost is split equally, by loan share, by income or by a chosen share. Arithmetic, not legal or financial advice. Amounts in NOK.
REST: https://xn--ln-yia.no/api/v1/calculate_couple_mortgage
Slik kaller du dem
MCP-server: https://xn--ln-yia.no/mcp. Model Context Protocol over Streamable HTTP, uten nøkkel og uten sesjon. Legg den til som ekstern server i en MCP-klient, eller send JSON-RPC med POST (initialize, tools/list, tools/call).
Server Card: https://xn--ln-yia.no/mcp/server-card beskriver MCP-serveren før tilkobling (MCP Server Cards, SEP-2127), og AI Catalog lenker til den.
Åpent API: https://xn--ln-yia.no/api/v1/<verktøy>. GET med input som query-parametre, eller POST med input som JSON. Uten nøkkel. Skjemaene for alle verktøyene står i OpenAPI-dokumentet.
Eksempler:
curl "https://xn--ln-yia.no/api/v1/calculate_loan?amount=150000&years=5&nominal_rate=10.9"
curl -X POST https://xn--ln-yia.no/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_loan","arguments":{"amount":150000,"years":5,"nominal_rate":10.9}}}'
Dataene
Renter, gebyrer og vilkår kommer fra Finansportalen, Forbrukerrådets prisportal, og hentes hver time. Effektiv rente, månedsbeløp, kostnad og totalbeløp regner lån.no selv, likt for alle banker. Alt vi deler, sier når dataene ble hentet.
- Markdown: hver side har en Markdown-versjon på samme adresse + .md, for eksempel /forbrukslån.md. Forsiden er /index.md.
- rentedata.json: laveste effektive rente per lånetype på et fast standardlån, med lånet og det representative eksempelet bak tallet.
- llms.txt og llms-full.txt: oversikten over lån.no for språkmodeller.
Kildehenvisning
Oppgi lån.no som kilde med lenke til siden tallet står på. Tall om lån (renter, gebyrer, kostnad) skal i tillegg ha «Data levert av Finansportalen» og tidspunktet dataene ble hentet, slik det står i hver Markdown-versjon, i rentedata.json og i setningene som kan siteres. Effektiv rente er lån.no sin egen, regnet likt for alle banker.
Skriv for eksempel: «Kilde: lån.no. Data levert av Finansportalen, hentet (dato og klokkeslett).», med tidspunktet fra Markdown-versjonen eller rentedata.json.
