Corrently Energy MCP Server for Mastra AI 12 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Corrently Energy through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"corrently-energy": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Corrently Energy Agent",
instructions:
"You help users interact with Corrently Energy " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Corrently Energy?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Corrently Energy MCP Server
Connect to Corrently Energy APIs and bring real-time German energy market intelligence to any AI agent. Monitor renewable energy availability, optimize consumption schedules, and make data-driven decisions for sustainable power usage.
Mastra's agent abstraction provides a clean separation between LLM logic and Corrently Energy tool infrastructure. Connect 12 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- GrünstromIndex (GSI) — Get hourly forecasts for renewable energy availability, showing when green power from wind and solar is most abundant
- CO₂ Predictions — Track carbon intensity of electricity consumption by German zip code with real-time and forecasted emissions data
- Best Hour Finder — Automatically identify optimal time windows for energy-intensive activities based on renewable peaks and lowest CO₂
- Market Data — Access current electricity market prices, wholesale costs, and regional pricing forecasts
- Solar Forecasts — Predict photovoltaic generation output for specific solar installations based on location and capacity (kWp)
- Energy Scheduling — Create intelligent operating schedules for EVs, heat pumps, and industrial equipment optimized for price, solar, or emissions
- Merit Order — View the current energy generation mix showing which power plants are active and their cost efficiency
- Real-Time CO₂ Meter — Check instant carbon intensity readings (g CO₂/kWh) for any German location
- PHEV Decision Support — Get smart advice for plug-in hybrid drivers on whether to charge electrically or use fuel
- CO₂ Offset Calculator — Calculate compensation requirements and available options for neutralizing carbon footprints
- Renewable Dispatch — Monitor renewable energy feed-in data showing wind and solar contributions to the grid
- Stromkonto Balance — Check electricity account balances and green energy certificates
The Corrently Energy MCP Server exposes 12 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Corrently Energy to Mastra AI via MCP
Follow these steps to integrate the Corrently Energy MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 12 tools from Corrently Energy via MCP
Why Use Mastra AI with the Corrently Energy MCP Server
Mastra AI provides unique advantages when paired with Corrently Energy through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Corrently Energy without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Corrently Energy tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Corrently Energy + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Corrently Energy MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Corrently Energy, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Corrently Energy as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Corrently Energy on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Corrently Energy tools alongside other MCP servers
Corrently Energy MCP Tools for Mastra AI (12)
These 12 tools become available when you connect Corrently Energy to Mastra AI via MCP:
calculate_co2_offset
Helps users understand how to neutralize their carbon footprint. USE WHEN: - User asks how to offset their CO₂ emissions - User wants to calculate carbon compensation needed - User needs information about CO₂ compensation options - User asks about neutralizing their carbon footprint from activities PARAMETERS: - co2_kg (REQUIRED): Amount of CO₂ in kilograms to offset (minimum: 0.1) - activity_type (OPTIONAL): Type of activity that generated emissions (e.g. "flight", "car", "heating") EXAMPLES: - "How much does it cost to offset 500 kg of CO₂?" → call with co2_kg=500 - "Calculate offset for my flight emissions" → call with co2_kg=250, activity_type="flight" - "I drove 1000km, what is the CO₂ compensation?" → call with co2_kg=180, activity_type="car" Calculate CO₂ offset requirements and available compensation options
create_energy_schedule
Schedules are optimized based on electricity prices, solar generation peaks, CO₂ emissions, or comfort levels. USE WHEN: - User wants to create an automated schedule for energy devices - User needs to optimize when to run appliances for cost or green energy - User asks to schedule energy consumption for the next hours - User wants smart scheduling for their heat pump, EV charger, or machinery PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits - hours (REQUIRED): Number of hours for the schedule operation (1-36 hours) - optMode (OPTIONAL): Optimization mode - "price" (cheapest), "solar" (max solar), "emission" (lowest CO₂), "comfort" (balanced). Default: "price" EXAMPLES: - "Create a 12-hour schedule for Berlin 10115 optimized for lowest price" → call with zip="10115", hours=12, optMode="price" - "Schedule my EV charging for next 8 hours in Munich using solar energy" → call with zip="80331", hours=8, optMode="solar" - "Optimize my heat pump for 24 hours with lowest emissions in Hamburg" → call with zip="20095", hours=24, optMode="emission" Create an optimized energy schedule for appliances and devices
get_best_hour
Perfect for scheduling energy-intensive activities. USE WHEN: - User asks when is the best time to use energy-intensive appliances - User wants to optimize energy consumption for green power or low emissions - User needs to schedule operations during clean energy peaks - User asks about optimal charging times for EVs or running machinery PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits - hours (OPTIONAL): Number of consecutive hours needed (default: 1, min: 1, max: 168) EXAMPLES: - "When is the best 3-hour window to run my dishwasher in Berlin 10115?" → call with zip="10115", hours=3 - "Best time to charge my EV in Munich tonight" → call with zip="80331", hours=6 - "When should I use high-power appliances today?" → call with zip="70173", hours=2 Find the best hours for energy consumption based on renewable availability and low CO₂ emissions
get_co2_meter
Shows grams of CO₂ per kWh right now. USE WHEN: - User asks about current/real-time CO₂ levels in the electricity grid - User wants instant carbon intensity data - User needs to know how clean/dirty the electricity is right now - User asks about live carbon emissions from power PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits EXAMPLES: - "What is the current CO₂ intensity in Berlin 10115?" → call with zip="10115" - "Show me real-time carbon levels for Munich 80331" → call with zip="80331" - "Current CO₂ emissions from electricity in Cologne" → call with zip="50667" Get real-time CO₂ meter readings for a German zip code
get_co2_prediction
Shows how carbon-intensive the power grid will be over time. USE WHEN: - User asks about CO₂ emissions or carbon footprint of electricity - User wants to know when electricity is cleanest/lowest emissions - User needs carbon intensity data for a location PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits EXAMPLES: - "What are the CO₂ emissions for Hamburg 20095?" → call with zip="20095" - "Show carbon intensity for Frankfurt 60311" → call with zip="60311" Get CO₂ emissions forecast for electricity consumption in Germany
get_dispatch
Shows how much renewable energy is being fed into the grid and its composition. USE WHEN: - User asks about renewable energy feed-in for a location - User needs dispatch data for renewable energy sources - User wants to understand the renewable energy flow in their area - User asks about wind and solar contribution to the grid PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits EXAMPLES: - "Show renewable energy dispatch for Berlin 10115" → call with zip="10115" - "How much renewable energy is being fed into the grid in Munich?" → call with zip="80331" - "Wind and solar dispatch for Hamburg 20095" → call with zip="20095" Get renewable energy dispatch information for a German zip code
get_gsi_prediction
USE WHEN: - User asks about green energy availability or renewable power forecast - User wants to know the GrünstromIndex or GSI for a location - User needs to understand when clean energy is most abundant PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits, e.g. "10115" for Berlin - token (OPTIONAL): API token for higher rate limits - auto-provided from credentials EXAMPLES: - "What is the renewable energy forecast for Berlin 10115?" → call with zip="10115" - "Show me the green power index for Munich 80331" → call with zip="80331" Get GrünstromIndex (Green Power Index) prediction for a German zip code
get_market_data
Includes wholesale prices and regional cost data. USE WHEN: - User asks about electricity prices or costs in a specific location - User needs market data, wholesale prices, or energy cost forecasts - User wants to compare energy costs across time periods - User asks about cheap/expensive electricity hours PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits EXAMPLES: - "What are current electricity prices in Berlin 10115?" → call with zip="10115" - "Show me energy market data for Cologne 50667" → call with zip="50667" - "When is electricity cheapest today in Stuttgart 70173?" → call with zip="70173" Get current electricity market data and pricing information for a German location
get_merit_order_list
This shows which energy sources are being used to generate electricity and their cost efficiency. USE WHEN: - User asks about the current energy generation mix - User wants to understand which power plants are active - User needs merit order data for market analysis - User asks about energy source prioritization in the grid EXAMPLES: - "Show me the current merit order list" → call with no extra params - "What energy sources are currently generating power?" → call with no extra params - "Merit order ranking for Germany" → call with no extra params Get the current merit order list for the German energy market
get_phev_charge_or_fuel
USE WHEN: - User asks whether to charge their PHEV or use fuel - PHEV driver needs advice on optimal energy source - User wants to know if now is a good time to charge their hybrid - User asks about cost-efficiency of electric vs fuel for their PHEV PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits EXAMPLES: - "Should I charge my PHEV or use fuel in Berlin 10115?" → call with zip="10115" - "Charge or fuel decision for Munich 80331" → call with zip="80331" - "Is now a good time to charge my hybrid in Hamburg?" → call with zip="20095" Get decision support for plug-in hybrid (PHEV) drivers - charge or fuel
get_solar_prediction
Shows expected energy production over time. USE WHEN: - User asks about solar panel output or PV system generation - User needs forecasts for their solar installation - User wants to know expected renewable energy production - User asks how much energy their solar panels will generate PARAMETERS: - zip (REQUIRED): German zip code (Postleitzahl) - exactly 5 digits - kwp (REQUIRED): Solar panel capacity in kilowatt peak (kWp), range: 0.1 to 1000 EXAMPLES: - "How much energy will my 5 kWp solar system generate in Berlin 10115?" → call with zip="10115", kwp=5 - "Solar forecast for my 10 kWp installation in Munich 80331" → call with zip="80331", kwp=10 - "Expected PV output for 3.5 kWp in Hamburg 20095" → call with zip="20095", kwp=3.5 Get solar energy generation forecast for a photovoltaic installation
get_stromkonto_balance
Shows credits, green energy certificates, and account status. USE WHEN: - User asks about their electricity account balance - User wants to check their Stromkonto status - User needs information about their green energy credits or certificates - User asks about their energy account PARAMETERS: - account (REQUIRED): Account identifier for the Stromkonto EXAMPLES: - "Check my Stromkonto balance for account 0x123abc" → call with account="0x123abc" - "Show my energy account status" → call with account="USER_ACCOUNT_ID" Get Stromkonto (electricity account) balance information
Example Prompts for Corrently Energy in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Corrently Energy immediately.
"What is the renewable energy forecast for Berlin zip code 10115 today?"
"When is the best 4-hour window to run my dishwasher in Munich 80331 to use the greenest energy?"
"Show me current electricity market prices for Hamburg 20095 and tell me when it's cheapest today."
Troubleshooting Corrently Energy MCP Server with Mastra AI
Common issues when connecting Corrently Energy to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpCorrently Energy + Mastra AI FAQ
Common questions about integrating Corrently Energy MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect Corrently Energy with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Corrently Energy to Mastra AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.