Świadectwo Energetyczne 24

pl.swiadectwo-energetyczne24由 swiadectwo-energetyczne24.pl 發布官方發布者v1.2.0更新於 Oct 24, 2026

Polish energy performance certificates: pricing, requirements, order, documents, payment link

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

讓助理回答波蘭能效證書相關問題、逐步收集房產資料建立訂單、附加文件並提供付款連結。

可以做什麼
查詢報價：房產類型、基本價格、付費加購項目、文件類型，以及暖氣、生活熱水、通風、門窗的允許值，還有服務說明、流程、辦理時間、法律依據與常見問題。
適用情境
當波蘭的使用者需要能效證書（świadectwo charakterystyki energetycznej），想了解價格與要求、逐步準備訂單資料，或取得付款連結時使用。它不是通用工具。
執行需求
可使用遠端 Streamable HTTP 端點（不需權杖），或以 Node.js 20 以上透過 npx 執行 npm 套件。公開端點依 IP 限流，每 10 分鐘 60 次請求。另有選用變數 SE24_MCP_URL 與 SE24_MCP_TOKEN，用於其他或受保護的端點。
安裝前請注意
助理會建立與更新真實訂單並回傳付款連結；付款與法律同意由本人在網站上完成，伺服器不接收信用卡資料。建立訂單時回傳的 access_token 是該訂單唯一的鑰匙，必須保存並傳給後續呼叫。個人資料只回傳給權杖持有者，上傳的檔案會送到服務商系統。表單值與提示訊息為波蘭語。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Świadectwo Energetyczne 24，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/pl.swiadectwo-energetyczne24%2Fzamowienia/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "wiadectwo-energetyczne-24": {
      "type": "http",
      "url": "https://swiadectwo-energetyczne24.pl/api/mcp"
    }
  }
}

README

swiadectwo-energetyczne24-mcp

[npm] [license] [test]

MCP server for ordering energy performance certificates in Poland (świadectwo charakterystyki energetycznej) from swiadectwo-energetyczne24.pl.

An AI assistant can answer questions about the offer and prices, collect the property data one question at a time, attach documents and hand the user a payment link. Legal consents and payment are always completed by a person on the website — the server never takes card data or consents.

Install

Claude Code:

bash
claude mcp add swiadectwo-energetyczne24 -- npx -y swiadectwo-energetyczne24-mcp

Claude Desktop, Cursor and other clients (mcpServers in the config file):

json
{  "mcpServers": {    "swiadectwo-energetyczne24": {      "command": "npx",      "args": ["-y", "swiadectwo-energetyczne24-mcp"]    }  }}

Clients that speak Streamable HTTP can skip the package and connect straight to the remote server — no token needed:

json
{  "mcpServers": {    "swiadectwo-energetyczne24": {      "type": "http",      "url": "https://swiadectwo-energetyczne24.pl/api/mcp"    }  }}

Tools

ToolWhat it does
get_certificate_optionsProperty types with base prices, paid add-ons, document types, allowed values
get_certificate_informationOffer, process, lead time, documents, legal basis, FAQ, contact
create_certificate_orderCreates an order and returns its order_id and one-time access_token
get_certificate_order_requirementsWhat is still missing, with a ready question and allowed values per field
update_certificate_orderFills in fields of an order
get_certificate_orderCurrent data of an order
get_certificate_order_statusOrder, payment and certificate status
calculate_certificate_pricePrice of a specific order (net, VAT, gross, line items)
get_payment_linkLink to the page where the user gives consents and pays
create_document_upload_urlPre-signed upload URL for a photo or document
add_property_documentAttaches an uploaded file to the order

The list above is informational: this package is a thin stdio client that forwards every message to https://swiadectwo-energetyczne24.pl/api/mcp, so tools, schemas, prices and questions always come from the live service. Form values and messages for the end user are in Polish.

How it works

  • JSON-RPC 2.0 over stdio, one message per line, forwarded over Streamable HTTP.
  • No dependencies; Node.js 20 or newer.
  • Public endpoint, rate limit 60 requests per 10 minutes per IP address.
  • Each order is protected by its own access_token, returned once by create_certificate_order; order_id alone opens nothing.

Environment variables (optional):

VariableMeaning
SE24_MCP_URLEndpoint to forward to (default https://swiadectwo-energetyczne24.pl/api/mcp)
SE24_MCP_TOKENBearer token, only if the endpoint requires one (the public one does not)

Development

bash
npm test

test.js starts the server, performs a real handshake (initialize, notifications/initialized, tools/list, tools/call) and compares the price returned by the tool with the one published at /api/pricing. It also checks that the versions in package.json and server.json agree. GitHub Actions repeats it every week.

Releasing a new version — in this order:

  1. Bump version in package.json and in server.json (version and packages[].version).
  2. npm test
  3. npm publish (the package must exist on npm before the registry sees it).
  4. Push to main — a change in server.json starts the workflow that publishes to the MCP Registry.

Po polsku

Serwer MCP serwisu swiadectwo-energetyczne24.pl: asystent AI (Claude, ChatGPT, Cursor i inne klienty MCP) odpowiada na pytania o ofertę i ceny, zbiera dane nieruchomości, dołącza dokumenty i podaje link do płatności za świadectwo charakterystyki energetycznej. Zgody i płatność zawsze potwierdza człowiek na stronie.

Instalacja w Claude Code:

bash
claude mcp add swiadectwo-energetyczne24 -- npx -y swiadectwo-energetyczne24-mcp

Opis narzędzi i API po polsku: swiadectwo-energetyczne24.pl/api.

License

Code: MIT. Content returned by the service: see NOTICE.

來源：README.md，提交 06185cd

工具

11

get_certificate_options

Opcje świadectwa

Oferta: typy nieruchomości, dla których wystawiamy świadectwo (z ceną bazową brutto PLN), płatny dodatek (wersja papierowa), obsługiwane typy dokumentów i listy dozwolonych wartości (ogrzewanie, CWU, wentylacja, okna, drzwi). Wywołaj jako pierwsze, jeśli użytkownik nie określił typu nieruchomości. Ceny tu są cennikowe — cenę konkretnego zamówienia liczy calculate_certificate_price. Wartości enum podawaj później DOKŁADNIE tak, jak tu wyglądają.

輸入參數property_type

get_certificate_information

Informacje o usłudze

Fakty o usłudze pochodzące z naszego systemu: dla jakich nieruchomości wystawiamy świadectwo, przebieg procesu, czasy realizacji, wymagane dokumenty, podstawa prawna, FAQ i kontakt. Używaj tego zamiast odpowiadać z własnej wiedzy.

輸入參數topics

create_certificate_order

Utwórz zamówienie świadectwa

Tworzy zamówienie świadectwa charakterystyki energetycznej. NIE musisz mieć wszystkich danych — podaj, co już wiesz; odpowiedź zawiera brakujące pola i pytanie, które zadać jako następne. Zwrócony access_token jest jedynym kluczem do tego zamówienia: zapamiętaj go i przekazuj do pozostałych narzędzi. Zamówienie nie jest opłacone dopóki użytkownik nie przejdzie przez link z get_payment_link.

輸入參數doorsfieldsaddressoptionswindowscustomerpropertyproperty_type必填idempotency_key

get_certificate_order_requirements

Czego brakuje w zamówieniu

Zwraca listę pól, których brakuje, żeby zamówienie było gotowe do płatności — razem z gotowym pytaniem po polsku i dozwolonymi wartościami. To backend decyduje, czego brakuje; nie zgaduj i nie pytaj o pola spoza tej listy.

輸入參數order_id必填access_token必填

update_certificate_order

Uzupełnij zamówienie

Częściowa aktualizacja zamówienia — podajesz tylko te pola, które chcesz ustawić lub zmienić; reszta zostaje nienaruszona. Zwraca aktualny status i pozostałe braki. Jeśli którakolwiek wartość jest spoza dozwolonej listy, NIC nie zostaje zapisane i dostajesz błąd INVALID_FIELD_VALUE.

輸入參數doorsfieldsaddressoptionswindowscustomerorder_id必填propertyaccess_token必填

get_certificate_order

Pobierz zamówienie

Pełny stan zamówienia: zebrane wartości pól, dołączone dokumenty, cena, status i braki. Używaj, gdy musisz odczytać, co już zapisano; do samego postępu realizacji wystarczy get_certificate_order_status. Dane osobowe zwracamy tylko posiadaczowi access_token.

輸入參數order_id必填access_token必填

get_certificate_order_status

Status zamówienia

Skrócony status zamówienia — bez danych osobowych i bez wartości pól. Używaj do informowania użytkownika o postępie realizacji (płatność, przygotowanie świadectwa, wysyłka).

輸入參數order_id必填access_token必填

calculate_certificate_price

Oblicz cenę

Wiążąca cena wyliczona przez nasz backend. Podaj order_id + access_token dla ceny konkretnego zamówienia albo samo property_type dla wyceny orientacyjnej. NIGDY nie licz ceny samodzielnie i nie podawaj kwot z pamięci.

輸入參數optionsorder_idaccess_tokendiscount_codeproperty_type

create_document_upload_url

Przygotuj miejsce na dokument

Zwraca jednorazowy URL do wgrania pliku (metodą PUT) i file_id, którym potem dołączysz plik przez add_property_document. MCP nigdy nie pobiera plików z Internetu — bajty wysyła ten, kto je ma.

輸入參數mime必填filename必填order_id必填size_bytes必填access_token必填document_type必填

add_property_document

Dołącz dokument do zamówienia

Dołącza wgrany wcześniej plik do zamówienia. file_id musi pochodzić z create_document_upload_url dla TEGO zamówienia. Zdjęcie budynku (property_photo) jest potrzebne do wystawienia świadectwa, ale nie blokuje płatności — jeśli go nie dodasz, użytkownik doda je na stronie płatności albo dośle później na stronie zamówienia.

輸入參數file_id必填filenameorder_id必填access_token必填document_type必填

版本歷史

2
  1. v1.2.0最新Oct 10, 2026
  2. v1.1.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分