Kalkulatory
jako API i serwer MCP

Wyślij zapytanie — dostaniesz wynik w JSON. Kredyty, procent składany, inwestycje, podatki, nieruchomości, walidatory (NIP, PESEL, IBAN) i konwertery. Gotowe dla aplikacji i agentów AI.

48 narzędzi REST + MCP Kursy NBP Bez rejestracji
Szybki start Zobacz narzędzia ← Kalkulatory

Jak zacząć

Za darmo i bez rejestracji możesz wykonać 250 zapytań dziennie (limit liczony per adres IP).

curl -X POST "https://api.kalkula.pl/api/v1/mortgage_calculator" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500000, "annualRatePct": 7.2, "years": 30}'
import requests

r = requests.post(
    "https://api.kalkula.pl/api/v1/mortgage_calculator",
    json={"amount": 500_000, "annualRatePct": 7.2, "years": 30},
)
print(r.json()["monthlyPayment"])   # 3393.9
const res = await fetch(
  "https://api.kalkula.pl/api/v1/mortgage_calculator",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ amount: 500000, annualRatePct: 7.2, years: 30 }),
  }
);
const data = await res.json();
console.log(data.monthlyPayment); // 3393.9
using System.Net.Http.Json;
using System.Text.Json;

using var http = new HttpClient();

var res = await http.PostAsJsonAsync(
    "https://api.kalkula.pl/api/v1/mortgage_calculator",
    new { amount = 500000, annualRatePct = 7.2, years = 30 });
var data = await res.Content.ReadFromJsonAsync<JsonElement>();

Console.WriteLine(data.GetProperty("monthlyPayment")); // 3393.9
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var body = "{\"amount\": 500000, \"annualRatePct\": 7.2, \"years\": 30}";
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.kalkula.pl/api/v1/mortgage_calculator"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body()); // { "monthlyPayment": 3393.9, ... }
<?php
$ch = curl_init("https://api.kalkula.pl/api/v1/mortgage_calculator");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "amount" => 500000, "annualRatePct" => 7.2, "years" => 30,
]));
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $data["monthlyPayment"]; // 3393.9
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"amount": 500000, "annualRatePct": 7.2, "years": 30,
	})
	resp, _ := http.Post(
		"https://api.kalkula.pl/api/v1/mortgage_calculator",
		"application/json", bytes.NewReader(body))
	defer resp.Body.Close()

	var data map[string]any
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["monthlyPayment"]) // 3393.9
}

Przykładowa odpowiedź:

{
  "installmentType": "equal (annuity)",
  "monthlyPayment": 3393.9,
  "numberOfPayments": 360,
  "totalCost": 1221803.9,
  "totalInterest": 721803.9,
  "yearlySchedule": [ { "year": 1, "remainingBalance": 495786.24 }, "…" ]
}

Serwer MCP dla agentów AI

Wszystkie 48 narzędzi jest dostępnych jako narzędzia Model Context Protocol (transport Streamable HTTP). Podłącz je do Claude, Claude Code lub dowolnego klienta MCP — agent sam policzy ratę kredytu czy rentowność najmu.

Adres serwera

https://api.kalkula.pl/mcp

Konfiguracja (np. Claude Code)

claude mcp add --transport http kalkula https://api.kalkula.pl/mcp

Zapytania MCP wliczają się w ten sam dzienny limit co REST — 250 zapytań na dobę, bez rejestracji.

48 narzędzi

Każde narzędzie działa jako endpoint REST (POST /api/v1/<nazwa> z ciałem JSON) i jako narzędzie MCP o tej samej nazwie. Kliknij, aby zobaczyć parametry i wypróbować na żywo.

Limity zapytań

Limity odnawiają się co 24 godziny. Po ich przekroczeniu API zwraca 429 Too Many Requests z nagłówkiem Retry-After.

DostępLimit dziennyLiczony per
Darmowy, bez rejestracji250 zapytańadres IP

FAQ

Czy API jest darmowe?

Tak. Bez rejestracji i bez klucza masz 250 zapytań dziennie na adres IP.

Skąd pochodzą kursy walut?

Z oficjalnego API Narodowego Banku Polskiego (tabela A, kurs średni). Kursy odświeżamy co godzinę.

Czy mogę podłączyć API do agenta AI?

Tak — to główny scenariusz. Serwer MCP pod adresem /mcp wystawia wszystkie 48 narzędzi jako narzędzia dla Claude i innych klientów MCP.

Czy wyniki podatkowe są wiążące?

Nie. Kalkulator podatkowy stosuje uproszczone reguły (skala 12%/32%, składka zdrowotna, stawki z roku odniesienia) i służy do szacunków — nie zastępuje porady księgowej.