ORLEN eBOK MCP Server

myORLEN (formerly PGNiG) gas billing portal — invoices, meter readings, contracts, payments & notifications via Model Context Protocol

Connection

MCP Endpoint: https://orlen-ebok.mcp.majewscy.tech/mcp

Auth: x-api-key header required for tool calls

Online v1.0.0 18 tools

Available Tools

Account Overview

get_account_summary
Aggregated overview: user info, balance, supply points, unpaid invoices, recent notifications.
get_user_data
User profile: name, email, PESEL, marketing acceptances.
get_balance
Total outstanding balance across all contracts.

Supply Points & Contracts

get_supply_points
Gas supply points (PPG) with addresses, meter numbers, last readings, tariffs.
get_agreements
Gas contracts with IBAN, tariff, e-invoice status, collection points.
get_all_agreements
All agreements including additional services.
get_additional_agreements
Additional service agreements (insurance, legal, home assistant).

Invoices & Payments

get_invoices
Invoice list with amounts, dates, payment status, deadlines.
Optional: pageSize, paid (true/false)
get_invoice_details
Detailed invoice info including address, IBAN, PDF availability.
Required: invoiceNumber
get_payment_methods
Available payment methods for paying invoices.
get_refunds
Overpayment refund information (zwrot nadplaty).

Meter Readings

get_meter_readings
Historical meter reading dates for a supply point.
Optional: idPPG
submit_meter_reading
Submit a new gas meter reading (podaj odczyt).
Required: value. Optional: idPPG, date (YYYY-MM-DD)
validate_meter_reading
Validate a reading value before submitting.
Required: value. Optional: idPP
cancel_meter_reading
Cancel the last submitted meter reading.
Optional: idPPG

Notifications & Messages

get_notifications
Payment reminders, invoice alerts, reading reminders.
send_message
Send a message to myORLEN customer support.
Required: subject, content. Optional: agreementNumber
get_services_in_progress
Services currently being processed.

Configuration

Server-side credentials (set via environment variables):

ORLEN_EMAIL=your@email.com
ORLEN_PASSWORD=your_password

Claude Code / MCP client config:

{
  "mcpServers": {
    "orlen-ebok": {
      "type": "http",
      "url": "https://orlen-ebok.mcp.majewscy.tech/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Data Source

Connects to eBOK myORLEN (formerly PGNiG eBOK) — the online customer portal for ORLEN gas customers in Poland. Data is accessed via authenticated REST API. No official public API documentation available.

majewscy.tech MCP Infrastructure • Built for Personal Assistant