Skip to main content
Glama

create_coupon

Create a % discount code clients enter at checkout. code: 3-24 letters/numbers/-/_ (unique per coach). percentOff 1-99. planIds empty = every plan (ids from list_my_plans). expiresAt must be in the future. (confirm-gated: previews until confirm: true)

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": {
      "input": "<input>"
    },
    "name": "create_coupon"
  }
}

Input Schema

NameRequiredDescriptionDefault
inputYes
confirmNoMust be true to actually execute. If false/omitted, returns a preview only.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.2/5.0
Behavior5/5

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

Annotations only say it is a non-destructive write; the description adds the crucial behavior that the call is preview-only unless confirm: true, plus the per-coach uniqueness constraint on code. These are exactly the traits an agent needs and could not derive from 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?

The purpose leads in the first clause and the constraint list follows in a compact, front-loaded form with no filler. The telegraphic colon style is efficient, though a few clauses duplicate schema constraints already enforced by the pattern and min/max.

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 nested-input mutation with no output schema, the definition covers validation, id sourcing, and the confirm gate. Remaining gaps are minor: what the preview response contains, duplicate-code behavior, and the meaning of maxRedemptions.

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?

Adds real meaning beyond the schema: what an empty planIds array does, where plan ids come from, and the future-date rule for expiresAt. The code and percentOff notes largely restate the schema pattern/min-max, and maxRedemptions is not described at all, so it is not fully compensating for the 50% coverage.

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?

States a specific verb and resource with scope: 'Create a % discount code clients enter at checkout.' An agent immediately knows the artifact being produced. It does not name or contrast a sibling, but no sibling in the list creates coupons (set_coupon_active only toggles state), so confusion risk is low.

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?

Gives actionable prerequisites: planIds empty means every plan, ids come from list_my_plans, expiresAt must be in the future, and the call is confirm-gated. It stops short of explicit 'use this instead of X' routing, which is the only reason it is not 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.