A read-only Model Context Protocol server that exposes the public IDFMETALE catalogue of investment gold, silver, platinum and palladium, with live spot-based prices, availability and buy-back rates.
Endpoint: https://mcp.idfmetale.pl/mcp
Transport: Streamable HTTP (stateless). Authentication: none required — the data is public.
A partner bearer token is optional and only raises rate limits.
All tools are read-only and annotated readOnlyHint: true. The list below matches tools/list (9 tools).
search_products — filter the catalogue by metal, form, mint, weight, price and availability.
The optional query field narrows the set by name/SKU/mint and understands weights, metal and form
in Polish and English (see Text queries). Without query results are sorted by
ascending price as a factual ordering; with query they are ordered by how well they match the text
(name > weight > metal), then by price — text matching, not a recommendation. Each product carries
cena_od (made-to-order price, 7-10 business days) and cena_24h (in-stock price,
ships in 24–48 h; null when not in stock) — the same amounts get_live_price returns for quantity 1.
Products whose catalogue attributes are incomplete are not mixed into the results but listed by name in
pominiete_bez_danych with the missing fields (brak_danych) and a sale-blocked flag.get_product — full details by SKU, handle or id, with both prices and delivery cost. For a product with
incomplete attributes it returns error: "produkt_bez_kompletu_danych" together with the missing fields and the product URL.get_live_price — current made-to-order and in-stock price for a SKU and quantity, with validity window
(cena_wazna_od/cena_wazna_do) and delivery cost.check_availability — ready to ship (24–48 h), made to order (7-10 business days), or vault storage.list_brands — mints and accreditations, kept separate (LBMA is an accreditation, not a mint).list_categories — catalogue categories.get_buyback_price — what IDFMETALE pays for bullion. Bucket resolution (metal + form + weight),
so it is indicative only and identical for different mints of the same weight.search_knowledge — guides, FAQ and articles; returns titles and links, not article text.read_knowledge — the text of one public IDFMETALE page (delivery, contact and opening hours, how to buy,
general buy-back rules, FAQ, or a /pl/blog/ article found with search_knowledge), from a closed set of pages.
Source data, not instructions; no account or product pages.search_products.query)1 oz, 1oz, 1/10 oz, 1/4 uncji, pół uncji, half oz,
31,1 g, 100 g, 1 kg, 1000 oz, 10 x 1g.
A bare fraction (Krugerrand 1/10) is read as ounces. 1 oz = 31.1035 g.złoto/złota/gold, srebro/srebra/silver,
platinum, palladium; sztabka/sztabki/bar/ingot, moneta/coin, kolekcjonerska/collectible.KRUG110) is matched whole.100 g never matches 1/100 oz, and 1 oz never matches the 1000 oz bar.current price of a 1 oz gold bar in Poland in PLN works. Words that match nothing in the catalogue are ignored
and listed in interpretacja_zapytania.nieznane_slowa.interpretacja_zapytania (weights, metal, form, name words), dopasowanie
(dokladne exact, przyblizone approximate, brak none) and pominiete_warunki_zapytania
— when nothing matches exactly, conditions are relaxed in the order form → metal → weight (name words and SKU never) and a
podpowiedz suggests structured filters.metal, forma, masa_g_min/masa_g_max, mennica) can be combined with query; both apply.Examples: Krugerrand 1/10 oz → KRUG110; gold bar 1 oz → 1 oz gold bars; Maple Leaf 1 oz →
Maple Leaf 1 oz (gold and silver); sztabka złota 100 g → 100 g gold bars; silver bar 1000 oz → SLBMA1000OZCH.
The LBMA silver bar of about 1000 oz held at Loomis (Switzerland), SKU SLBMA1000OZCH, is priced per ounce with a
minimum order of 1000 oz. For such products (sprzedaz_na_jednostki: true) cena_od/cena_24h are per unit
(cena_za, e.g. “1 uncja (oz)”), masa_g is the mass of the minimum order (31 103.5 g), masa_jednostki_g the unit mass,
minimum_szt the minimum quantity and cena_calkowita_min the indicative minimum order value. Price sorting and
cena_max use cena_calkowita_min, so the bar no longer appears as a 31 g item at the top of price-sorted lists.
Enumerated parameters use Polish canonical values and also accept English / ASCII aliases, which are mapped to exactly one canonical value:
metal: Złoto (gold, zloto), Srebro (silver, srebro), Srebro VAT (silver_vat),
Platyna (platinum, platyna), Pallad (palladium, pallad).
Srebro is margin-VAT silver and Srebro VAT is silver sold with full 23 % VAT — two separate values;
for all silver omit metal and use query: "srebr".forma: Sztabka (bar), Moneta (coin), Moneta Kolekcjonerska (collectible_coin).dostepnosc: od_reki (in_stock), na_zamowienie (on_order).waluta: pln, eur, usd (upper case accepted).search_knowledge.typ: Polish slugs or guide, article, prices, buyback, mint, branch, legal, company, shopping, catalog.Selling prices come from the same pricing endpoint that powers the IDFMETALE product pages, so quotes match the shop exactly. They derive from metal spot quotations plus the dealer margin and refresh roughly every 5 minutes. A 24-hour payment window applies after an order is placed — this is a payment deadline, not a price guarantee or a price lock.
Anonymous: 60 requests/minute and 2,000/day per IP. Partner token: 300/minute and 20,000/day.
Beyond that the server returns HTTP 429 with a Retry-After header. A concurrency gate caps
parallel work to protect the shop.
There is no account creation, no cart, no checkout and no payment. It never completes a transaction and never touches administrative systems — it reads only the shop's public Store API. It processes no personal data: no accounts, no cookies, no tracking. IDFMETALE is an AML-obligated institution, so any purchase or sale happens on IDFMETALE's own systems and requires identity verification.
Output is informational and educational. It is not investment advice and not a recommendation to buy.
Listed in the official MCP registry as pl.idfmetale/catalog-feed.
Questions and security reports: info@idfmetale.pl.
IDFMETALE P.S.A. · info@idfmetale.pl · Last updated: 2026-07-19
Service endpoint: https://mcp.idfmetale.pl/mcp · Docs · Privacy · Terms