Skip to main content
Glama

Comisión de pago (bruto/neto)

payment-fee
Read-onlyIdempotent

Calcula, para una comisión de porcentaje + fijo, cuánto cobrar para recibir un neto o cuánto se recibe de un cobro bruto. Cuándo: un cálculo de dinero, impuestos o matemática financiera tiene que ser exacto y reproducible (redondeo, centavos, tasas). No para: aplicar descuentos porcentuales o fijos a un precio (discount-calculate). Efectos secundarios: ninguno (solo lectura, sin red, sin estado guardado). Determinista: la misma entrada da la misma salida. Límites: entrada JSON de hasta 64 KB, 1 s por llamada, resultado de hasta 1 MB.

EN: Computes, for a processor fee of percent + fixed amount, the amount to charge to net a target amount (gross-up) or the net received from a gross charge. When: a money, tax or financial-math result has to be exact and reproducible (rounding, cents, rates). Not for: applying percentage or fixed discounts to a price (discount-calculate). Side effects: none (read-only, no network access, no stored state). [EN completo / full EN: inputSchema.description]

Input Schema

NameRequiredDescriptionDefault
modeNoDirection (optional; one of: gross_up, net; default "gross_up").gross_up
amountYesTarget net (gross_up) or charge (net) (number; required; min 0; max 10000000000000).
currencyNoISO 4217 currency code (string; optional; default "USD"; pattern ^[A-Za-z]{3}$).USD
fee_fixedNoFixed fee per transaction (number; optional; default 0; min 0).
fee_percentYesPercent fee (number; required; min 0; max 99).

Output Schema

NameRequiredDescriptionDefault
feeNo
netNo
chargeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / amount / examples
      Added value: +[
      +  100
      +]
    • addedInput schema / properties / fee_percent / examples
      Added value: +[
      +  2.9
      +]
  2. Changed1 schema field changed
    • addedInput schema / description
      Added value: +"EN: Computes, for a processor fee of percent + fixed amount, the amount to charge to net a target amount (gross-up) or the net received from a gross charge. When: a money, tax or financial-math result has to be exact and reproducible (rounding, cents, rates). Not for: applying percentage or fixed discounts to a price (discount-calculate). Side effects: none (read-only, no network access, no stored state). Deterministic: the same input gives the same output. Limits: JSON input up to 64 KB, 1 s per call, result up to 1 MB."
  3. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so the safety profile is covered; the description still adds genuinely new context in the form of determinism guarantees and hard limits (64 KB input, 1 s per call, 1 MB result). It loses a point because 'no network access, no stored state' largely restates the annotation set rather than adding to it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The labeled structure (When / Not for / Side effects / Deterministic / Limits) is good and front-loaded, but the content is duplicated wholesale in Spanish and English and ends with a dangling artifact ('[EN completo / full EN: inputSchema.description]'), roughly doubling length without adding information.

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?

With an output schema present, rich annotations and 100% schema coverage, the description needs only purpose, selection guidance and any behavioral caveats — all of which it supplies, including rate/size limits that an agent should know before calling.

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%, so the schema already documents all five parameters including the mode enum, currency pattern and fee percent bounds. The description only adds the conceptual frame (fee is percent + fixed, amount is the target net or the gross charge), which is essentially what amount's schema description says — baseline 3 applies.

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 and resource — computing a processor fee (percent + fixed) to gross up a target net or derive the net from a gross charge — and names both directions explicitly. It also explicitly distinguishes itself from the closest sibling (discount-calculate), so an agent can route without opening either 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?

Provides an explicit 'When' clause (money/tax/financial math that must be exact and reproducible) and an explicit 'Not for' clause naming the alternative tool (discount-calculate). The condition that selects this tool versus a discount calculator is stated, not inferred.

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