Swiadectwo Energetyczne24 MCP Server

swiadectwo-energetyczne24-mcp

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:

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

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

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

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

Tools

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

Development

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:

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.