Skip to main content
Glama
voucherifyio

voucherify-core-mcp

Official
by voucherifyio
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

get_promotion_tier

Retrieve complete promotion tier details including discount rules, validation criteria, and metadata to analyze and manage your promotions.

Instructions

Retrieve detailed information about a specific promotion tier by its ID.

Returns complete promotion tier configuration including discount rules, validation criteria, and metadata for promotion analysis and management.

Enhanced Features:

  • Automatically fetches and processes validation rules for detailed rule analysis

  • Provides both raw validation_rules_assignments and processed assigned_validation_rules

  • Includes complete promotion tier hierarchy and action settings

Parameters:

  • promotion_tier_id: Promotion tier identifier for lookup

Identifier Requirements:

  • Promotion Tier ID: Must start with 'promo_' prefix (e.g., "promo_abc123def456")

  • ID must correspond to existing promotion tier

Validation Rules:

  • Promotion tier ID must be valid and existing

  • ID format is case-sensitive

Examples:

  • get_promotion_tier(promotion_tier_id="promo_abc123def456")

Returns: JSON object containing complete promotion tier details including:

Core Promotion Tier Information:

  • id: Promotion tier system identifier (e.g., "promo_abc123def456")

  • name: Human-readable tier name

  • banner: Display banner text for promotion

  • object: Always "promotion_tier"

Discount Configuration:

  • action: Complete discount configuration including:

    • discount: Discount type and value settings

    • unit_off: Fixed amount discount (if applicable)

    • unit_off_formula: Dynamic discount calculation (if applicable)

    • percent_off: Percentage discount (if applicable)

    • percent_off_formula: Dynamic percentage calculation (if applicable)

Promotion Settings:

  • hierarchy: Tier ordering and priority within campaign

  • campaign: Parent campaign information

  • campaign_id: Parent campaign identifier

  • summary: Promotion tier summary and statistics

Validation Rules (Enhanced):

  • assigned_validation_rules: Processed validation rules with detailed conditions (added by this tool) See "Validation Rules Structure" section in server instructions for complete field documentation

Additional Data:

  • metadata: Custom promotion tier attributes

  • created_at, updated_at: ISO 8601 timestamps

Use Cases:

  • Analyze promotion tier configuration and discount mechanics

  • Understand validation rules and eligibility requirements

  • Review promotion tier hierarchy and priority

  • Get complete promotion tier blueprint for management

  • Check promotion tier status and performance

Raises:

  • ToolError: If promotion tier not found or invalid ID format

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
promotion_tier_idYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Tool Definition Quality

A4.5/5.0
Behavior4/5

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

Since no annotations are provided, the description bears full burden. It discloses that the tool automatically fetches and processes validation rules, provides processed data, and raises ToolError for invalid inputs. It could explicitly state it's a read-only operation, but the behavior is well-described.

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 description is long but well-structured with clear sections (Overview, Enhanced Features, Parameters, etc.). It is front-loaded with the core purpose. While some detail could be condensed, the organization aids readability and every section adds value.

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?

Given the tool's single parameter, no output schema, and unrelated siblings, the description covers the tool's purpose, parameters, return structure (with detailed fields), use cases, and error handling. It is comprehensive for the tool's simplicity.

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

Parameters5/5

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

The input schema has 0% description coverage, so the description must compensate. It thoroughly documents the parameter's purpose, required format (must start with 'promo_'), case sensitivity, and validity requirement. It also provides an example that clarifies the expected format.

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 clearly states the action ('Retrieve detailed information') and the resource ('specific promotion tier by its ID'). It distinguishes the tool's purpose from siblings like get_voucher and get_campaign by focusing on promotion tier details.

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?

The description provides explicit use cases (e.g., 'Analyze promotion tier configuration', 'Understand validation rules'), a concrete example, and identifier requirements. It does not explicitly state when not to use this tool or mention alternatives, but the use cases strongly imply appropriate contexts.

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/voucherifyio/core-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server