Energy Management

Corrently

Learn how to use Corrently with Composio

Overview

SLUG: CORRENTLY

Description

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.

Authentication Details

generic_api_key
stringRequired

Connecting to Corrently

Create an auth config

Use the dashboard to create an auth config for the Corrently toolkit. This allows you to connect multiple Corrently accounts to Composio for agents to use.

1

Select App

Navigate to Corrently.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Corrently Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4corrently_auth_config_id = "ac_YOUR_CORRENTLY_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Corrently for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, corrently_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Corrently toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["CORRENTLY"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: CO₂ Advisor

Description

Tool to get real-time carbon footprint insights per kilowatt-hour for a location. Use when you need current CO intensity forecasts before scheduling energy usage.

Action Parameters

lat
number
lon
number
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: CO₂ Meter Update

Description

Tool to create or update a CO₂ meter reading for emissions tracking. Use when sending new or updated electricity consumption readings to Corrently.

Action Parameters

source
stringRequired
time
integer
value
numberRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Geocode Location

Description

Tool to geocode a free-text location into coordinates. Use when you need latitude and longitude from a place name.

Action Parameters

q
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Energy Schedule Computation

Description

Tool to provide optimized operation schedules for energy-consuming devices. Use after collecting device energy requirements and location.

Action Parameters

coverageHours
integer
requirements
objectRequired
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: GrünstromIndex Forecast

Description

Tool to retrieve hourly green power forecast and CO2 data. Use after obtaining the user API key.

Action Parameters

key
stringRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: GSI Best Hour

Description

Tool to get the optimal hour for energy consumption based on green energy availability. Use when scheduling device operation in the upcoming timeframe.

Action Parameters

hours
integer
key
string
timeframe
integerDefaults to 24
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: GSI Dispatch Schedule

Description

Tool to retrieve renewable energy dispatch and mix for a German postal code. Use after confirming geographic location input.

Action Parameters

zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Electricity Market Data

Description

Tool to retrieve real-time and forecast electricity pricing data. Use when you need up-to-date market price data by German postal code.

Action Parameters

zip
stringRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: PHEV Navigator

Description

Tool to get PHEV charge-or-fuel recommendation. Use after determining location and SoC.

Action Parameters

fuel_efficiency
number
fuel_price
number
key
string
latitude
numberRequired
longitude
numberRequired
state_of_charge
integerRequired
zip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: PV Generation Forecast

Description

Tool to get solar energy production forecasts (hourly output and loss estimates) for a specific location. Use when you need hourly PV generation data to optimize energy scheduling.

Action Parameters

d
integerDefaults to 7
w
numberRequired
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Renewable Energy Dispatch

Description

Tool to get renewable energy flow and mix for a German ZIP code. Use when you need import/export and dispatch sources/destinations breakdown.

Action Parameters

token
string
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Electricity Generation Mix

Description

Tool to retrieve real-time electricity generation mix in Germany. Use when you need the current breakdown of generation by source.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Tariff Components

Description

Tool to fetch detailed energy tariff price components. Use when analyzing total cost based on annual consumption or a specific event.

Action Parameters

email
string
kwha
integer
milliseconds
integer
wh
integer
zip
string
zipcode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Standard Load Profile Tariff SLPH0

Description

Tool to retrieve standard load profile H0 tariff information. Use after providing a German postal code to get local SLPH0 tariffs.

Action Parameters

zipcode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Weather Forecast

Description

Tool to retrieve 7-day weather forecasts by geographic coordinates. Use when you need upcoming weather data.

Action Parameters

lat
number
lon
number

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: WiM Status

Description

Tool to retrieve WiM process status. Use after requesting TyDID status to verify if consent is granted or revoked.

Action Parameters

identity
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired