TATUAT.RO — Tattoo & Piercing Supplies

Official6 tools

by estartoken · JavaScript

Tattoo and piercing supply catalog (Romania): search, live stock, shipping cost, checkout link.

io.github.estartoken/tatuat-mcp (MCP) Server

This MCP server provides a tattoo and piercing supply catalog for Romania. It supports search across the catalog, live stock availability, shipping cost lookup, and provides a checkout link for purchases.

🛠️ Key Features

Tattoo and piercing supply catalog (Romania)
Search
Live stock availability
Shipping cost lookup
Checkout link

🚀 Use Cases

Find specific tattoo or piercing supplies via search
Verify item availability through live stock data
Determine shipping cost before checkout
Access checkout using the provided link

⚡ Developer Benefits

Exposes catalog-related operations (search, stock, shipping, checkout link) through an MCP interface

⚠️ Limitations

Catalog scope is described as Romania-focused supplies
Only the above capabilities are indicated; no additional tools or behaviors are specified

Topics

ai-agentschatgptclaudeecommercemcpmcp-servermodel-context-protocolnextjsromaniastreamable-httpsupabasetattoo

Captured live from the server via tools/list.

search_products

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.

Parameters2

query	string	required	Ce caută clientul, în cuvintele lui: nume de produs, brand, sau tip de produs (ex. „ace 0.30 RL", „mașină rotativă", „tuș negru"). Minim două caractere ca să se facă efectiv o căutare.
limit	integer	optional	Câte rezultate să întoarcă, între 1 și 20. Implicit 10.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Ce caută clientul, în cuvintele lui: nume de produs, brand, sau tip de produs (ex. „ace 0.30 RL\", „mașină rotativă\", „tuș negru\"). Minim două caractere ca să se facă efectiv o căutare."
    },
    "limit": {
      "default": 10,
      "description": "Câte rezultate să întoarcă, între 1 și 20. Implicit 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

calculate_shipping

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.

Parameters2

lines	array	optional	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	number	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "lines": {
      "description": "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.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "description": "Slug-ul produsului, ca cel întors de search_products.",
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "product_id": {
            "description": "Identificatorul numeric al produsului, alternativă la slug.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "variant_id": {
            "description": "ID-ul variantei alese, din get_product. Necesar dacă variantele au prețuri diferite; omite pentru produse simple.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9999,
            "description": "Câte bucăți din acest produs sunt în coș."
          }
        },
        "required": [
          "quantity"
        ],
        "description": "O linie de coș: exact unul dintre slug sau product_id, cantitatea și variant_id pentru varianta aleasă."
      }
    },
    "subtotal": {
      "description": "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.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_stock

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ă.

Parameters3

slug	string	required	Identificatorul textual (slug) al produsului, ca cel întors de search_products sau din URL-ul /product/<slug>.
variant_id	integer	optional	ID-ul variantei (ex. mărimea acului) al cărei stoc se verifică. Omite pentru produsele fără variante — sau ca să se verifice varianta implicită a produsului.
qty	integer	optional	Câte bucăți vrea clientul să comande. Implicit 1, maximum 9999.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Identificatorul textual (slug) al produsului, ca cel întors de search_products sau din URL-ul /product/<slug>."
    },
    "variant_id": {
      "description": "ID-ul variantei (ex. mărimea acului) al cărei stoc se verifică. Omite pentru produsele fără variante — sau ca să se verifice varianta implicită a produsului.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "qty": {
      "default": 1,
      "description": "Câte bucăți vrea clientul să comande. Implicit 1, maximum 9999.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9999
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

browse_category

Î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.

Parameters4

category_id	any	optional	ID-ul numeric al categoriei ale cărei produse se listează. Omis sau null = tot catalogul, ca „Toate produsele" din magazin.
sort	string	optional	Cum se ordonează rezultatele: for_you, popular, cheap, expensive, newest. Implicit „for_you".
limit	integer	optional	Câte produse să întoarcă, între 1 și 20. Implicit 10.
offset	integer	optional	Câte produse se omit de la începutul listei, pentru paginare. Implicit 0.

Raw schema

{
  "type": "object",
  "properties": {
    "category_id": {
      "default": null,
      "description": "ID-ul numeric al categoriei ale cărei produse se listează. Omis sau null = tot catalogul, ca „Toate produsele\" din magazin.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "sort": {
      "default": "for_you",
      "description": "Cum se ordonează rezultatele: for_you, popular, cheap, expensive, newest. Implicit „for_you\".",
      "type": "string",
      "enum": [
        "for_you",
        "popular",
        "cheap",
        "expensive",
        "newest"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Câte produse să întoarcă, între 1 și 20. Implicit 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "offset": {
      "default": 0,
      "description": "Câte produse se omit de la începutul listei, pentru paginare. Implicit 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_product

Î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.

Parameters1

slug

string

required

Slug-ul produsului, exact cel întors de search_products sau cel din URL-ul fișei (ex. „ace-cartus-0-30-rl"), fără prefixul /product/.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Slug-ul produsului, exact cel întors de search_products sau cel din URL-ul fișei (ex. „ace-cartus-0-30-rl\"), fără prefixul /product/."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_checkout

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.

Parameters1

items

array

required

Coșul de cumpărat: cel puțin un produs, maximum 20 linii.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Identificatorul numeric stabil al produsului, ca cel întors de search_products."
          },
          "variant_id": {
            "default": null,
            "description": "Varianta aleasă a produsului, sau null dacă produsul nu are variante.",
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9999,
            "description": "Cantitatea cerută din acest produs. Minim 1 — un coș nu poate avea o cantitate zero sau negativă — și maximum 9999."
          },
          "options": {
            "default": {},
            "description": "Opțiuni alese pentru produs, ca pereche nume-valoare (ex. {\"culoare\":\"negru\"}), dacă produsul are. Cel mult 20 opțiuni; numele până la 64 caractere, valoarea până la 200.",
            "type": "object",
            "propertyNames": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "additionalProperties": {
              "type": "string",
              "maxLength": 200
            }
          }
        },
        "required": [
          "product_id",
          "qty"
        ]
      },
      "description": "Coșul de cumpărat: cel puțin un produs, maximum 20 linii."
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

README.md7 KBView on GitHub

TATUAT.RO — server 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.

🟢 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.

Ce poate face un agent

Tool	Ce face
`search_products`	Caută după nume, brand sau tip de produs. Întoarce preț în RON, disponibilitate și link direct la fișă.
`browse_category`	O pagină de produse dintr-o categorie (sau din tot catalogul), cu sortare.
`get_product`	Fișa completă: descriere, preț efectiv, preț dinainte de reducere, brand, variante cu preț și stoc propriu.
`get_stock`	Disponibilitatea reală pentru o cantitate cerută. Patru stări: integral, parțial, pe comandă, indisponibil.
`calculate_shipping`	Cost de transport, pragul de transport gratuit și cadourile atinse la prag.
`create_checkout`	Link semnat către coșul de pe tatuat.ro. Valabil 15 minute.

Primele cinci sunt read-only — nu scriu nimic. Al șaselea generează doar un link; nu plasează comanda și nu atinge baza de date.

Exemplu

— Am nevoie de cartușe 0.30 RL, vreo 20 de bucăți. Cât mă costă cu transport?

Agentul apelează search_products → 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.

Cum îl conectezi

Claude Code

bash

claude mcp add --transport http tatuat https://api.tatuat.ro/mcp

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țuri și monedă

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 ca agentul să spună „de la X RON", nu „X RON".

Ce NU face

Nu scrie nimic în baza de date. Niciun tool nu mutează stare.
Nu ține coș pe server. Coșul trăiește pe tatuat.ro.
Nu autentifică utilizatori. OAuth e fază ulterioară.
Nu procesează plăți. Checkout-ul se finalizează pe tatuat.ro — cerință explicită OpenAI pentru plugin-uri („external checkout").
Linkul de checkout nu conține prețuri. Transportă doar intenția (produs, variantă, cantitate); prețul final se calculează și se confirmă pe site.

Pentru dezvoltatori

Rute

Rută	Metode	Ce face
`/mcp`	POST, GET, DELETE	Endpointul MCP. Toate trei delegate pachetului, ca 405-ul să vină de la protocol, nu de la Next.
`/.well-known/mcp-server-card.json`	GET	Cartea de vizită a serverului.
`/.well-known/openai-apps-challenge`	GET	Verificarea proprietății domeniului. Întoarce doar tokenul din `OPENAI_APPS_CHALLENGE_TOKEN`; 404 dacă lipsește.

Allowlist de gazde

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:

Un URL de preview Vercel primește 403 — nu e în allowlist. Adaugă hostul în 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.
Validarea e port-agnostică și normalizează majusculele.

Refuzul are formă JSON-RPC cu status 403, nu HTML — un client MCP îl poate parsa.

Variabile de mediu

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.

Variabilă	Obligatorie	Notă
`SUPABASE_URL`	da	PostgREST, server-to-server
`SUPABASE_ANON_KEY`	da	Cheia anon, nu `service_role`: tot ce citesc tool-urile e deja public prin RLS
`AGENT_CHECKOUT_SECRET`	pentru `create_checkout`	Aceeași valoare și în proiectul site-ului
`MCP_ALLOWED_HOSTS`	nu	Implicit `api.tatuat.ro`. Listă separată prin virgulă
`TATUAT_SITE_URL`	nu	Implicit `https://tatuat.ro`
`OPENAI_APPS_CHALLENGE_TOKEN`	la submission	Dat de portalul OpenAI

Arhitectură

Logica în .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.
Fără @supabase/supabase-js. Acces direct pe PostgREST cu fetch — CORS e o restricție de browser, nu se aplică server-to-server.
Rate limiting singleton la nivel de modul. 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.
RO-only deliberat. p_lang nu se trimite, deci produsele doar-Ungaria nu apar. Fail-closed.
Proiect separat de magazin, ca un tool schimbat să nu ceară redeploy al site-ului.

Comenzi

bash

npm run test           # node --test pe src/mcp, src/mcp/tools, src/well-known
npm run typecheck      # tsc --noEmit — vede și .mjs (checkJs + include)
npm run test:critical  # ambele
npm run dev            # Next dev pe :3000
npm run build          # next build

Gardă înainte de push

bash

git config core.hooksPath .githooks

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.

Install

Tools (6)

search_productscalculate_shippingget_stockbrowse_categoryget_productcreate_checkout

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.tatuat.ro/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tatuat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.tatuat.ro/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.estartoken/tatuat-mcp (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_products

calculate_shipping

get_stock

browse_category

get_product

create_checkout

TATUAT.RO — server MCP

Ce poate face un agent

Exemplu

Cum îl conectezi

Prețuri și monedă

Ce NU face

Pentru dezvoltatori

Rute

Allowlist de gazde

Variabile de mediu

Arhitectură

Comenzi

Gardă înainte de push

Install

Remote endpoint

Related servers