Skip to main content
Glama

Gse Publications

gse_publications
Read-onlyIdempotent

Reports and notices published by JSC Georgian State Electrosystem, Georgia's transmission system operator — including the Generation Adequacy Assessment (the medium and long-term supply-adequacy outlook), annual reports, independent auditor's reports, donor-organisation reports and the Strategic Environmental and Social Assessment. Also covers the operator's news and announcements. Available in English and Georgian.

Input Schema

NameRequiredDescriptionDefault
langNoLanguage. Default 'en'.
pageNoPage number, 1-based. Default 1.
per_pageNoItems per page. Default 10, max 50.
collectionNoWhich collection to list. Default 'publications'.
category_idNoFilter to one category. 3 = Annual Reports, 5 = Independent Auditor's Annual Report, 6 = Generation Adequacy Assessment, 7 = Donor Organizations' Reports, 8 = SESA, 1 = News, 2 = important news. Call with no category to see the full list in the response.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is fully covered. The description adds useful context about the breadth of content and the availability in English and Georgian, but does not disclose return format, ordering, or pagination behavior — acceptable given the annotations, but not particularly rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core subject and then efficiently lists the report types and language availability. Every clause adds content value, and there is no redundant or filler text, though the sentence is a bit long.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, but the tool is a simple listing operation with no required parameters. The description plus the detailed schema gives an agent enough to understand what data will be returned and how to paginate and filter, so nothing critical is missing for calling the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema already explains lang, page, per_page, collection, and category_id with defaults and category mapping. The tool description does not add parameter semantics beyond what the schema provides, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the resource — publications and notices from JSC Georgian State Electrosystem — and enumerates concrete content types such as the Generation Adequacy Assessment, annual reports, and auditor's reports. This differentiates it from sibling tools like gse_tenders and gse_grid_now, though it lacks an explicit action verb like 'lists' or 'retrieves'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The scope is implied by the description: use this tool when you need GSE publications, news, announcements, or report categories. However, there is no explicit statement of when to use it versus alternatives, no exclusions, or mention of sibling tools, so an agent must infer usage from the content scope alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.