Skip to main content
Glama

Draft Event

draft-event
Destructive

Prepare a person's own event on Pandy Tickets from what they told you (name, date, place, ticket categories with price and quantity). Nothing is published and no account is created: it returns a one-time claim_url, valid 48 hours. The person opens it, signs in with Google, and lands on a screen where they review the event and publish it with one click. Use it when someone wants to organize an event and sell tickets or take registrations. Leave ticket_types empty for a free event. Also fill in, when the person said them: questions to ask each attendee, early-bird price_phases, and transfer_instructions (bank details) so the person only reviews and publishes. Relay the Spanish instructions and the link.

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": {
      "title": "<title>",
      "start_at": "<start_at>",
      "end_at": "<end_at>",
      "venue": "<venue>"
    },
    "name": "draft-event"
  }
}

Input Schema

NameRequiredDescriptionDefault
themeNoLook of the event page, checkout, emails and tickets. pandy: El estilo de Pandy Tickets. Sirve para cualquier evento. gala: Para recitales, galas, bodas y cenas benéficas. deportivo: Para carreras, torneos y rodadas. academico: Para congresos, simposios y graduaciones. festival: Para conciertos, fiestas y vida nocturna. comunidad: Para shows infantiles y eventos de colegio o iglesia. minimal: Para talleres y eventos corporativos. Tu foto manda. Pick the one that matches the event. Default: the organizer's last look, else pandy.
titleYesEvent name, as the public will read it.
venueYesPlace or city where it happens.
end_atYesEnd, Guatemala local time, YYYY-MM-DDTHH:MM, after start_at.
capacityNoMost people the event takes in total, if there is a limit.
start_atYesStart, Guatemala local time, YYYY-MM-DDTHH:MM. Must be in the future.
templateNoKind of event.conference
questionsNoQuestions every attendee answers when registering or buying, up to 15. Works for free and paid events.
theme_toneNoLight or dark version of a look that has both (gala). auto follows the event image: light image, light page. Default: the organizer's last choice, else auto.
title_fontNoTitle font. Omit to use the look's own font.
descriptionNoWhat the event is about, shown on the event page.
accent_colorNoBrand colour of the event page, if the person gave one.
price_phasesNoEarly-bird style price phases, in order, up to 10. The first phase that has not ended applies. Needs paid ticket_types; a free event has no prices to phase.
ticket_typesNoPaid ticket categories. Empty or omitted for a free event.
transfer_instructionsNoBank, account number and holder for paying by bank transfer. The person sees it prefilled when publishing.

Output Schema

NameRequiredDescriptionDefault
previewNoThe draft as it was saved, to show the person before they open the link.
claim_urlNoOne-time link the person opens to claim, review and publish the event.
expires_atNoWhen the link stops working, ISO 8601 with offset.
instructionsNoWhat to tell the person, in Spanish, with the link.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed18 schema fields changed
    • changedInput schema / properties / accent_color / description
      Previous value: -"Brand colour as #RRGGBB, if the person gave one."New value: +"Brand colour of the event page, if the person gave one."
    • addedInput schema / properties / accent_color / pattern
      Added value: +"^#[0-9A-Fa-f]{6}$"
    • changedInput schema / properties / description / description
      Previous value: -"What the event is about, up to 5000 characters."New value: +"What the event is about, shown on the event page."
    • addedInput schema / properties / description / maxLength
      Added value: +5000
    • changedInput schema / properties / price_phases / items / properties / name / description
      Previous value: -"Phase name, e.g. \"Preventa\", up to 60 characters."New value: +"Phase name, e.g. \"Preventa\"."
    • addedInput schema / properties / price_phases / items / properties / name / maxLength
      Added value: +60
    • changedInput schema / properties / questions / items / properties / label / description
      Previous value: -"The question as the attendee reads it, up to 160 characters."New value: +"The question as the attendee reads it."
    • addedInput schema / properties / questions / items / properties / label / maxLength
      Added value: +160
    • changedInput schema / properties / questions / items / properties / options / description
      Previous value: -"Only for kind choice: 2 to 20 distinct answers, up to 100 characters each."New value: +"Only for kind choice: the distinct answers to pick from."
    • addedInput schema / properties / questions / items / properties / options / items / maxLength
      Added value: +100
    • addedInput schema / properties / template / default
      Added value: +"conference"
    • changedInput schema / properties / template / description
      Previous value: -"Kind of event. Default conference."New value: +"Kind of event."
    • changedInput schema / properties / title / description
      Previous value: -"Event name, up to 160 characters."New value: +"Event name, as the public will read it."
    • addedInput schema / properties / title / maxLength
      Added value: +160
    • changedInput schema / properties / transfer_instructions / description
      Previous value: -"Bank, account number and holder for paying by bank transfer, 10 to 2000 characters. The person sees it prefilled when publishing."New value: +"Bank, account number and holder for paying by bank transfer. The person sees it prefilled when publishing."
    • changedInput schema / properties / venue / description
      Previous value: -"Place or city, up to 240 characters."New value: +"Place or city where it happens."
    • addedInput schema / properties / venue / maxLength
      Added value: +240
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "claim_url": {
      +      "description": "One-time link the person opens to claim, review and publish the event.",
      +      "type": "string"
      +    },
      +    "expires_at": {
      +      "description": "When the link stops working, ISO 8601 with offset.",
      +      "type": "string"
      +    },
      +    "instructions": {
      +      "description": "What to tell the person, in Spanish, with the link.",
      +      "type": "string"
      +    },
      +    "preview": {
      +      "description": "The draft as it was saved, to show the person before they open the link.",
      +      "properties": {
      +        "capacity": {
      +          "description": "Most people the event takes, or null for no limit.",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "end_at": {
      +          "description": "End, Guatemala local time.",
      +          "type": "string"
      +        },
      +        "price_phases": {
      +          "description": "Price phases in order.",
      +          "items": {
      +            "properties": {
      +              "ends_at": {
      +                "description": "When the phase ends, or null if it ends only by selling out.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "name": {
      +                "description": "Phase name.",
      +                "type": "string"
      +              },
      +              "prices": {
      +                "description": "Price in this phase for each category, as {amount, currency}, keyed by category name.",
      +                "type": "object"
      +              },
      +              "quantity": {
      +                "description": "Tickets sold in this phase before the next one starts, or null.",
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "questions": {
      +          "description": "Questions each attendee answers, as they were saved.",
      +          "items": {
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "start_at": {
      +          "description": "Start, Guatemala local time.",
      +          "type": "string"
      +        },
      +        "template": {
      +          "description": "Kind of event.",
      +          "type": "string"
      +        },
      +        "theme": {
      +          "description": "Look of the event page, or null to use the organizer's last look.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "theme_tone": {
      +          "description": "Light or dark version of the look, when one was chosen.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "ticket_types": {
      +          "description": "Paid categories. Empty for a free event.",
      +          "items": {
      +            "properties": {
      +              "name": {
      +                "description": "Category name.",
      +                "type": "string"
      +              },
      +              "price": {
      +                "description": "Base price.",
      +                "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"
      +              },
      +              "quantity": {
      +                "description": "Tickets of this category.",
      +                "type": "integer"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "timezone": {
      +          "description": "IANA timezone of the event.",
      +          "type": "string"
      +        },
      +        "title": {
      +          "description": "Event name.",
      +          "type": "string"
      +        },
      +        "transfer_instructions_given": {
      +          "description": "True when bank details were saved for the publish step.",
      +          "type": "boolean"
      +        },
      +        "venue": {
      +          "description": "Place or city.",
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed7 schema fields changed
    • addedInput schema / properties / accent_color
      Added value: +{
      +  "description": "Brand colour as #RRGGBB, if the person gave one.",
      +  "type": "string"
      +}
    • addedInput schema / properties / price_phases
      Added value: +{
      +  "description": "Early-bird style price phases, in order, up to 10. The first phase that has not ended applies. Needs paid ticket_types; a free event has no prices to phase.",
      +  "items": {
      +    "properties": {
      +      "ends_at": {
      +        "description": "When the phase ends, Guatemala local time, YYYY-MM-DDTHH:MM. Omit if it ends only when its quantity sells out.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Phase name, e.g. \"Preventa\", up to 60 characters.",
      +        "type": "string"
      +      },
      +      "prices": {
      +        "description": "Object mapping a ticket_types name (any letter case) to the price in quetzales in this phase, e.g. {\"General\": \"100\"}. A category left out keeps its base price.",
      +        "type": "object"
      +      },
      +      "quantity": {
      +        "description": "Tickets sold in this phase before the next one starts.",
      +        "minimum": 1,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "name",
      +      "prices"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / questions
      Added value: +{
      +  "description": "Questions every attendee answers when registering or buying, up to 15. Works for free and paid events.",
      +  "items": {
      +    "properties": {
      +      "kind": {
      +        "description": "Answer type. choice needs options.",
      +        "enum": [
      +          "text",
      +          "long_text",
      +          "number",
      +          "phone",
      +          "date",
      +          "choice",
      +          "yes_no"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "description": "The question as the attendee reads it, up to 160 characters.",
      +        "type": "string"
      +      },
      +      "options": {
      +        "description": "Only for kind choice: 2 to 20 distinct answers, up to 100 characters each.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "maxItems": 20,
      +        "minItems": 2,
      +        "type": "array"
      +      },
      +      "required": {
      +        "description": "Whether the attendee must answer.",
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "label",
      +      "kind",
      +      "required"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 15,
      +  "type": "array"
      +}
    • addedInput schema / properties / theme
      Added value: +{
      +  "description": "Look of the event page, checkout, emails and tickets. pandy: El estilo de Pandy Tickets. Sirve para cualquier evento. gala: Para recitales, galas, bodas y cenas benéficas. deportivo: Para carreras, torneos y rodadas. academico: Para congresos, simposios y graduaciones. festival: Para conciertos, fiestas y vida nocturna. comunidad: Para shows infantiles y eventos de colegio o iglesia. minimal: Para talleres y eventos corporativos. Tu foto manda. Pick the one that matches the event. Default: the organizer's last look, else pandy.",
      +  "enum": [
      +    "pandy",
      +    "gala",
      +    "deportivo",
      +    "academico",
      +    "festival",
      +    "comunidad",
      +    "minimal"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / theme_tone
      Added value: +{
      +  "description": "Light or dark version of a look that has both (gala). auto follows the event image: light image, light page. Default: the organizer's last choice, else auto.",
      +  "enum": [
      +    "auto",
      +    "light",
      +    "dark"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / title_font
      Added value: +{
      +  "description": "Title font. Omit to use the look's own font.",
      +  "enum": [
      +    "inter",
      +    "cormorant",
      +    "playfair",
      +    "dm-serif",
      +    "archivo-narrow",
      +    "bricolage",
      +    "fraunces",
      +    "nunito"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / transfer_instructions
      Added value: +{
      +  "description": "Bank, account number and holder for paying by bank transfer, 10 to 2000 characters. The person sees it prefilled when publishing.",
      +  "maxLength": 2000,
      +  "minLength": 10,
      +  "type": "string"
      +}
  3. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Substantial behavior beyond the annotations: nothing is published, no account is created, and the result is a one-time claim_url valid 48 hours that the person redeems after Google sign-in. It also tells the agent to relay the Spanish instructions and the link. It does not warn that the tool is non-idempotent (repeated calls would create extra drafts), which is the main remaining gap.

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?

Front-loaded with what the tool does and its output before the parameter guidance, and every sentence carries information. The closing instruction to relay the Spanish instructions is slightly abrupt as written but earns its place as agent-facing behavior.

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

Completeness5/5

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

For a 15-parameter mutation tool with an output schema, the description covers the resulting artifact, the human handoff step, and the optional parameters worth populating. An agent has everything needed to call it correctly and to explain the outcome to the user.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds real guidance: fill in questions, price_phases and transfer_instructions when the person mentioned them so they only have to review and publish, and omit ticket_types for a free event. That is meaning beyond the per-field documentation.

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

Purpose5/5

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

The description opens with a specific verb and resource ('Prepare a person's own event on Pandy Tickets') and enumerates the inputs it draws from (name, date, place, ticket categories with price and quantity). It is clearly distinguishable from get-event and search-events, which retrieve rather than draft.

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

Usage Guidelines4/5

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

It gives an explicit trigger ('Use it when someone wants to organize an event and sell tickets or take registrations') and a concrete edge rule ('Leave ticket_types empty for a free event'). It lacks an explicit when-not-to-use clause, e.g. pointing to get-event for existing events, so it falls short of a 5.

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