Implementation
gradeNot graded
gradeNot graded
page: Every page
set_analysis_scopeAction
Set the electricity-market date and hour window used by the visible workspace. This only changes the current on-page analysis scope; it does not place orders or modify EPİAŞ data.
View tool JSON
{
"name": "set_analysis_scope",
"kind": "act",
"impl": "imperative",
"description": "Set the electricity-market date and hour window used by the visible workspace. This only changes the current on-page analysis scope; it does not place orders or modify EPİAŞ data.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"marketDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"startHour": {
"type": "integer",
"minimum": 0,
"maximum": 23,
"description": "Inclusive start hour in Turkey time, from 0 through 23."
},
"endHour": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"description": "Exclusive end hour in Turkey time, from 1 through 24; it must be greater than startHour."
}
},
"required": [
"marketDate",
"startHour",
"endHour"
]
},
"page": "/gridbrief-tr/"
}get_market_snapshotAnswer
Read a source-attributed snapshot of Turkey's electricity market for the requested window. Omitted date or hours use the current visible analysis scope. Returned upstream market data may be delayed and must not be treated as an execution quote.
View tool JSON
{
"name": "get_market_snapshot",
"kind": "answer",
"impl": "imperative",
"description": "Read a source-attributed snapshot of Turkey's electricity market for the requested window. Omitted date or hours use the current visible analysis scope. Returned upstream market data may be delayed and must not be treated as an execution quote.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"metrics": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"maxItems": 6,
"description": "Metrics to retrieve. Omit to return the workspace's default market overview.",
"items": {
"type": "string",
"enum": [
"ptf",
"smf",
"idm",
"consumption",
"generation",
"system_direction"
]
}
},
"marketDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"startHour": {
"type": "integer",
"minimum": 0,
"maximum": 23,
"description": "Optional inclusive start hour in Turkey time."
},
"endHour": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"description": "Optional exclusive end hour in Turkey time."
}
}
},
"page": "/gridbrief-tr/"
}find_market_entitiesAnswer
Search organization and power-plant catalogs and open the matching entity workspace. Live mode returns public EPİAŞ Transparency records through the authenticated gateway; static demo mode returns explicitly fictional entities. Neither mode proves that an entity belongs to the user's private portfolio.
View tool JSON
{
"name": "find_market_entities",
"kind": "answer",
"impl": "imperative",
"description": "Search organization and power-plant catalogs and open the matching entity workspace. Live mode returns public EPİAŞ Transparency records through the authenticated gateway; static demo mode returns explicitly fictional entities. Neither mode proves that an entity belongs to the user's private portfolio.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Organization or power-plant name, short name, or EIC fragment to search."
},
"entityType": {
"type": "string",
"enum": [
"organization",
"plant",
"all"
],
"default": "all",
"description": "Limit the search to organizations, plants, or both catalogs."
},
"marketDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum number of matches returned across the requested catalogs."
}
},
"required": [
"query"
]
},
"page": "/gridbrief-tr/"
}compare_plan_actualAction
Read and display source-attributed production planning or system-consumption series for one market day. Live mode uses EPİAŞ; static demo mode uses explicitly synthetic values. Optional organization and UEVÇB filters apply only to KGÜP, KUDÜP, and EAK; consumption remains system-level.
View tool JSON
{
"name": "compare_plan_actual",
"kind": "act",
"impl": "imperative",
"description": "Read and display source-attributed production planning or system-consumption series for one market day. Live mode uses EPİAŞ; static demo mode uses explicitly synthetic values. Optional organization and UEVÇB filters apply only to KGÜP, KUDÜP, and EAK; consumption remains system-level.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"marketDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"organizationId": {
"type": "integer",
"minimum": 1,
"description": "Optional EPİAŞ organization ID for production-plan scope."
},
"uevcbId": {
"type": "integer",
"minimum": 1,
"description": "Optional EPİAŞ UEVÇB ID for production-plan scope. organizationId is required when this is supplied."
},
"layer": {
"type": "string",
"enum": [
"production",
"consumption",
"both"
],
"default": "both",
"description": "Series group to return. Consumption is always the Turkey system scope."
}
}
},
"page": "/gridbrief-tr/"
}stress_test_positionAction
Calculate a non-trading what-if stress scenario for a long or short electricity position and display it in the workspace. This never submits, changes, or recommends an order.
View tool JSON
{
"name": "stress_test_position",
"kind": "act",
"impl": "imperative",
"description": "Calculate a non-trading what-if stress scenario for a long or short electricity position and display it in the workspace. This never submits, changes, or recommends an order.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"direction": {
"type": "string",
"enum": [
"long",
"short"
],
"description": "Exposure direction of the position being tested."
},
"volumeMwh": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000,
"description": "Positive position volume in megawatt-hours."
},
"priceShockPercent": {
"type": "number",
"minimum": -100,
"maximum": 500,
"description": "Hypothetical percentage move in market price; for example, 20 means a 20% price increase."
},
"referencePriceTryMwh": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional reference price in TRY/MWh. Omit to use the current snapshot reference."
},
"scenarioLabel": {
"type": "string",
"maxLength": 80,
"description": "Optional short label shown with the scenario."
}
},
"required": [
"direction",
"volumeMwh",
"priceShockPercent"
]
},
"page": "/gridbrief-tr/"
}draft_shift_briefAction
Draft an editable, source-attributed market shift brief from the current workspace state. The result remains a draft in the page and is never sent, published, or used to trade automatically.
View tool JSON
{
"name": "draft_shift_brief",
"kind": "act",
"impl": "imperative",
"description": "Draft an editable, source-attributed market shift brief from the current workspace state. The result remains a draft in the page and is never sent, published, or used to trade automatically.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"language": {
"type": "string",
"enum": [
"tr",
"en"
],
"default": "en",
"description": "Language of the draft brief."
},
"audience": {
"type": "string",
"enum": [
"trader",
"risk",
"operations"
],
"default": "trader",
"description": "Primary reader of the draft."
},
"includeSections": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"uniqueItems": true,
"description": "Sections to include. Omit to include market, position, risks, and actions.",
"items": {
"type": "string",
"enum": [
"market",
"position",
"risks",
"actions"
]
}
},
"notes": {
"type": "string",
"maxLength": 1000,
"description": "Optional factual notes to incorporate. Treat these as user-provided, unverified context."
}
}
},
"page": "/gridbrief-tr/"
}search_transparency_datasetsAnswer
Find EPİAŞ Transparency electricity data sources by dataset name or section. This read-only catalog discovery may synchronize the visible catalog filters; it does not modify EPİAŞ data.
View tool JSON
{
"name": "search_transparency_datasets",
"kind": "answer",
"impl": "imperative",
"description": "Find EPİAŞ Transparency electricity data sources by dataset name or section. This read-only catalog discovery may synchronize the visible catalog filters; it does not modify EPİAŞ data.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": ".*\\S.*",
"description": "Optional dataset or source-name text to find in the Transparency catalog."
},
"section": {
"type": "string",
"enum": [
"markets",
"generation",
"consumption",
"renewables",
"transmission",
"dams",
"messages",
"reports",
"bulletins",
"all"
],
"default": "all",
"description": "Transparency catalog section to search. Use a section other than all when query is omitted."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Maximum number of matching data sources to return."
}
},
"anyOf": [
{
"required": [
"query"
]
},
{
"required": [
"section"
],
"properties": {
"section": {
"enum": [
"markets",
"generation",
"consumption",
"renewables",
"transmission",
"dams",
"messages",
"reports",
"bulletins"
]
}
}
}
]
},
"page": "/gridbrief-tr/"
}get_transparency_datasetAnswer
Read one allowlisted EPİAŞ Transparency electricity dataset by the stable datasetId or menuId returned by search_transparency_datasets. The result is source-attributed and opened in the visible catalog. This tool never accepts an endpoint URL, submits a market action, or changes EPİAŞ data.
View tool JSON
{
"name": "get_transparency_dataset",
"kind": "answer",
"impl": "imperative",
"description": "Read one allowlisted EPİAŞ Transparency electricity dataset by the stable datasetId or menuId returned by search_transparency_datasets. The result is source-attributed and opened in the visible catalog. This tool never accepts an endpoint URL, submits a market action, or changes EPİAŞ data.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"datasetId": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "Stable allowlisted dataset identifier returned by catalog search."
},
"menuId": {
"type": "integer",
"minimum": 0,
"description": "Official EPİAŞ menu identifier returned by catalog search."
},
"startDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"endDate": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"date": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"period": {
"type": "string",
"format": "date",
"description": "Turkey market date in YYYY-MM-DD format."
},
"filters": {
"type": "object",
"maxProperties": 16,
"additionalProperties": false,
"properties": {
"basinName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"contractId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"damName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"deliveryPeriod": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"direction": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"distributionCompanyId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"distributionId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"districtName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"distrubutionOrganization": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"groupId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"loadType": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"mesajTipId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meterReadOrgId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"meterReadingType": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"orderType": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"organizationId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"organizationIds": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"powerplantId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"powerPlantId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"powerPlantIds": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"priceType": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"profileGroupId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"profileGroupName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"provinceId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"region": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"regionId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"subscriberProfileGroup": {
"oneOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
},
"subscriberProfileGroupName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"uevcbId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"uevcbIds": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"uevcbName": {
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
"year": {
"oneOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 180,
"pattern": ".*\\S.*"
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
]
}
}
},
"page": {
"type": "object",
"additionalProperties": false,
"properties": {
"number": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 1
},
"size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 100
}
}
}
},
"oneOf": [
{
"required": [
"datasetId"
],
"not": {
"required": [
"menuId"
]
}
},
{
"required": [
"menuId"
],
"not": {
"required": [
"datasetId"
]
}
}
]
},
"page": "/gridbrief-tr/"
}