TATUAT.RO — Tattoo & Piercing Supplies

Calculează transportul pe tatuat.ro

calculate_shipping

Read-onlyIdempotent

Calculează costul de transport, pragul pentru transport gratuit și cadourile atinse la prag pentru un coș tatuat.ro. Dă fie 'lines' (produsele coșului, ca tool-ul să citească prețul real din catalog), fie un 'subtotal' deja cunoscut. Pentru variante cu prețuri diferite, trimite variant_id din get_product. Un produs sau o variantă neconfirmată oprește calculul, fără total parțial. Folosește acest tool când clientul întreabă cât costă transportul sau cât mai trebuie să cumpere pentru livrare gratuită sau cadou.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`lines`	No	Liniile coșului (maxim 50), ca tool-ul să calculeze subtotalul din prețurile reale ale catalogului. Coș gol = listă vidă. Folosește ori acest câmp, ori 'subtotal', niciodată ambele.
`subtotal`	No	Subtotalul coșului în RON, dacă e deja cunoscut (de exemplu calculat din prețurile întoarse de search_products). Folosește ori acest câmp, ori 'lines', niciodată ambele.

Output Schema

TableJSON Schema

Name	Required	Description
`currency`	Yes	Moneda tuturor sumelor. Întotdeauna RON.
`subtotal`	Yes	Subtotalul folosit la calcul, în RON.
`next_gift`	Yes	Următorul cadou de atins și cât mai e nevoie, sau null dacă toate cadourile au fost atinse.
`shipping_fee`	Yes	Costul transportului pentru acest coș, în RON (0 = gratuit).
`free_shipping`	Yes	Dacă transportul e gratuit la acest coș.
`gifts_reached`	Yes	Numele cadourilor pentru care coșul a atins deja pragul.
`heavy_shipping`	Yes	Dacă tariful de mai sus vine din produse "grele" cu transport propriu, nu din tariful standard.
`order_restriction`	Yes	Restricția de comandă a coșului, sau null. hu_only = cel puțin un produs din liniile trimise se poate comanda DOAR cu livrare în Ungaria; transportul de mai sus e calculat corect, dar comanda va fi refuzată la plasare pentru livrare în România. Null când s-a trimis doar `subtotal`, fără linii — atunci produsele nu sunt cunoscute aici.
`amount_to_free_shipping`	Yes	Cât mai trebuie adăugat la coș, în RON, pentru transport gratuit (0 dacă e deja atins).

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 30, 2026

changedInput schema / properties / lines / items / description

Previous value: -"O linie de coș: exact unul dintre slug sau product_id, plus cantitatea."New value: +"O linie de coș: exact unul dintre slug sau product_id, cantitatea și variant_id pentru varianta aleasă."

addedInput schema / properties / lines / items / properties / variant_id

Added value: +{
+  "description": "ID-ul variantei alese, din get_product. Necesar dacă variantele au prețuri diferite; omite pentru produse simple.",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Changed2 schema fields changedSep 30, 2026

addedOutput schema / properties / order_restriction

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "hu_only"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Restricția de comandă a coșului, sau null. hu_only = cel puțin un produs din liniile trimise se poate comanda DOAR cu livrare în Ungaria; transportul de mai sus e calculat corect, dar comanda va fi refuzată la plasare pentru livrare în România. Null când s-a trimis doar `subtotal`, fără linii — atunci produsele nu sunt cunoscute aici."
+}

changedOutput schema / required

Previous value: -[
-  "subtotal",
-  "shipping_fee",
-  "free_shipping",
-  "amount_to_free_shipping",
-  "heavy_shipping",
-  "currency",
-  "gifts_reached",
-  "next_gift"
-]New value: +[
+  "subtotal",
+  "shipping_fee",
+  "free_shipping",
+  "amount_to_free_shipping",
+  "heavy_shipping",
+  "currency",
+  "gifts_reached",
+  "order_restriction",
+  "next_gift"
+]

First observedSep 30, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations already declare a safe, idempotent, closed-world read. The description adds genuine behavior: it reads real catalog prices, variant pricing requires variant_id from get_product, and an unconfirmed product/variant aborts the calculation entirely with no partial total. That failure-mode disclosure exceeds what annotations provide.

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 purpose, then input rules, then usage trigger. Every sentence carries information, though it runs long and could tighten the variant/unconfirmed sentences.

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?

With an output schema present and full annotation coverage, the description supplies the remaining context an agent needs: input exclusivity, variant sourcing, and abort-on-unknown behavior. Nothing critical is missing for correct invocation.

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 description coverage is 100%; the schema already documents slug/product_id/variant_id, quantity, and the lines-or-subtotal exclusivity that the description repeats. The description adds little parameter meaning beyond what is already structured, so the 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 (Calculează) and three concrete outputs: shipping cost, free-shipping threshold, and gifts reached at the threshold, scoped to a tatuat.ro cart. This clearly separates it from siblings like get_product or create_checkout.

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?

Explicitly names the triggering situations — customer asking about shipping cost or how much more is needed for free shipping/a gift. It also guides the lines-vs-subtotal choice, though it does not name a competing sibling tool to route away from.

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

All TATUAT.RO — Tattoo & Piercing Supplies 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.