MCP Server¶

eptr2 includes a Model Context Protocol (MCP) server that enables AI assistants like Claude to directly query Turkish electricity market data.

What is MCP?¶

The Model Context Protocol (MCP) is a standard for connecting AI assistants to external data sources and tools. With eptr2's MCP server, AI assistants can:

Query real-time electricity prices
Fetch consumption and generation data
Access all 213+ API endpoints
Perform complex market analysis

Quick Start¶

Installation¶

Install eptr2 with MCP support:

pip install "eptr2[allextras]"

Running the Server¶

From command line:

eptr2-mcp-server

Or programmatically:

from eptr2.mcp import run_mcp_server
import asyncio

asyncio.run(run_mcp_server(use_dotenv=True, recycle_tgt=True))

Configuration¶

Environment Variables¶

Create a .env file with your credentials:

EPTR_USERNAME=your.email@example.com
EPTR_PASSWORD=yourpassword

Server Options¶

from eptr2.mcp import run_mcp_server
import asyncio

asyncio.run(run_mcp_server(
    use_dotenv=True,       # Load credentials from .env
    recycle_tgt=True,      # Reuse authentication tickets
    dotenv_path=".env",    # Path to .env file
))

Available MCP Tools¶

The MCP server exposes the following tools:

Price Tools¶

Tool	Description
`get_market_clearing_price`	Day-ahead market prices (MCP/PTF)
`get_system_marginal_price`	System marginal prices (SMP/SMF)
`get_imbalance_price`	Positive and negative imbalance prices

Consumption Tools¶

Tool	Description
`get_real_time_consumption`	Real-time consumption data
`get_demand_forecast`	Load plan forecasts

Generation Tools¶

Tool	Description
`get_real_time_generation`	Generation by resource type

Composite Tools¶

Tool	Description
`get_hourly_consumption_and_forecast`	Combined consumption and forecast data
`get_price_and_cost_data`	Comprehensive price and cost data

Discovery Tools¶

Tool	Description
`get_available_eptr2_calls`	List all 213+ API endpoints
`call_eptr2_api`	Call any API endpoint by key

Example Queries¶

Once connected to Claude or another MCP-compatible assistant, you can ask:

"What are today's electricity prices in Turkey?"
"Show me the real-time generation by fuel type"
"Compare MCP and SMP for the last week"
"What was the peak consumption yesterday?"

Integration Methods¶

1. Claude Desktop¶

See Claude Desktop Setup for detailed instructions.

2. VS Code with Copilot¶

Enable MCP in VS Code settings:

{
  "chat.mcp.discovery.enabled": true
}

Configure MCP server in mcp-config.json

3. Custom Integration¶

Use the MCP client library:

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    server_params = StdioServerParameters(
        command="eptr2-mcp-server"
    )

    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # List available tools
            tools = await session.list_tools()
            print(tools)

            # Call a tool
            result = await session.call_tool(
                "get_market_clearing_price",
                {"start_date": "2024-07-29", "end_date": "2024-07-29"}
            )
            print(result)

asyncio.run(main())

Debugging¶

Check Server Status¶

# Run with verbose output
EPTR_USERNAME=... EPTR_PASSWORD=... eptr2-mcp-server --verbose

Test Connection¶

from eptr2.mcp.server import create_mcp_server

server = create_mcp_server(use_dotenv=True)
print(f"Server created: {server}")