BNBCalc MCP - Informacje
Co udostępnia serwer i jak się zachowuje: uwierzytelnianie, każde narzędzie z ceną, zgoda na narzędzia płatne, limity i błędy. Aby podłączyć aplikację, postępuj zgodnie z instrukcją konfiguracji.
- Adres
https://atlas.bnbcalc.com/mcp- Transport
- Streamable HTTP przez POST, bez sesji
- Uwierzytelnianie
- Zaloguj się przez BNBCalc (OAuth) lub użyj klucza API w x-bnbcalc-api-key
Uwierzytelnianie
Aplikacje, które mogą otworzyć stronę logowania, łączą się za pomocą OAuth: użytkownik loguje się do BNBCalc i klika Zezwól, a aplikacja wysyła token dostępu jako token Bearer. Darmowe narzędzia działają dla każdego zalogowanego konta. Płatne narzędzia wymagają subskrypcji API.
Aplikacje i skrypty, które nie mogą otworzyć strony logowania, wysyłają klucz API BNBCalc w nagłówku x-bnbcalc-api-key. Klucze wymagają subskrypcji API. Gdy żądanie zawiera zarówno klucz, jak i token, klucz ma pierwszeństwo.
Przewodnik konfiguracjiPłatne narzędzia i zatwierdzenie
Narzędzie płatne wywołane bez confirmed: true nic nie wykonuje i zwraca wycenę. Pokaż wycenę użytkownikowi i powtórz wywołanie z confirmed: true dopiero po jego zatwierdzeniu.
Fakturowane są tylko udane wywołania. Wywołanie, które zakończy się niepowodzeniem lub nie zwróci żadnych danych, nic nie kosztuje. Nie ponawiaj automatycznie płatnego wywołania po przekroczeniu limitu czasu: może ono nadal zostać zakończone i obciążone.
Narzędzia tworzące analizę dodają 10 jednostek za każdą ukończoną funkcję AI.
Narzędzia
Każde narzędzie wywołuje pasujący punkt końcowy REST, dzięki czemu jego wyniki są zgodne z API. Ceny są za pomyślne wywołanie. Narzędzie z trasą pod spodem przyjmuje te same pola co ten punkt końcowy.
Przychody i porównania
estimate_revenue
Tylko do odczytu
Roczne przychody, stawka za noc i obłożenie
$0.10 (10 jednostek)
find_comparables
Tylko do odczytu
Do 50 pobliskich ofert z przychodami
$0.10 (10 jednostek)
get_listing
Tylko do odczytu
Jeden szczegółowy, porównywalny listing
$0.05 (5 jednostek)
get_live_listing
Tylko do odczytu
Aktualne szczegóły oferty Airbnb
$0.05 (5 jednostek)
get_listing_photos
Tylko do odczytu
Zdjęcia oferty
Darmowy
Analizy
create_buy_analysis
Zapisuje się na Twoim koncie
Analiza zakupu z przepływem pieniężnym i zwrotami
POST /v1/external/analysis/create/buy$0.20 (20 jednostek)
create_owned_analysis
Zapisuje się na Twoim koncie
Analiza posiadanej nieruchomości
POST /v1/external/analysis/create/owned$0.20 (20 jednostek)
create_arbitrage_analysis
Zapisuje się na Twoim koncie
Analiza arbitrażu wynajmu z miesięcznego czynszu
POST /v1/external/analysis/create/arb$0.20 (20 jednostek)
create_cohost_analysis
Zapisuje się na Twoim koncie
Analiza współgospodarowania z Twoją prowizją
POST /v1/external/analysis/create/cohost$0.20 (20 jednostek)
enhance_analysis
Zapisuje się na Twoim koncie
Dodaj porównania AI lub szacunki wydatków AI
POST /v1/external/analysis/enhance$0.10 (10 jednostek)
get_analysis
Tylko do odczytu
Odczytaj zapisaną analizę
Darmowy
list_analyses
Tylko do odczytu
Wylistuj zapisane analizy
Darmowy
get_ai_comps
Tylko do odczytu
Wybór porównań AI i uzasadnienie
Darmowy
get_expense_estimates
Tylko do odczytu
Szacunki wydatków AI
Darmowy
get_report_link
Tylko do odczytu
Link do udostępnianego raportu
Darmowy
Nieruchomość i czynsze
get_property_details
Tylko do odczytu
Łóżka, rozmiar, wartość i podatki dla adresu w USA
$0.05 (5 jednostek)
get_rent_estimate
Tylko do odczytu
Wynajem długoterminowy z porównywalnymi czynszami
$0.05 (5 jednostek)
get_section8_rents
Tylko do odczytu
Czynsze z programu Section 8 (HUD) i z Census wg kodu pocztowego
Darmowy
Kalkulatory
calculate_amortization
Tylko do odczytu
Spłata kredytu i harmonogram
Darmowy
calculate_dscr
Tylko do odczytu
Wskaźnik pokrycia obsługi długu
Darmowy
calculate_tax_benefits
Tylko do odczytu
Amortyzacja i oszczędności podatkowe
Darmowy
calculate_sell_or_refinance
Tylko do odczytu
Porównaj sprzedaż z refinansowaniem
Darmowy
Optymalizator ofert
run_listing_optimization
Zapisuje się na Twoim koncie
Przepisz i oceń ofertę Airbnb
1 kredyt
get_listing_optimization
Tylko do odczytu
Status i ocena wykonania
Darmowy
list_listing_optimizations
Tylko do odczytu
Twoje poprzednie wykonania
Darmowy
get_listing_optimization_report_url
Tylko do odczytu
Link do pobrania raportu
Darmowy
Konto i rejestry
get_account
Tylko do odczytu
Status planu, kredytów i klucza
Darmowy
get_usage
Tylko do odczytu
Żądania i rozliczone użycie
Darmowy
get_api_health
Tylko do odczytu
Sprawdź dostępność API
Darmowy
get_material_participation
Tylko do odczytu
Godziny i testy udziału materiałowego
Darmowy
log_material_participation_hours
Zapisuje się na Twoim koncie
Rejestruj godziny dla nieruchomości
Darmowy
Limity
- Wyszukiwania danych dzielą dzienny limit z API REST. Resetuje się o 00:00 UTC, a nieudane wyszukiwania również się liczą.
- Praca AI jest ograniczona do 10 żądań na minutę i 2 jednocześnie na konto.
- Analizy nie można edytować ani usuwać za pośrednictwem MCP.
Błędy
Serwer odpowiada statusem HTTP i komunikatem określającym przyczynę. Przewodnik konfiguracji wymienia najczęstsze problemy wraz z ich rozwiązaniami.
Najczęstsze błędy i ich rozwiązania Sprawdź status serwera