Skip to main content
Glama

List upcoming events

list_events
Read-onlyIdempotent

List upcoming and ongoing public events organised by NGOs, student clubs and institutions on hangel, optionally filtered by keyword, city or online-only. Each event has a status and its dates in Istanbul time (UTC+3); events that already ended are not returned.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "list_events"
  }
}

Input Schema

NameRequiredDescriptionDefault
cityNoCity name.
sortNo"startDate": soonest first (default); "name": alphabetical.startDate
limitNoMaximum number of results in this page (default 20, at most 50).
queryNoMatched against name, organiser, type, tags and description. Turkish or English, or German, Spanish, French, Arabic, Russian, Persian, Azerbaijani, Hungarian, Hausa or Danish.
cursorNonextCursor from the previous call of this tool, to get the next page. Other arguments can be omitted; if given, they must match that call.
onlineNotrue: online events only.

Output Schema

NameRequiredDescriptionDefault
asOfYesTime the statuses and dates were evaluated (ISO 8601).
sortYesSort order used.
queryNoPresent when a query was given.
totalYesNumber of matching records (all pages).
eventsYes
offsetYesPosition of the first record of this page in the full result.
hasMoreYestrue when more records follow; call again with nextCursor.
returnedYesNumber of records in this page.
timeZoneYes
nextCursorYesOpaque cursor for the next page, or null on the last page.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / events / items / properties / endDate / description
      Previous value: -"End, local Turkiye time; empty when not given."New value: +"End, Istanbul time (UTC+3); empty when not given."
    • changedOutput schema / properties / events / items / properties / startDate / description
      Previous value: -"Start, local Turkiye time (YYYY-MM-DD or YYYY-MM-DD HH:mm)."New value: +"Start, Istanbul time, UTC+3 (YYYY-MM-DD or YYYY-MM-DD HH:mm)."
  2. Changed5 schema fields changed
    • addedInput schema / properties / cursor
      Added value: +{
      +  "description": "nextCursor from the previous call of this tool, to get the next page. Other arguments can be omitted; if given, they must match that call.",
      +  "maxLength": 2000,
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of results (default 20, at most 50)."New value: +"Maximum number of results in this page (default 20, at most 50)."
    • changedInput schema / properties / query / description
      Previous value: -"Matched against name, organiser, type, tags and description. Turkish or English."New value: +"Matched against name, organiser, type, tags and description. Turkish or English, or German, Spanish, French, Arabic, Russian, Persian, Azerbaijani, Hungarian, Hausa or Danish."
    • addedInput schema / properties / sort
      Added value: +{
      +  "default": "startDate",
      +  "description": "\"startDate\": soonest first (default); \"name\": alphabetical.",
      +  "enum": [
      +    "startDate",
      +    "name"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "asOf": {
      +      "description": "Time the statuses and dates were evaluated (ISO 8601).",
      +      "type": "string"
      +    },
      +    "events": {
      +      "items": {
      +        "properties": {
      +          "capacity": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "category": {
      +            "type": "string"
      +          },
      +          "city": {
      +            "type": "string"
      +          },
      +          "contentLanguage": {
      +            "description": "BCP 47 code of the language the text fields are written in, as stored on hangel (for example \"tr\" or \"en\"); \"und\" when it cannot be determined. Texts are not machine-translated unless \"translated\" is true.",
      +            "type": "string"
      +          },
      +          "description": {
      +            "description": "Up to 400 characters.",
      +            "type": "string"
      +          },
      +          "district": {
      +            "type": "string"
      +          },
      +          "endDate": {
      +            "description": "End, local Turkiye time; empty when not given.",
      +            "type": "string"
      +          },
      +          "format": {
      +            "description": "Online, in person or hybrid, as entered by the organiser.",
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "isFree": {
      +            "type": "boolean"
      +          },
      +          "language": {
      +            "description": "Language the event is held in, as entered by the organiser.",
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "organizer": {
      +            "type": "string"
      +          },
      +          "participation": {
      +            "type": "string"
      +          },
      +          "paymentHandledBy": {
      +            "type": "string"
      +          },
      +          "paymentUrl": {
      +            "description": "Payment page of the organiser (hangel does not take payments); empty when free.",
      +            "type": "string"
      +          },
      +          "price": {
      +            "description": "Ticket price when the event is paid.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "priceCurrency": {
      +            "type": "string"
      +          },
      +          "priceNote": {
      +            "type": "string"
      +          },
      +          "providesCertificate": {
      +            "type": "boolean"
      +          },
      +          "startDate": {
      +            "description": "Start, local Turkiye time (YYYY-MM-DD or YYYY-MM-DD HH:mm).",
      +            "type": "string"
      +          },
      +          "status": {
      +            "description": "Computed at asOf in Europe/Istanbul time. Ended events are not returned.",
      +            "enum": [
      +              "upcoming",
      +              "ongoing",
      +              "date_unconfirmed"
      +            ],
      +            "type": "string"
      +          },
      +          "tags": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "translated": {
      +            "description": "true only when the name and summary were replaced by a translation stored on hangel; the original language is then in originalLanguage.",
      +            "type": "boolean"
      +          },
      +          "url": {
      +            "description": "Public page of the record on hangel.org.",
      +            "type": "string"
      +          },
      +          "vatIncluded": {
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "id",
      +          "name",
      +          "status",
      +          "startDate",
      +          "endDate",
      +          "isFree",
      +          "url",
      +          "contentLanguage",
      +          "translated"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "hasMore": {
      +      "description": "true when more records follow; call again with nextCursor.",
      +      "type": "boolean"
      +    },
      +    "nextCursor": {
      +      "description": "Opaque cursor for the next page, or null on the last page.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "offset": {
      +      "description": "Position of the first record of this page in the full result.",
      +      "type": "integer"
      +    },
      +    "query": {
      +      "description": "Present when a query was given.",
      +      "properties": {
      +        "expansion": {
      +          "description": "Query terms that were matched across languages through the hangel multilingual dictionary, and the forms searched in the content.",
      +          "items": {
      +            "properties": {
      +              "concepts": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "searchedAs": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "term": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "term",
      +              "concepts",
      +              "searchedAs"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "normalized": {
      +          "description": "The query after case, accent and punctuation normalisation (the raw query is not echoed).",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "normalized",
      +        "expansion"
      +      ],
      +      "type": "object"
      +    },
      +    "returned": {
      +      "description": "Number of records in this page.",
      +      "type": "integer"
      +    },
      +    "sort": {
      +      "description": "Sort order used.",
      +      "type": "string"
      +    },
      +    "timeZone": {
      +      "type": "string"
      +    },
      +    "total": {
      +      "description": "Number of matching records (all pages).",
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "total",
      +    "offset",
      +    "returned",
      +    "hasMore",
      +    "nextCursor",
      +    "sort",
      +    "events",
      +    "asOf",
      +    "timeZone"
      +  ],
      +  "type": "object"
      +}
  3. Changed4 schema fields changed
    • addedInput schema / properties / city / description
      Added value: +"City name."
    • changedInput schema / properties / limit / description
      Previous value: -"En çok sonuç sayısı (varsayılan 20)."New value: +"Maximum number of results (default 20, at most 50)."
    • changedInput schema / properties / online / description
      Previous value: -"true: yalnız online etkinlikler."New value: +"true: online events only."
    • addedInput schema / properties / query / description
      Added value: +"Matched against name, organiser, type, tags and description. Turkish or English."
  4. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive, not open-world), so the description's job is to add semantics — and it does: events carry a status, dates are rendered in Istanbul time (UTC+3), and past events are excluded from results. It does not say what the status values are or how a page relates to the whole result set, but the platform-specific timezone and exclusion rules are genuinely useful additions.

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?

Two dense sentences, front-loaded with the core action and scope, then the timezone/exclusion caveat. Nothing is filler, though the parenthetical '(UTC+3)' and the organizer enumeration are slightly heavier than strictly necessary.

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?

An output schema exists, so return-shape explanation is correctly omitted. For a six-parameter, paginated, open-ended listing tool the description covers scope, timezone semantics and the ended-event exclusion, leaving only the status enumeration and paging-over-changing-data caveat unstated.

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 coverage is 100%, so all six parameters are already documented, including the enum on sort and the cursor contract. The description restates three filters (keyword, city, online-only) and adds no format or edge-case detail beyond them, so it sits at the baseline for a fully-described schema.

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?

Names a specific verb and resource ('List upcoming and ongoing public events') plus the source of those events (NGOs, student clubs, institutions on hangel). That is enough to separate it from siblings like list_open_funds, list_stores or list_volunteering, but it never explicitly contrasts itself with any of them.

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?

Usage is implied by the domain ('upcoming events') and by the statement that ended events are not returned, which quietly tells the agent this is not an archive/history lookup. There is no explicit when-to-use versus alternative, and no guidance on cursor-based paging versus filtering in a new call.

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.

Resources