Świadectwo Energetyczne 24

pl.swiadectwo-energetyczne24Published by swiadectwo-energetyczne24.plOfficial publisherv1.2.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant answer questions about Polish energy performance certificates, collect property data into an order, attach documents and hand over a payment链接

What you can do
Look up the offer: property types, base prices, add-ons, document types and allowed values for heating, hot water, ventilation, windows and doors, plus service facts, process, lead times, legal basis and FAQ.
When to use it
Use it when someone in Poland needs a świadectwo charakterystyki energetycznej and wants to check prices and requirements, prepare the order data step by step, or get a payment link. It is not a general-purpose tool.
Requirements
Either the remote Streamable HTTP endpoint (no token needed) or the npm package run with Node.js 20 or newer via npx. The public endpoint is rate limited to 60 requests per 10 minutes per IP. Optional variables SE24_MCP_URL and SE24_MCP_TOKEN exist for a different or protected endpoint.
Before you install
The assistant creates and updates real orders and returns a payment link; payment and legal consents are completed by the person on the website, and the server never takes card data. The access_token returned at order creation is the only key to that order, so it must be kept and passed to later calls. Personal data is returned only to the token holder, and uploaded files go to the provider's service. Form values and messages are in Polish.

Installation

In SourceWeft

  1. Open Świadectwo Energetyczne 24 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/pl.swiadectwo-energetyczne24%2Fzamowienia/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: README.md at commit 06185cd

Tools

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ą.

Parametersproperty_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.

Parameterstopics

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.

Parametersdoorsfieldsaddressoptionswindowscustomerpropertyproperty_typerequiredidempotency_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.

Parametersorder_idrequiredaccess_tokenrequired

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.

Parametersdoorsfieldsaddressoptionswindowscustomerorder_idrequiredpropertyaccess_tokenrequired

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.

Parametersorder_idrequiredaccess_tokenrequired

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).

Parametersorder_idrequiredaccess_tokenrequired

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.

Parametersoptionsorder_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.

Parametersmimerequiredfilenamerequiredorder_idrequiredsize_bytesrequiredaccess_tokenrequireddocument_typerequired

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.

Parametersfile_idrequiredfilenameorder_idrequiredaccess_tokenrequireddocument_typerequired

Version history

2
  1. v1.2.0LatestOct 10, 2026
  2. v1.1.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts