Lemonvite

Generate an invitation design

lemonvite_generate_design

Destructive

Use this when the user wants Lemonvite's design engine to create the invitation artwork, because this assistant cannot make images or because the user asked for a Lemonvite design. Never call it merely because designs or themes are being discussed. Write design_brief as art direction: theme, colours, mood, motifs, style. The date, time and venue are lettered onto the design automatically, so the brief need not repeat them; set include_event_details to false only when the user wants artwork without them. A reference_image from the conversation guides style, subject and palette together with the brief and is not stored as the artwork. To change the current artwork rather than start over, use lemonvite_edit_design; to attach an image this assistant already made, use invitation_image on lemonvite_update_invitation. Each call spends one design generation and REPLACES the current artwork (earlier designs stay in the event's design history on the website), so confirm with the user first. New accounts start with 5 generations; each purchased credit adds 5.

Input Schema

TableJSON Schema

Name	Required	Description
`event_id`	Yes	Lemonvite event_id returned by lemonvite_create_invitation or lemonvite_list_invitations. Identifies the event to act on; not a guest invitation_id or RSVP URL.
`design_brief`	No	The host's art direction in their own words: theme, colours, mood, motifs, style. Omit for a default design suited to the event type.
`reference_image`	No	An image already present in this conversation for the design engine to draw on (style, subject, palette). JPEG, PNG or WebP. It guides the design and is not stored as the invitation artwork.
`include_event_details`	No	Letter the date, time and venue onto the design (default true).

Output Schema

TableJSON Schema

Name	Required	Description	Default
`invitation`	Yes
`generations_remaining`	Yes	Design generations left on the connected account after this call.

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedSep 25, 2026

changedOutput schema / properties / generations_remaining / description

Previous value: -"Design generations left on the connected account after this call. New accounts start with 5; every purchased account credit adds 5."New value: +"Design generations left on the connected account after this call."

changedOutput schema / properties / invitation / properties / payment_status / description

Previous value: -"paid = this event is already covered; credit_available = balance covers all required publishing and phone credits; payment_required = start_checkout first; not_applicable = cancelled, do not buy credits or publish. Always reflects the PRIMARY host's account — the one publishing charges."New value: +"paid = this event is already covered; credit_available = balance covers all required publishing and phone credits; payment_required = the account's credits do not cover publishing; not_applicable = cancelled, cannot be published. Always reflects the PRIMARY host's account — the one whose credits publishing uses."

changedOutput schema / properties / invitation / properties / phone_guest_allowance / description

Previous value: -"Included or already purchased phone guests; null = no phone cap."New value: +"Phone guests this event already allows; null = no phone cap."

Changed11 schema fields changedSep 21, 2026

changedOutput schema / properties / generations_remaining / description

Previous value: -"Design generations left on the connected account after this call. New accounts start with 5; every purchased publish credit adds 5."New value: +"Design generations left on the connected account after this call. New accounts start with 5; every purchased account credit adds 5."

changedOutput schema / properties / invitation / properties / can_publish / description

Previous value: -"True when this account is the event's primary host — the only account that can publish it or pay for it. Co-hosts can edit the invitation and manage guests, but must ask the primary host to publish."New value: +"True when this account is the event's primary host and the event is not cancelled. Co-hosts can edit the invitation and manage guests, but must ask the primary host to publish."

addedOutput schema / properties / invitation / properties / guest_limit

Added value: +{
+  "description": "Total cap; only support can raise it. null = verified host.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / invitation / properties / payment_status / description

Previous value: -"paid = this event is already covered; credit_available = publish will consume an existing credit; payment_required = start_checkout first. Always reflects the PRIMARY host's account — the one publishing charges."New value: +"paid = this event is already covered; credit_available = balance covers all required publishing and phone credits; payment_required = start_checkout first; not_applicable = cancelled, do not buy credits or publish. Always reflects the PRIMARY host's account — the one publishing charges."

changedOutput schema / properties / invitation / properties / payment_status / enum

Previous value: -[
-  "paid",
-  "credit_available",
-  "payment_required"
-]New value: +[
+  "paid",
+  "credit_available",
+  "payment_required",
+  "not_applicable"
+]

addedOutput schema / properties / invitation / properties / phone_batch_size
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```

addedOutput schema / properties / invitation / properties / phone_guest_allowance

Added value: +{
+  "description": "Included or already purchased phone guests; null = no phone cap.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / properties / invitation / properties / phone_guest_count
```
Added value: +{
+  "type": "number"
+}
```

addedOutput schema / properties / invitation / properties / publishing_price

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "amount_due": {
+          "type": "number"
+        },
+        "credits_to_buy": {
+          "type": "number"
+        },
+        "existing_credits": {
+          "type": "number"
+        },
+        "phone_batch_count": {
+          "type": "number"
+        },
+        "phone_batch_price": {
+          "type": "number"
+        },
+        "publish_price": {
+          "type": "number"
+        },
+        "total_price": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "publish_price",
+        "phone_batch_count",
+        "phone_batch_price",
+        "total_price",
+        "existing_credits",
+        "credits_to_buy",
+        "amount_due"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / invitation / properties / required_credits

Added value: +{
+  "description": "Publishing plus phone batches. Review with the host before authorizing this many credits.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / invitation / required

Previous value: -[
-  "event_id",
-  "publish_status",
-  "payment_status",
-  "can_publish",
-  "title",
-  "event_type",
-  "description",
-  "start_datetime",
-  "end_datetime",
-  "timezone",
-  "location",
-  "host_name",
-  "rsvp_deadline",
-  "image_url",
-  "has_invitation_image",
-  "price_display",
-  "guest_count",
-  "rsvp_summary",
-  "public_rsvp_url",
-  "manage_url",
-  "custom_fields",
-  "guest_settings"
-]New value: +[
+  "event_id",
+  "publish_status",
+  "payment_status",
+  "can_publish",
+  "title",
+  "event_type",
+  "description",
+  "start_datetime",
+  "end_datetime",
+  "timezone",
+  "location",
+  "host_name",
+  "rsvp_deadline",
+  "image_url",
+  "has_invitation_image",
+  "price_display",
+  "guest_count",
+  "phone_guest_count",
+  "guest_limit",
+  "phone_guest_allowance",
+  "phone_batch_size",
+  "required_credits",
+  "publishing_price",
+  "rsvp_summary",
+  "public_rsvp_url",
+  "manage_url",
+  "custom_fields",
+  "guest_settings"
+]

Changed5 schema fields changedSep 10, 2026

addedInput schema / properties / event_id / description

Added value: +"Lemonvite event_id returned by lemonvite_create_invitation or lemonvite_list_invitations. Identifies the event to act on; not a guest invitation_id or RSVP URL."

changedInput schema / properties / reference_image / properties / download_url / description

Previous value: -"Temporary URL to download the file from"New value: +"Fetchable HTTPS URL for the image file, up to 10 MB. Temporary conversation-file URLs are accepted."

changedInput schema / properties / reference_image / properties / file_id / description

Previous value: -"Host file identifier"New value: +"File identifier supplied by the MCP client for the image in this conversation."

addedInput schema / properties / reference_image / properties / file_name / description

Added value: +"Original filename, e.g. invitation.png. Optional metadata; the stored filename is generated by Lemonvite."

addedInput schema / properties / reference_image / properties / mime_type / description

Added value: +"Image MIME type: image/jpeg, image/png, image/webp, or image/gif. Design references exclude GIF. Used if the download has no Content-Type."

Changed2 schema fields changedSep 10, 2026

addedOutput schema / properties / invitation / properties / custom_fields

Added value: +{
+  "description": "The host's custom fields, in display order: `info` details shown on the invitation (gift registry, dress code) and `question` inputs on the RSVP form (dietary restrictions, meal choice). Change them with custom_fields on lemonvite_update_invitation.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "field_id": {
+        "type": "string"
+      },
+      "input_type": {
+        "anyOf": [
+          {
+            "enum": [
+              "text",
+              "select"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "question fields only."
+      },
+      "kind": {
+        "enum": [
+          "info",
+          "question"
+        ],
+        "type": "string"
+      },
+      "label": {
+        "type": "string"
+      },
+      "options": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "select questions only: the choices offered."
+      },
+      "required": {
+        "description": "question fields only: must be answered by a guest who says yes or maybe.",
+        "type": "boolean"
+      },
+      "value": {
+        "description": "info fields only: the text shown on the invitation (may contain a URL).",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "field_id",
+      "kind",
+      "label",
+      "value",
+      "input_type",
+      "options",
+      "required"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / properties / invitation / required

Previous value: -[
-  "event_id",
-  "publish_status",
-  "payment_status",
-  "can_publish",
-  "title",
-  "event_type",
-  "description",
-  "start_datetime",
-  "end_datetime",
-  "timezone",
-  "location",
-  "host_name",
-  "rsvp_deadline",
-  "image_url",
-  "has_invitation_image",
-  "price_display",
-  "guest_count",
-  "rsvp_summary",
-  "public_rsvp_url",
-  "manage_url",
-  "guest_settings"
-]New value: +[
+  "event_id",
+  "publish_status",
+  "payment_status",
+  "can_publish",
+  "title",
+  "event_type",
+  "description",
+  "start_datetime",
+  "end_datetime",
+  "timezone",
+  "location",
+  "host_name",
+  "rsvp_deadline",
+  "image_url",
+  "has_invitation_image",
+  "price_display",
+  "guest_count",
+  "rsvp_summary",
+  "public_rsvp_url",
+  "manage_url",
+  "custom_fields",
+  "guest_settings"
+]

First observedSep 9, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Goes well beyond the destructiveHint/idempotentHint annotations: it discloses that each call consumes one design generation, REPLACES the current artwork while earlier designs remain in the event's design history, requires user confirmation, and explains the credit economy (5 to start, +5 per purchased credit). That is exactly the cost/side-effect context an agent needs before a destructive, non-idempotent call.

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 the routing condition, then guidance, then side effects. Every sentence carries distinct information, though the paragraph is dense and a reader must hold several constraints at once; minor structural cost, no waste.

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?

Output schema exists so return values need no explanation. With annotations covering the safety profile, the description still supplies cost, replacement behavior, confirmation requirement, credit accounting, and parameter intent — nothing an agent needs to call this correctly is missing.

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 already 100%, so the baseline is 3, but the description adds genuine semantics: design_brief should be written as art direction, it need not repeat date/time/venue because those are lettered on automatically, include_event_details=false is the escape hatch for detail-free artwork, and reference_image guides style but is not stored as the artwork. The last point in particular is not derivable from the schema.

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?

States a specific verb+resource (Lemonvite's design engine creating the invitation artwork) and immediately distinguishes itself from siblings by naming lemonvite_edit_design for changes and invitation_image on lemonvite_update_invitation for attaching existing images. An agent can route correctly without opening any schema.

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

Usage Guidelines5/5

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

Explicit when-to-use (user asked for a Lemonvite design, or this assistant cannot make images), explicit when-NOT ("Never call it merely because designs or themes are being discussed"), and named alternatives with the condition selecting each.

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

All Lemonvite tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?