# tounify > Europe's unified energy tariff data API — one REST API for static, dynamic, and synthetic electricity pricing across European markets. tounify gives developers and B2B energy-tech teams instant access to verified, normalized European electricity tariff data. Stop scraping supplier websites; get clean JSON via a single authenticated API call. ## API Overview - **Endpoint base:** `https://api.tounify.io` - **Auth:** Bearer token in `Authorization` header - **Format:** JSON, REST - **Get a token:** register at https://cockpit.tounify.io/register — a testing token is issued immediately, no credit card and no sales call. - **Endpoint reference for agents:** https://api.tounify.io/llms.txt - **Machine-readable spec:** https://api.tounify.io/openapi/v2.json (OpenAPI 3, generated from the live controllers, so it cannot drift from the API) A tariff price is reached in three calls — pick a supplier, pick one of its tariffs, then ask for that tariff's prices: ``` GET /v2/DE/consumption/companies # -> company ids GET /v2/DE/consumption/{company}/tariffs # -> tariff ids GET /v2/DE/dayahead?consumption_tariff={tariff}&include=fees,vat ``` `{country}` is an ISO 3166-1 alpha-2 code (`DE`, not `GER`; `GB`, not `UK`) and `{sector}` is one of `consumption`, `feedin`, `grid`. ## Tariff Types - **Static Tariffs** — Fixed and time-of-use rates: day/night, peak/off-peak, and multi-period structures. - **Dynamic Tariffs** — Real-time exchange-linked prices: EPEX Spot and Nord Pool day-ahead data. - **Synthetic Tariffs** — Formula-based pricing decoded from supplier rules and regulatory frameworks. ## Coverage Coverage changes continuously, so no country list is baked into this file. `GET https://api.tounify.io/public/country-stats` needs no token and returns, per country, the number of companies and tariffs held for each direction, whether statutory fees are loaded, whether postal-code to network-operator resolution is available, and whether the network charge differs by address (`gridVariesByLocation`). The same figures are rendered live at https://tounify.io/#coverage. ## MCP Server The tounify MCP server lets an AI assistant answer questions about European electricity pricing and about integrating the tounify API — how a market builds its price, which parameters a request needs, how to read a response — from our reviewed market write-ups and live coverage figures instead of from its training data. - **Endpoint:** `https://mcp.tounify.io` (streamable HTTP) - It works with your tounify account: your assistant asks you to sign in once and approve the connection, and clients without a sign-in flow send one of your API tokens instead, as Authorization: Bearer exactly as on the REST API; a testing token works too. - Every account gets a free allowance of tool calls; the plans whose pricing card lists the MCP server include it without limit. - It explains, checks and plans, and never returns electricity prices — those come from the REST API. - One tool writes: it sends tounify a bug report or a feature wish when you ask your assistant to, and we answer by email. - On plans that include the regulatory change feed, one tool also states the regulatory figures behind each dated change, one component at a time. - Do not paste credentials or personal data into a question. - **Claude Code:** `claude mcp add --transport http tounify https://mcp.tounify.io` - **Other clients:** https://tounify.io/ai-assistance/ ## Use Cases - Smart EV charging (schedule charging during cheapest hours) - Home Energy Management Systems (HEMS) - EV fleet cost reimbursement & auditing - Energy management and monitoring apps - Price forecasting and analytics platforms ## Pricing All plans include full API access to every covered market. Prices ex-VAT. | Plan | EUR/month | Calls included | Extra call | |------------|-----------|----------------|------------| | STARTER | 89 | 1,000 | EUR 0.10 | | PRO | 349 | 145,000 | EUR 0.003 | | ENTERPRISE | 990 | 485,000 | EUR 0.002 | Custom plans available on request. ## Links - [Website](https://tounify.io) - [API Documentation](https://api.tounify.io) - [MCP server setup](https://tounify.io/ai-assistance/) - [Pricing](https://tounify.io/#pricing) - [Coverage Map](https://tounify.io/#coverage) - [Get API access (self-serve)](https://cockpit.tounify.io/register) - [Sales / custom plans](mailto:connect@tounify.io) - [Full details](https://tounify.io/llms-full.txt)