{"ok":true,"site":{"host":"haakanergun.github.io","url":"https://haakanergun.github.io/gridbrief-tr/","type":"live","desc":"GridBrief TR","tools":[{"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.","title":"Set analysis scope","annotations":{"readOnlyHint":false,"untrustedContentHint":false},"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Get market snapshot","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"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."}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Find market organizations and plants","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Compare electricity plan and actual","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"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."}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Stress-test position","annotations":{"readOnlyHint":false,"untrustedContentHint":true},"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Draft shift brief","annotations":{"readOnlyHint":false,"untrustedContentHint":true},"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."}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Search Transparency datasets","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"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"]}}}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]},{"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.","title":"Get Transparency dataset","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"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"]}}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/gridbrief-tr/","pages":["/gridbrief-tr/","/gridbrief-tr/tr/","/gridbrief-tr/en/"]}],"category":"Finance & Crypto","favicon":"/favicons/haakanergun.github.io.svg","apiSurface":"spec","toolCount":8}}