Skip to main content
Glama

Get Event

get-event
Read-onlyIdempotent

One published event: description, ticket types with prices and whether each is sold out, what the registration form asks, and how people get in (entry.url and Spanish entry.instructions to relay).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "slug": "<slug>"
    },
    "name": "get-event"
  }
}

Input Schema

NameRequiredDescriptionDefault
slugYesThe event slug, from search-events or the event URL (/e/{slug}).

Output Schema

NameRequiredDescriptionDefault
urlNoPublic event page.
slugNoIdentifies the event in get-event and get-checkout-link.
toneNoLight or dark, as the page renders.
endedNoTrue when the event is over.
entryNoHow people get in.
imageNoImage to show with the event.
themeNoLook of the event page.
titleNoEvent name.
venueNoPlace or city.
ends_atNoEnd, ISO 8601 with offset.
presaleNoFollowers-only presale that is open now, else null.
summaryNoFirst 200 characters of the description, plain text. Null when the event has none.
timezoneNoIANA timezone of the event, e.g. America/Guatemala.
organizerNoWho runs the event. Null when the organizer has no public profile.
questionsNoWhat the registration or checkout form asks each attendee.
remainingNoPlaces left. Present only when the organizer shows it.
starts_atNoStart, ISO 8601 with offset.
price_fromNoLowest price now; 0.00 for free registration. Null when entry is closed.
theme_toneNoTone the organizer chose: auto, light or dark.
title_fontNoTitle font of the event page.
descriptionNoFull description as the organizer wrote it; may contain HTML.
ticket_typesNoPaid categories. Empty for free registration.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "description": {
      +      "description": "Full description as the organizer wrote it; may contain HTML.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "ended": {
      +      "description": "True when the event is over.",
      +      "type": "boolean"
      +    },
      +    "ends_at": {
      +      "description": "End, ISO 8601 with offset.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "entry": {
      +      "description": "How people get in.",
      +      "properties": {
      +        "instructions": {
      +          "description": "How to get in, in Spanish. Relay it to the person.",
      +          "type": "string"
      +        },
      +        "methods": {
      +          "description": "Ways to pay that are open now: card, transfer. Empty for free registration.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "mode": {
      +          "description": "free (register at no cost), paid (buy a ticket) or closed (the organizer has not opened entry yet).",
      +          "type": "string"
      +        },
      +        "open": {
      +          "description": "Whether people can register or buy right now.",
      +          "type": "boolean"
      +        },
      +        "paused": {
      +          "description": "True when the organizer paused sales for now.",
      +          "type": "boolean"
      +        },
      +        "url": {
      +          "description": "Where the person starts: checkout for an open paid event, otherwise the event page.",
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "image": {
      +      "description": "Image to show with the event.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "organizer": {
      +      "description": "Who runs the event. Null when the organizer has no public profile.",
      +      "properties": {
      +        "name": {
      +          "description": "Organizer name.",
      +          "type": "string"
      +        },
      +        "url": {
      +          "description": "Organizer public profile.",
      +          "type": "string"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "presale": {
      +      "description": "Followers-only presale that is open now, else null.",
      +      "properties": {
      +        "ends_at": {
      +          "description": "When the presale ends, ISO 8601 with offset.",
      +          "type": "string"
      +        },
      +        "follow_unlocks": {
      +          "description": "True when following the organizer now gives access.",
      +          "type": "boolean"
      +        },
      +        "instructions": {
      +          "description": "Presale rule in Spanish. Relay it to the person.",
      +          "type": "string"
      +        },
      +        "ticket_type_ids": {
      +          "description": "Ticket types held for followers until then.",
      +          "items": {
      +            "type": "integer"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "price_from": {
      +      "description": "Lowest price now; 0.00 for free registration. Null when entry is closed.",
      +      "properties": {
      +        "amount": {
      +          "description": "Decimal amount with two places, e.g. \"150.00\".",
      +          "type": "string"
      +        },
      +        "currency": {
      +          "description": "ISO currency code. Always GTQ (quetzales).",
      +          "type": "string"
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "questions": {
      +      "description": "What the registration or checkout form asks each attendee.",
      +      "items": {
      +        "properties": {
      +          "kind": {
      +            "description": "Answer type: text, long_text, number, phone, date, choice or yes_no.",
      +            "type": "string"
      +          },
      +          "label": {
      +            "description": "The question as the attendee reads it.",
      +            "type": "string"
      +          },
      +          "options": {
      +            "description": "Answers to pick from, for kind choice.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "required": {
      +            "description": "Whether the attendee must answer.",
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "remaining": {
      +      "description": "Places left. Present only when the organizer shows it.",
      +      "type": "integer"
      +    },
      +    "slug": {
      +      "description": "Identifies the event in get-event and get-checkout-link.",
      +      "type": "string"
      +    },
      +    "starts_at": {
      +      "description": "Start, ISO 8601 with offset.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "summary": {
      +      "description": "First 200 characters of the description, plain text. Null when the event has none.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "theme": {
      +      "description": "Look of the event page.",
      +      "type": "string"
      +    },
      +    "theme_tone": {
      +      "description": "Tone the organizer chose: auto, light or dark.",
      +      "type": "string"
      +    },
      +    "ticket_types": {
      +      "description": "Paid categories. Empty for free registration.",
      +      "items": {
      +        "properties": {
      +          "checkout_url": {
      +            "description": "Checkout with this category and one ticket chosen. Null when it cannot be bought now.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "id": {
      +            "description": "Pass as ticket_type_id to get-checkout-link.",
      +            "type": "integer"
      +          },
      +          "name": {
      +            "description": "Category name.",
      +            "type": "string"
      +          },
      +          "presale_only": {
      +            "description": "Present and true while only followers can buy it.",
      +            "type": "boolean"
      +          },
      +          "price": {
      +            "description": "Price now, before fees.",
      +            "properties": {
      +              "amount": {
      +                "description": "Decimal amount with two places, e.g. \"150.00\".",
      +                "type": "string"
      +              },
      +              "currency": {
      +                "description": "ISO currency code. Always GTQ (quetzales).",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "price_phase": {
      +            "description": "Name of the price phase in effect, e.g. \"Preventa\". Null at base price.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "sold_out": {
      +            "description": "True when none are left.",
      +            "type": "boolean"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "timezone": {
      +      "description": "IANA timezone of the event, e.g. America/Guatemala.",
      +      "type": "string"
      +    },
      +    "title": {
      +      "description": "Event name.",
      +      "type": "string"
      +    },
      +    "title_font": {
      +      "description": "Title font of the event page.",
      +      "type": "string"
      +    },
      +    "tone": {
      +      "description": "Light or dark, as the page renders.",
      +      "type": "string"
      +    },
      +    "url": {
      +      "description": "Public event page.",
      +      "type": "string"
      +    },
      +    "venue": {
      +      "description": "Place or city.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds real context beyond that: this returns published events only and reveals the access/entry data (entry.url, Spanish entry.instructions to relay), which is operationally useful information not in the structured fields.

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?

A single front-loaded sentence that opens with the core scope before enumerating contents. It is dense and slightly run-on, and the embedded instruction about relaying Spanish entry.instructions is an odd bit of procedural detail, but no sentence is wasted.

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?

For a one-parameter, read-only tool with a full input schema, complete annotations and an output schema, the definition covers what is needed to select and call it. Only the lack of explicit sibling routing keeps it from being fully complete.

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% and the slug parameter is already documented as coming from search-events or the /e/{slug} URL. The description contributes nothing about the parameter itself, so the baseline 3 for high-coverage schemas is appropriate.

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?

"One published event" plus an enumeration of the content returned (description, ticket types with prices and sold-out flags, registration form fields, entry access) makes the tool's function concrete. It does not distinguish itself from siblings like search-events or draft-event, and the verb is only implied by the name, so it falls short of a 5.

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 phrase "one published event" implies this is the detail lookup for a single known event, contrasting implicitly with the listing behaviour of search-events. However, it never states when to call this instead of search-events or draft-event, nor does it mention that unpublished drafts require a different tool.

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