io.github.estartokenPublished by GitHub account estartokenv0.1.0Updated Oct 24, 2026
Tattoo and piercing supply catalog (Romania): search, live stock, shipping cost, checkout link.
Remote MCP server for the TATUAT.RO tattoo and piercing supply catalog in Romania: product search, live stock, shipping cost and a signed checkout link.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.estartoken%2Ftatuat-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"tatuat-ro-tattoo-piercing-supplies": {
"type": "http",
"url": "https://api.tatuat.ro/mcp"
}
}
}Catalogul tatuat.ro — echipament de tatuaj și piercing — disponibil pentru ChatGPT, Claude și orice agent AI. Caută produse, verifică stocul real, calculează transportul și generează un link de comandă, direct din conversație.
Documentație publică: api.tatuat.ro · llms.txt
🟢 Live: https://api.tatuat.ro/mcp · transport streamable HTTP · fără autentificare
English — MCP server exposing the TATUAT.RO catalog (tattoo & piercing supplies, Romania) to AI agents. Live at
https://api.tatuat.ro/mcp, streamable HTTP, no auth required. Six tools: product search, category browsing, product detail, real-time stock, shipping calculator, and a signed checkout link. Prices in RON. Read-only except the checkout link — the purchase is completed on tatuat.ro.
Primele cinci sunt read-only — nu scriu nimic. Al șaselea generează doar un link; nu plasează comanda și nu atinge baza de date.
— Am nevoie de cartușe 0.30 RL, vreo 20 de bucăți. Cât mă costă cu transport?
Agentul apelează search_products → get_product (alege varianta) → get_stock → calculate_shipping, răspunde cu prețul
real și cu cât mai trebuie până la transport gratuit, apoi create_checkout dă linkul pe
care clientul finalizează comanda pe tatuat.ro.
Claude Code
Claude Desktop — Settings → Connectors → Add custom connector → https://api.tatuat.ro/mcp
Orice client MCP — endpoint streamable HTTP, protocol 2025-06-18, fără token.
Prețul contractual e RON, etichetat explicit în fiecare răspuns. Magazinul are și prețuri în HUF (rată fixă), dar nu se expun aici: un preț fără etichetă de monedă, citit de un model, e exact felul în care un client ajunge să creadă că plătește altă sumă.
La produsele cu variante (mărimi, configurații) prețul întors e minimul dintre variante,
marcat price_from: true când variantele au prețuri diferite, ca agentul să spună „de la X RON", nu „X RON".
Pentru calculate_shipping, fiecare linie acceptă variant_id din get_product.
Când variantele au prețuri diferite, ID-ul este necesar pentru un total exact. Fără el,
serverul cere selecția. Un produs/variantă neconfirmată sau un preț lipsă oprește calculul
cu isError, fără un subtotal parțial. Produsele cu variante la același preț pot fi
calculate fără selecție. subtotal direct nu poate verifica produse sau tarife de colet greu.
Marginea HTTP validează Host și Origin împotriva unei allowlist statice din
MCP_ALLOWED_HOSTS (implicit api.tatuat.ro). Lista nu se derivă niciodată din cererea
însăși — o allowlist construită din propriul header Host ar accepta trivial o pagină de
DNS rebinding.
Consecințe care arată ca defecțiuni, dar sunt intenționate:
MCP_ALLOWED_HOSTS pentru acel environment; nu relaxa validarea.Host absent → 403 (missing_host), fail-closed: clienții MCP trimit mereu Host.Origin absent → trece. Polaritate opusă față de Host: clienții non-browser nu
trimit Origin, iar a-i respinge ar rupe exact clientul pentru care există serverul. Un
Origin prezent dar de pe alt host, sau literalul null, primește 403.Refuzul are formă JSON-RPC cu status 403, nu HTML — un client MCP îl poate parsa.
Numele sunt în .env.example, fără valori. Valorile vin din env-ul
proiectului Vercel în producție și din macOS Keychain la setup local — niciodată din repo.
.mjs, glue-ul în .ts. app/**/route.ts sunt delegări pure, fără nicio
decizie: repo-ul nu are teste pe .ts, deci un .ts nu are voie să conțină ceva care
poate greși. Tot ce decide ceva e în src/**/*.mjs, acoperit de node --test.@supabase/supabase-js. Acces direct pe PostgREST cu fetch — CORS e o
restricție de browser, nu se aplică server-to-server.createMcpHandler rulează factory-ul pe
fiecare cerere; o găleată creată în factory s-ar reseta de fiecare dată. Plafonul e
per-instanță de funcție, deci „best effort", nu global.p_lang nu se trimite în căutare/listare. Fișele accesate direct pot întoarce produse cu livrare limitată la Ungaria; get_product, get_stock și calculate_shipping declară atunci order_restriction: "hu_only".
Fail-closed.Activează .githooks/pre-push, care rulează test:critical
și oprește push-ul dacă pică ceva. O singură dată pe clonă. Ocolire, când chiar
trebuie: git push --no-verify.
npm run typecheck acoperă și fișierele .mjs (checkJs: true plus "**/*.mjs" în
include). Fără acele două linii, gate-ul privea zero fișiere și trecea mereu.
Magazinul: tatuat.ro — echipament profesional de tatuaj și piercing.
Source: README.md at commit 7a3c025
Caută produse pe tatuat.ro
Caută în catalogul tatuat.ro după nume, brand sau tip de produs și întoarce produse cu preț în RON, disponibilitate și link direct la fișa de produs. Folosește acest tool când clientul întreabă dacă un produs există, cât costă sau ce opțiuni sunt disponibile. Pentru detaliile unui produs anume, folosește după aceea get_product cu slug-ul întors aici.
limitqueryrequiredCalculează transportul pe tatuat.ro
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.
linessubtotalVerifică stocul unui produs pe tatuat.ro
Verifică disponibilitatea reală a unui produs (sau al unei variante a lui, ex. o mărime) pentru o cantitate cerută de client, folosind slug-ul întors de search_products. Întoarce una din patru stări — disponibil integral acum, parțial disponibil cu rest pe precomandă, precomandă integrală (stoc 0), sau cantitate la plafonul maxim comandabil — plus un text pe care îl poți spune clientului fără să inventezi o cifră.
qtyslugrequiredvariant_idRăsfoiește o categorie de pe tatuat.ro
Întoarce o pagină de produse dintr-o categorie tatuat.ro (sau din tot catalogul, dacă nu se dă un ID de categorie), cu preț în RON, disponibilitate și link direct la fișa de produs. Folosește acest tool când clientul vrea să vadă ce e disponibil într-o categorie sau vrea produsele cele mai populare/ieftine/scumpe/noi. Pentru un produs anume folosește după aceea get_product cu slug-ul întors aici.
sortlimitoffsetcategory_idFișa unui produs de pe tatuat.ro
Întoarce fișa completă a unui produs de pe tatuat.ro după slug: nume, descriere, preț efectiv în RON (cu prețul dinainte de reducere dacă e cazul), disponibilitate, link direct la fișă, brand și variantele cu preț și stoc propriu. Folosește slug-ul întors de search_products. Dacă slug-ul nu corespunde unui produs activ, found este false — nu e o eroare.
slugrequiredCreează link de finalizare comandă pe tatuat.ro
Generează un link semnat către checkout-ul tatuat.ro pentru coșul dat (produse, variante, cantități, opțiuni). Linkul e valabil un timp limitat și NU conține prețuri — prețul final se confirmă pe site. Folosește acest tool când clientul e decis să cumpere; pentru a găsi produse sau prețuri folosește search_products/get_product înainte.
itemsrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a license in the repository or the registry entry.
claude mcp add --transport http tatuat https://api.tatuat.ro/mcpnpm run test # node --test pe src/mcp, src/mcp/tools, src/well-knownnpm run typecheck # tsc --noEmit — vede și .mjs (checkJs + include)npm run test:critical # ambelenpm run dev # Next dev pe :3000npm run build # next buildgit config core.hooksPath .githooks