Lianex — Australian price comparison

One canonical product comparison

lianex_vs_by_slug

Read-onlyIdempotent

Return a published comparison with columns, rows, summary and product sides. Unknown, retired or suppressed slugs return 404; missing cached products return 410. A non-canonical product order returns 200 with redirect_to naming the canonical slug. Cache-only.

Input Schema

Name	Required	Description	Default
`slug`	Yes	A published comparison slug — the slug of an entry from /api/public/vs (MCP tool lianex_vs).

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed91 schema fields changedNov 2, 2026
- removedOutput schema / $defs / PublicProduct / description
```
Removed value: -"A cached product. Pass its outbound url unchanged to preserve affiliate tracking. Fields may be missing or null when unavailable."
```
- removedOutput schema / $defs / PublicProduct / properties / availability / description
```
Removed value: -"`InStock` or `OutOfStock`, rolled up across every stored lane."
```
- removedOutput schema / $defs / PublicProduct / properties / availability / title
```
Removed value: -"Availability"
```
- removedOutput schema / $defs / PublicProduct / properties / brand / description
```
Removed value: -"The brand: the stored brand, else the listing's own Brand / Brand Name item specific — never a placeholder such as Unbranded."
```
- removedOutput schema / $defs / PublicProduct / properties / brand / title
```
Removed value: -"Brand"
```
- removedOutput schema / $defs / PublicProduct / properties / canonical_specs / description
```
Removed value: -"The merged canonical spec sheet, when one could be derived."
```
- removedOutput schema / $defs / PublicProduct / properties / canonical_specs / title
```
Removed value: -"Canonical Specs"
```
- removedOutput schema / $defs / PublicProduct / properties / category_id / description
```
Removed value: -"The marketplace category id we cached it under."
```
- removedOutput schema / $defs / PublicProduct / properties / category_id / title
```
Removed value: -"Category Id"
```
- removedOutput schema / $defs / PublicProduct / properties / category_name / description
```
Removed value: -"That category's display name."
```
- removedOutput schema / $defs / PublicProduct / properties / category_name / title
```
Removed value: -"Category Name"
```
- removedOutput schema / $defs / PublicProduct / properties / condition / description
```
Removed value: -"The stored condition label, when we recorded one."
```
- removedOutput schema / $defs / PublicProduct / properties / condition / title
```
Removed value: -"Condition"
```
- removedOutput schema / $defs / PublicProduct / properties / currency / description
```
Removed value: -"ISO currency code of `price`."
```
- removedOutput schema / $defs / PublicProduct / properties / currency / title
```
Removed value: -"Currency"
```
- removedOutput schema / $defs / PublicProduct / properties / gtin / description
```
Removed value: -"A GS1 barcode number (8, 12, 13 or 14 digits) from the listing's item specifics, included only when its check digit is valid."
```
- removedOutput schema / $defs / PublicProduct / properties / gtin / title
```
Removed value: -"Gtin"
```
- removedOutput schema / $defs / PublicProduct / properties / image / description
```
Removed value: -"The primary image URL."
```
- removedOutput schema / $defs / PublicProduct / properties / image / title
```
Removed value: -"Image"
```
- removedOutput schema / $defs / PublicProduct / properties / images / description
```
Removed value: -"Additional gallery image URLs. May be empty."
```
- removedOutput schema / $defs / PublicProduct / properties / images / title
```
Removed value: -"Images"
```
- removedOutput schema / $defs / PublicProduct / properties / item_id / description
```
Removed value: -"The marketplace's own id for this listing."
```
- removedOutput schema / $defs / PublicProduct / properties / item_id / title
```
Removed value: -"Item Id"
```
- removedOutput schema / $defs / PublicProduct / properties / marketplace / description
```
Removed value: -"The STORED locale label (`EBAY_AU`), which is not the same string as `provider`."
```
- removedOutput schema / $defs / PublicProduct / properties / marketplace / title
```
Removed value: -"Marketplace"
```
- removedOutput schema / $defs / PublicProduct / properties / price / description
```
Removed value: -"The price as a decimal STRING (`\"1649.00\"`), never a float — so it cannot lose cents to binary rounding on the way to you."
```
- removedOutput schema / $defs / PublicProduct / properties / price / title
```
Removed value: -"Price"
```
- removedOutput schema / $defs / PublicProduct / properties / provider / description
```
Removed value: -"The marketplace routing token: `ebay`, `amazon`, `aliexpress`, `jbhifi`, `shein`."
```
- removedOutput schema / $defs / PublicProduct / properties / provider / title
```
Removed value: -"Provider"
```
- removedOutput schema / $defs / PublicProduct / properties / return_terms / description
```
Removed value: -"eBay listings only: whether returns are accepted, the return window in days, and who pays return postage. Null for other marketplaces or when unknown."
```
- removedOutput schema / $defs / PublicProduct / properties / shipping / description
```
Removed value: -"eBay listings only: the listing's cheapest shipping option as last seen — cost, currency, cost type and the delivery-estimate window. Null for other marketplaces or when unknown."
```
- removedOutput schema / $defs / PublicProduct / properties / specifics / description
```
Removed value: -"The listing's own item specifics, minus empty/placeholder values."
```
- removedOutput schema / $defs / PublicProduct / properties / specifics / title
```
Removed value: -"Specifics"
```
- removedOutput schema / $defs / PublicProduct / properties / title / description
```
Removed value: -"The listing title as the marketplace states it."
```
- removedOutput schema / $defs / PublicProduct / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / PublicProduct / properties / updated_at / description
```
Removed value: -"ISO-8601 instant this listing was last re-checked."
```
- removedOutput schema / $defs / PublicProduct / properties / updated_at / title
```
Removed value: -"Updated At"
```
- removedOutput schema / $defs / PublicProduct / properties / url / description
```
Removed value: -"The affiliate-wrapped outbound link. `null` when the marketplace is switched off."
```
- removedOutput schema / $defs / PublicProduct / properties / url / title
```
Removed value: -"Url"
```
- removedOutput schema / $defs / PublicProduct / title
```
Removed value: -"PublicProduct"
```
- removedOutput schema / $defs / ReturnTerms / description
```
Removed value: -"An eBay listing's return terms as last seen."
```
- removedOutput schema / $defs / ReturnTerms / properties / accepted / description
```
Removed value: -"Whether the seller accepts returns."
```
- removedOutput schema / $defs / ReturnTerms / properties / accepted / title
```
Removed value: -"Accepted"
```
- removedOutput schema / $defs / ReturnTerms / properties / period_days / description
```
Removed value: -"The return window in calendar days, when stated."
```
- removedOutput schema / $defs / ReturnTerms / properties / period_days / title
```
Removed value: -"Period Days"
```
- removedOutput schema / $defs / ReturnTerms / properties / return_postage_payer / description
```
Removed value: -"Who pays return postage, when stated: BUYER or SELLER."
```
- removedOutput schema / $defs / ReturnTerms / properties / return_postage_payer / title
```
Removed value: -"Return Postage Payer"
```
- removedOutput schema / $defs / ReturnTerms / title
```
Removed value: -"ReturnTerms"
```
- removedOutput schema / $defs / ShippingTerms / description
```
Removed value: -"An eBay listing's cheapest shipping option as last seen. Any field may be null when eBay did not state it."
```
- removedOutput schema / $defs / ShippingTerms / properties / captured_at / description
```
Removed value: -"ISO-8601 instant we read this delivery estimate; the estimate window is relative to it."
```
- removedOutput schema / $defs / ShippingTerms / properties / captured_at / title
```
Removed value: -"Captured At"
```
- removedOutput schema / $defs / ShippingTerms / properties / cost / description
```
Removed value: -"Shipping cost as a decimal STRING; \"0.00\" means free."
```
- removedOutput schema / $defs / ShippingTerms / properties / cost / title
```
Removed value: -"Cost"
```
- removedOutput schema / $defs / ShippingTerms / properties / cost_type / description
```
Removed value: -"eBay's shipping cost type, e.g. FIXED or CALCULATED."
```
- removedOutput schema / $defs / ShippingTerms / properties / cost_type / title
```
Removed value: -"Cost Type"
```
- removedOutput schema / $defs / ShippingTerms / properties / currency / description
```
Removed value: -"ISO currency code of `cost`."
```
- removedOutput schema / $defs / ShippingTerms / properties / currency / title
```
Removed value: -"Currency"
```
- removedOutput schema / $defs / ShippingTerms / properties / max_delivery / description
```
Removed value: -"ISO-8601 instant: the latest estimated delivery date eBay quoted when we last saw the listing. An estimate, not a promise; it can be in the past."
```
- removedOutput schema / $defs / ShippingTerms / properties / max_delivery / title
```
Removed value: -"Max Delivery"
```
- removedOutput schema / $defs / ShippingTerms / properties / min_delivery / description
```
Removed value: -"ISO-8601 instant: the earliest estimated delivery date eBay quoted when we last saw the listing. An estimate, not a promise; it can be in the past."
```
- removedOutput schema / $defs / ShippingTerms / properties / min_delivery / title
```
Removed value: -"Min Delivery"
```
- removedOutput schema / $defs / ShippingTerms / title
```
Removed value: -"ShippingTerms"
```
- removedOutput schema / $defs / SlugRedirect / description
```
Removed value: -"The requested address has a current canonical slug. This JSON response uses status 200. Request the returned slug on the same endpoint."
```
- removedOutput schema / $defs / SlugRedirect / properties / redirect_to / description
```
Removed value: -"The slug to follow. Not a URL — a slug."
```
- removedOutput schema / $defs / SlugRedirect / properties / redirect_to / title
```
Removed value: -"Redirect To"
```
- removedOutput schema / $defs / SlugRedirect / title
```
Removed value: -"SlugRedirect"
```
- removedOutput schema / $defs / VsComparison / description
```
Removed value: -"The stored comparison content: product columns, comparison rows and summary."
```
- removedOutput schema / $defs / VsComparison / properties / columns / description
```
Removed value: -"One column per compared product, in the frozen order."
```
- removedOutput schema / $defs / VsComparison / properties / columns / title
```
Removed value: -"Columns"
```
- removedOutput schema / $defs / VsComparison / properties / rows / description
```
Removed value: -"The aligned attribute rows."
```
- removedOutput schema / $defs / VsComparison / properties / rows / title
```
Removed value: -"Rows"
```
- removedOutput schema / $defs / VsComparison / properties / summary / description
```
Removed value: -"The frozen prose summary."
```
- removedOutput schema / $defs / VsComparison / properties / summary / title
```
Removed value: -"Summary"
```
- removedOutput schema / $defs / VsComparison / title
```
Removed value: -"VsComparison"
```
- removedOutput schema / $defs / VsPage / description
```
Removed value: -"A published head-to-head comparison of two or three cached products."
```
- removedOutput schema / $defs / VsPage / properties / a / description
```
Removed value: -"Alias for `sides[0]`, present only on a two-sided comparison."
```
- removedOutput schema / $defs / VsPage / properties / b / description
```
Removed value: -"Alias for `sides[1]`, present only on a two-sided comparison."
```
- removedOutput schema / $defs / VsPage / properties / category_id / title
```
Removed value: -"Category Id"
```
- removedOutput schema / $defs / VsPage / properties / category_name / title
```
Removed value: -"Category Name"
```
- removedOutput schema / $defs / VsPage / properties / result / title
```
Removed value: -"Result"
```
- removedOutput schema / $defs / VsPage / properties / siblings / title
```
Removed value: -"Siblings"
```
- removedOutput schema / $defs / VsPage / properties / sides / description
```
Removed value: -"The compared products, two or three of them."
```
- removedOutput schema / $defs / VsPage / properties / sides / title
```
Removed value: -"Sides"
```
- removedOutput schema / $defs / VsPage / properties / slug / title
```
Removed value: -"Slug"
```
- removedOutput schema / $defs / VsPage / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / VsPage / properties / updated_at / title
```
Removed value: -"Updated At"
```
- removedOutput schema / $defs / VsPage / title
```
Removed value: -"VsPage"
```
- removedOutput schema / $defs / VsSibling / properties / slug / title
```
Removed value: -"Slug"
```
- removedOutput schema / $defs / VsSibling / properties / title / title
```
Removed value: -"Title"
```
- removedOutput schema / $defs / VsSibling / title
```
Removed value: -"VsSibling"
```
- removedOutput schema / title
```
Removed value: -"Response 200 Public Vs Api Public Vs  Slug  Get"
```

Changed1 schema field changedOct 29, 2026

addedInput schema / properties / slug / description

Added value: +"A published comparison slug — the slug of an entry from /api/public/vs (MCP tool lianex_vs)."

First observedOct 22, 2026

TDQS

A3.7/5.0

Behavior4/5

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

Annotations already cover safety (readOnly, idempotent, closed-world), yet the description adds real value: HTTP status semantics for unknown/retired/suppressed slugs (404) versus missing cached products (410), plus the 200-with-redirect_to behavior for non-canonical ordering, and the "Cache-only" constraint that implies possible staleness. It stops short of saying whether a redirect should be followed automatically or whether the caller should re-issue with the canonical slug.

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?

Four short sentences, front-loaded with the payload shape, followed by the failure modes and the cache constraint. The only minor redundancy is enumerating columns/rows/summary/sides when an output schema already exists, but it usefully signals size and shape up front.

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?

An output schema exists, so return values need not be detailed, and annotations cover the safety profile; the description fills the remaining gap with error and redirect behavior. Only the multi-status decision flow (should the agent follow redirect_to or re-call?) is left for the agent to infer.

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% and the single slug parameter is already fully documented there, including the pointer to lianex_vs as the source of valid values. The description adds nothing about slug format or normalization beyond the redirect note. Baseline 3 applies when the schema carries the parameter burden.

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 ("Return a published comparison") and enumerates the payload shape (columns, rows, summary, product sides), so the agent knows exactly what it gets. It does not name or contrast with the sibling that lists comparisons (lianex_vs); that routing hint lives only in the schema's parameter description, not the description itself.

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

Usage Guidelines3/5

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

Implicitly scoped to "I already have a slug" via the 404/410/redirect semantics, and "Cache-only" hints that no live fetch occurs. But there is no explicit when-to-use statement or pointer to lianex_vs to obtain a slug first, and no statement about when to prefer lianex_resolve_compare, which appears to be the closest ambiguous sibling.

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

All Lianex — Australian price comparison 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?