# Corrently — how to use (mcp.ai)

Connect your Corrently account and use 23 tools for analytics straight from your AI agent. Connect with your own API key. Corrently provides a suite of APIs offering real-time and forecasted data on renewable energy availability, CO₂ emissions, and electricity pricing, enabling users to optimize energy consumption and reduce carbon footprints.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_corrently?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `corrently_co2_meter_update_reading`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/corrently`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/corrently/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/corrently/co2/meter/update/reading` — Tool to create or update a CO₂ meter reading for emissions tracking. Use when sending new or updated electricity consumption readings to Corrently.
  - body: { zip: string, time?: integer, value: number, source: string }
- `POST https://api.mcp.ai/api/corrently/commit/quittung` — Tool to finalize a Strom-Quittung (electricity receipt) after collecting transaction data. Use after gathering seller, buyer, and transaction details to create the final receipt.
  - body: { account?: string, tx_energy: number, tx_number: string, buyer_name: string, seller_name: string, tx_duration: number, seller_email: string, seller_zipcode: string, seller_yrconsumption: number }
- `POST https://api.mcp.ai/api/corrently/geocode/location` — Tool to geocode a free-text location into coordinates. Use when you need latitude and longitude from a place name.
  - body: { q: string }
- `POST https://api.mcp.ai/api/corrently/get/energy/schedule` — Create an optimized operation schedule for energy-consuming devices based on the GrünstromIndex (Green Power Index). This tool determines the best time slots to run energy-intensive devices (heat pump
  - body: { zip: string, requirements: object, coverageHours?: integer }
- `POST https://api.mcp.ai/api/corrently/get/metering/reading` — Tool to retrieve metered electricity reading with green/grey energy split and CO2 emissions data. Use when you need to check current meter readings or analyze energy consumption patterns for a Stromko
  - body: { account: string }
- `POST https://api.mcp.ai/api/corrently/get/stromkonto/balances` — Retrieve Stromkonto account balances from the energy blockchain ledger. Stromkonto is a ledger for green energy related transactions backed by Energychain blockchain to provide consensus of balances a
  - body: { account?: string }
- `POST https://api.mcp.ai/api/corrently/get/stromkonto/choices` — Tool to get selectable contract choices for a Stromkonto customer. Use when you need to retrieve available balance and transaction options for an account.
  - body: { account: string }
- `POST https://api.mcp.ai/api/corrently/get/wim/process/status` — Retrieve status information for WiM (Wechselprozesse im Messwesen) metering change processes. WiM processes handle meter changes and allocation workflows in the German electricity system. Use this too
  - body: { vid?: string }
- `POST https://api.mcp.ai/api/corrently/grunstrom/index/forecast` — Tool to retrieve hourly green power forecast and CO2 data. Use after obtaining the user API key.
  - body: { key: string, zip: string }
- `POST https://api.mcp.ai/api/corrently/gsi/best/hour` — Determines if now is the best time to turn on a device based on regional green energy (GrünstromIndex) forecasts in Germany. Returns true if the current hour has high renewable energy availability wit
  - body: { key?: string, zip: string, hours?: integer, timeframe?: integer }
- `POST https://api.mcp.ai/api/corrently/login/stromkonto` — Tool to initiate login to Stromkonto via email. Use when authenticating a user with their email address.
  - body: { email: string }
- `POST https://api.mcp.ai/api/corrently/market/data` — Retrieve real-time and forecast electricity pricing data for Germany by postal code (Postleitzahl). Returns wholesale market prices (EUR/MWh) and localized prices for specific grid areas. Data is prov
  - body: { zip: string }
- `POST https://api.mcp.ai/api/corrently/phev/navigator` — Tool to get PHEV charge-or-fuel recommendation for German locations. Compares real-time fuel prices at nearby stations with electricity costs to recommend whether charging or fueling is more economica
  - body: { key?: string, soc?: integer, zip: string, fuel_consumption?: number, power_consumption?: number }
- `POST https://api.mcp.ai/api/corrently/post/metering/reading` — Tool to post a meter reading and get it decorated with green/grey energy split. Use when you need to split consumption readings into green power (1.8.1) and grey power (1.8.2) according to the local G
  - body: { zip?: string, energy?: integer, secret?: string, account?: string }
- `POST https://api.mcp.ai/api/corrently/prepare/receipt/data` — Tool to collect data for a receipt before finalizing. During the first call, an account parameter will be returned. Use this when you need to incrementally build receipt data through multiple requests
  - body: { account?: string }
- `POST https://api.mcp.ai/api/corrently/pv/generation/get/forecast` — Get hourly solar PV generation forecasts for a German location. Returns predicted energy output in watt-hours (Wh) for each hour over the specified forecast period. Use this tool when you need to opti
  - body: { d?: integer, w: number, zip: string }
- `POST https://api.mcp.ai/api/corrently/register/stromkonto` — Tool to register a new Stromkonto energy account in the Corrently system. Use when creating a new account with email, name, and location details. All balances are initialized to zero upon registration
  - body: { email: string, zipcode: string, last_name: string, first_name: string }
- `POST https://api.mcp.ai/api/corrently/renewable/energy/dispatch` — Tool to get renewable energy flow and mix for a German ZIP code. Use when you need import/export and dispatch sources/destinations breakdown.
  - body: { zip: string, token?: string }
- `POST https://api.mcp.ai/api/corrently/strommix` — Tool to retrieve real-time electricity generation mix in Germany. Use when you need the current breakdown of generation by source.
- `POST https://api.mcp.ai/api/corrently/tariff/components` — Retrieve detailed German electricity tariff cost breakdown by postal code. Returns comprehensive cost components including: - Grundgebühr (base monthly fee) - Arbeitspreis (energy price per kWh) - Net
  - body: { wh?: integer, kwha?: integer, email: string, zipcode: string, milliseconds?: integer }
- `POST https://api.mcp.ai/api/corrently/tariff/slph0` — Tool to retrieve standard load profile H0 tariff information. Use after providing a German postal code to get local SLPH0 tariffs.
  - body: { zipcode?: string }
- `POST https://api.mcp.ai/api/corrently/weather/forecast` — Tool to retrieve hourly weather forecasts (wind speed and UV index) by geographic coordinates. Use when you need wind and UV data for a specific location. Returns up to 5 days of hourly forecasts.
  - body: { lat: number, lon: number }
- `POST https://api.mcp.ai/api/corrently/wim/status` — Check TyDID consent/grant status for an SSI (Self-Sovereign Identity). This tool queries the Corrently TyDID API to verify whether a given Ethereum-based identity has granted consent or if the consent
  - body: { identity: string }

## Example prompts
- "What can I do in Corrently?"
- "Show me a summary of my Corrently account"

## More
- Page: https://mcp.ai/corrently
- Agent spec (llms.txt): https://mcp.ai/corrently/llms.txt
- Postman collection: https://mcp.ai/corrently/postman.json