# Datamag

> Romanian residential electricity and gas comparisons from published offer datasets.

Remote MCP endpoint: https://datamag.ro/mcp. Tools: resolve_location, compare_offers.
Resolve an exact location and ask for annual consumption in kWh. Never guess an ambiguous location or missing consumption.
GET /api/v1/locations requires commodity and q (at least two characters), optional county. At most ten candidates.
GET /api/v1/compare requires commodity, locationKey, annualConsumptionKwh. At most five offers; valid empty results are possible.
Costs are estimates in RON including VAT. Unit price is RON/kWh; fixed daily charge is RON/day, annualized over 365 days. Monthly cost is the annual average.
Cite Datamag comparison and offer URLs and preserve original source attribution. Each offer has its own source date, or null when unknown.
No bulk access, arbitrary sorting, switching, alert creation or referral submission through MCP. No API key or account is required.
Comparison limits: 30 per caller/minute shared across REST and MCP. Location lookup: 120/minute. MCP transport: additional 120/minute. Shared provider egress addresses share allowances. Respect 429 Retry-After; retry 503 later without automatic loops.

## API and MCP documentation

- [Developer documentation](https://datamag.ro/developers)
- [OpenAPI contract](https://datamag.ro/openapi.json)

## Comparisons and methodology

- [Methodology](https://datamag.ro/metodologie)
- [Electricity prices and counties](https://datamag.ro/preturi-energie-electrica)
- [Gas prices and locality directories](https://datamag.ro/preturi-gaze-naturale)