API a MCP server

Na rychlahypo.cz počítáme hypotéky České spořitelny, ČSOB, Komerční banky, UniCredit Bank, Raiffeisenbank a mBank. Když se někdo zeptá AI asistenta, třeba ChatGPT nebo Claude, kolik mu banka půjčí, asistent to nemusí odhadovat. Může si to spočítat u nás podle metodik jednotlivých bank.

• GET /api/v1/rates vrátí aktuální sazby podle fixace, přirážky nad 80 % LTV, limity a poplatky.
• POST /api/v1/compare spočítá splátku, RPSN a celkovou cenu konkrétní hypotéky u každé banky a seřadí je od nejlevnější.
• POST /api/v1/max-loan řekne, kolik půjčí která banka podle příjmů, výdajů a závazků domácnosti, nebo jestli projde konkrétní částka.

Z dotazů nic neukládáme. Jméno, rodné číslo ani kontakt nechceme, stačí věk a částky. Strojový popis najdete v OpenAPI 3.1, souhrn pro jazykové modely v llms.txt.

MCP (Model Context Protocol) je standard, kterým se AI asistentovi přidávají nástroje. Po připojení dostane asistent čtyři: get_mortgage_rates, compare_mortgages, calculate_max_mortgage a get_advisor_contact.

Claude Code

claude mcp add --transport http rychlahypo https://rychlahypo.cz/mcp

Claude, ChatGPT a další aplikace

V nastavení konektorů přidejte vlastní konektor s adresou https://rychlahypo.cz/mcp. V ChatGPT je k tomu potřeba zapnout režim pro vývojáře.

Cursor, VS Code, Windsurf

{
  "mcpServers": {
    "rychlahypo": { "url": "https://rychlahypo.cz/mcp" }
  }
}

GET/api/v1/rates?fixation=3R

Pro každou banku vrátí sazby na fixaci 1, 3, 5, 7 a 10 let s RPSN k modelovému úvěru 4 miliony na 30 let (null znamená, že banka fixaci nenabízí), přirážku pro LTV 81 až 90 %, přirážku za malý úvěr, maximální LTV a splatnost a jednorázové poplatky. Parametr fixation je nepovinný.

Sazby platí do 80 % LTV a jsou bez slevy za pojištění schopnosti splácet. Každý den je ověřujeme v kalkulačkách bank, datum je v poli rates_updated.

curl https://rychlahypo.cz/api/v1/rates?fixation=3R

POST/api/v1/compare

Kolik stojí konkrétní hypotéka u každé banky. Započítá přirážky podle LTV i za malý úvěr a limity bank. Výsledek je seřazený od nejnižší splátky, banky, které úvěr nenabídnou, jsou v unavailable i s důvodem. Stejné parametry jdou poslat i jako GET v adrese.

loan_amountpovinné

Výše úvěru v Kč.

property_value

Cena nebo odhad nemovitosti v Kč. Bez ní počítáme sazby do 80 % LTV.

term_years

Splatnost v letech, 5 až 40. Výchozí 30.

fixation

1R, 3R, 5R, 7R nebo 10R. Výchozí 3R.

all_applicants_under_36

Všem žadatelům je méně než 36 let. UniCredit pak nad 80 % LTV přirážku neúčtuje.

curl -X POST https://rychlahypo.cz/api/v1/compare \
  -H "Content-Type: application/json" \
  -d '{"loan_amount":4000000,"property_value":5000000,"term_years":30,"fixation":"3R"}'

{
  "offers": [
    {
      "bank_id": "unicredit",
      "name": "UniCredit Bank",
      "interest_rate": 5.29,
      "rpsn": 5.44,
      "monthly_payment": 22187,
      "total_payable": 7993820,
      "one_off_fees": 6500
    },
    … další banky od nejlevnější …
  ],
  "summary": {
    "cheapest_bank": "UniCredit Bank",
    "monthly_difference": 1641,
    "difference_over_term": 590760
  },
  "legal": { … }, "source": { … }, "next_steps": { … }
}

POST/api/v1/max-loan

Bez requested_loan vrátí maximum, které půjčí každá banka, a co ho omezuje. S requested_loan řekne u každé banky, jestli částka projde, s jakou splátkou a proč případně ne. Výpočet průběžně porovnáváme s kalkulačkami bank, u běžných profilů sedí do 5 %.

applicantspovinné, 1 až 4

Žadatelé. U každého age, income_type a net_income (čistý měsíční příjem).

income_type

employee zaměstnanec, osvc_vydpausal OSVČ s výdajovým paušálem, osvc_skutecne se skutečnými výdaji, osvc_paus paušální daň, sro společník s.r.o., pension, parental, ppm, rental, dpp, dividends, vysluha.

annual_revenue, annual_tax_base

U OSVČ roční příjmy a základ daně z posledního přiznání. K paušálu flat_expense_rate (0.4, 0.6 nebo 0.8).

property_value

Cena nemovitosti v Kč. Bez ní dostanete jen maximum podle příjmů.

requested_loan

Konkrétní částka k posouzení.

children_ages, married

Věky vyživovaných dětí, třeba [3, 9]. Stačí i počet v children, pak je počítáme jako děti od 6 do 15 let. married znamená manžele ve společném jmění.

region

praha, regional (výchozí) nebo small. Mění životní náklady.

loan_payments, existing_debt_balance

Měsíční splátky a zůstatek stávajících úvěrů. Dále credit_card_limits, overdraft_limits, alimony_paid, housing_cost.

purpose, property_type

Účel koupe, refinancovani, stavba, rekonstrukce, neucelova, vyporadani. Nemovitost byt, dum, coop, land, rekreacni.

term_years, fixation, investment

Splatnost (výchozí 30), fixace (výchozí 3R), investiční nemovitost.

curl -X POST https://rychlahypo.cz/api/v1/max-loan \
  -H "Content-Type: application/json" \
  -d '{
    "applicants": [
      {"age": 32, "income_type": "employee", "net_income": 48000},
      {"age": 30, "income_type": "employee", "net_income": 36000}
    ],
    "children_ages": [4], "married": true,
    "property_value": 6500000, "region": "praha"
  }'

{
  "mode": "max_loan",
  "summary": { "highest_max_loan": { "bank": "UniCredit Bank", "amount": 5850000 } },
  "banks": [
    {
      "name": "UniCredit Bank",
      "interest_rate": 5.29,
      "max_loan": 5850000,
      "rpsn_at_max": 5.43,
      "monthly_payment_at_max": 32449,
      "limited_by": "LTV (hodnota nemovitosti)",
      "rejected": false
    },
    … dalších 5 bank …
  ]
}

• legal: datum sazeb, reprezentativní příklad s RPSN, kdo hypotéky zprostředkovává a upozornění, že nejde o nabídku banky ani o radu. Česky i anglicky.
• source: odkaz na rychlahypo.cz a tuhle dokumentaci.
• next_steps: kam poslat člověka, který chce hypotéku opravdu vyřídit. Konfigurátor, telefon +420 799 794 670 a e-mail.
• Chyba ve vstupu vrátí HTTP 400 a {"ok": false, "error": "…"} s popisem, co opravit. Při překročení limitu HTTP 429.

Částky jsou v korunách, sazby a RPSN v procentech ročně. Všechny endpointy posílají CORS hlavičky, takže je jde volat i přímo z prohlížeče.

• API je zdarma. Výsledky smíte ukazovat lidem v AI asistentech, aplikacích a na webu. Z jedné IP adresy zvládne 20 dotazů za minutu.
• Zakázané je výsledky přeprodávat, stavět nad API vlastní srovnávač nebo kalkulačku hypoték, stahovat výsledky hromadně a zkoušet z odpovědí poskládat metodiku výpočtu. Při porušení přístup zablokujeme.
• Když výsledek ukazujete lidem, uveďte RPSN aspoň stejně zřetelně jako úrokovou sazbu a jako zdroj Rychlou Hypo s odkazem na rychlahypo.cz. RPSN vedle sazby vyžaduje § 91 zákona o spotřebitelském úvěru.
• Výsledky jsou orientační. Nejde o nabídku banky ani o radu podle zákona č. 257/2016 Sb., konečné podmínky stanoví banka po posouzení žadatele.
• Obsah dotazů neukládáme a nikam dál neposíláme.
• Tohle je verze v1. Nekompatibilní změny dostanou novou verzi a v1 poběží dál.
• Dotazy, chyby a nápady pište na [email protected].

Hypotéka na bydlení ve výši 4 000 000 Kč na dobu 30 let, tj. 360 měsíčních splátek po 22 187 Kč, při pevné zápůjční úrokové sazbě 5,29 % p. a. se závazkem na 3 roky. RPSN 5,44 %. Celková částka splatná spotřebitelem 7 993 820 Kč. Do výpočtu jsou zahrnuty poplatky: odhad nemovitosti 4 500 Kč a návrh na vklad zástavního práva do katastru 2 000 Kč.

Úvěr je zajištěn zástavním právem k nemovitosti. Banky zpravidla vyžadují pojištění nemovitosti s vinkulací ve prospěch banky, jeho náklady nejde předem určit a v RPSN nejsou. Zprostředkovatel: Jan Kurdiovský, vázaný zástupce SAB servis s.r.o. Informace o zprostředkovateli.