MCP / KONTRAKT 1.0
Dokumentacja MCP i API pralek
Endpoint /api/mcp/, transport Streamable HTTP w trybie stateless, odpowiedzi JSON. SDK obsługuje initialize, tools/list i tools/call. GET bez strumienia zdarzeń zwraca 405.
| Narzędzie | Wejście | Wynik |
|---|---|---|
| list_washer_rankings | pusty obiekt | Dostępne rankingi i wersje metod |
| get_washer_ranking_method | ranking_code | Wagi, kotwice, kwalifikacja, jednostki i scenariusz |
| rank_washers | request | Modele, składowe punktacji, koszty, daty i źródła |
Przykładowe żądanie R09
Poniższy przykład jest generowany z konfiguracji metody. Wymaga dostępnego rankingu; historyczne ceny są jawnie zaakceptowane.
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "rank_washers",
"arguments": {
"request": {
"ranking_code": "R09",
"method_version": "score-v2-composite",
"filters": {},
"scenario": {
"cycles_per_year": 208,
"years": 5,
"electricity_pln_kwh": 1,
"water_sewage_pln_m3": 15,
"target_capacity_kg": 8,
"assumptions": "Editorial scenario, not a current national tariff. Eco label weighted consumption applied per cycle; no claim for other programs or actual load. Constant prices, no discounting. Excludes detergent, delivery, repairs."
},
"coupon_policy": "include_labeled",
"include_stale_prices": true,
"offset": 0,
"limit": 5
}
}
}
}Semantyka i ograniczenia
- Cała kwalifikująca się populacja jest oceniana przed paginacją; offset i limit nie zmieniają metody.
- Wagi muszą sumować się do 1, pochodzić z wybranej metody i zachować dodatnią wagę ceny.
- R09 oznacza dokładnie 8 kg. Personalizacja nie usuwa tej bramki.
- Woda i energia odnoszą się do deklarowanego programu Eco. Cena nie zawiera dostawy. Wynik punktowy nie jest oceną użytkowników.
- Bez include_stale_prices historyczne oferty są wykluczane. Kupon jest oznaczony, brak kodu nie jest uzupełniany zgadywaniem.
- Brak publikacji, błędne parametry oraz awaria źródła nie są zastępowane danymi demonstracyjnymi.
Źródło kontraktu: repozytorium AI AD. Starsze narzędzia katalogowe: MCPshop.