# StencilVector

> Piattaforma SaaS che converte immagini in stencil vettoriali pronti per taglio laser. Materiali supportati: plastica flessibile (PET) e metallo rigido (INOX).

## MCP Server

- **Endpoint**: https://stencilvector.com/mcp/
- **Transport**: Streamable HTTP
- **Auth**: Bearer token utente (genera da /settings/mcp dopo login)
- **Docs MCP**: https://stencilvector.com/mcp

## REST Agent API (alternativa a MCP, plain HTTP)

Per agenti che non hanno client MCP installato (es. fetch da artifact, curl, qualunque LLM con tool-use HTTP):

- **Discovery**: `GET https://stencilvector.com/api/agent` — lista tool con schema input
- **Call**: `POST https://stencilvector.com/api/agent/<tool_name>` — body JSON con argomenti
- **Auth**: stesso Bearer token dell'MCP (`Authorization: Bearer svm_...`)
- **CORS**: aperto da qualsiasi origin (Bearer = no rischio cross-origin)
- **Tool pubblici**: chiamabili senza Authorization header

Esempio:
```
curl -X POST https://stencilvector.com/api/agent/get_pricing   -H "Content-Type: application/json" -d "{}"
```

## Tools disponibili

### Pubblici (no auth)
- list_pages, get_page — pagine CMS
- list_articles, get_article — blog
- list_faqs — FAQ
- get_pricing — pacchetti credit
- get_methods — metodi conversione BW
- get_materials — materiali (flessibile/rigido)
- list_samples — sample gallery
- list_gallery, get_gallery_stencil — galleria stencil pubblici
- submit_contact — form contatti anonimo
- search_content — ricerca globale pagine+blog+faq
- request_magic_link — invia magic link login
- request_api_key — invia all'utente il link per generare la sua API key (self-service)
- start_stencil_from_url — crea uno stencil da URL immagine HTTPS, ritorna magic_link
- start_stencil_from_base64 — crea uno stencil da immagine base64/data URL
- get_stencil_status — stato elaborazione di uno stencil
- get_stencil_previews — anteprime dei metodi di conversione BW
- get_tattoo_status — stato estrazione tattoo; quando ready ritorna preview_url + ar_try_on_link
- get_tattoo_ar_link — link AR try-on per provare un design tattoo sulla pelle in fotocamera

### Autenticati (Bearer token)
- me — profilo utente corrente
- my_credits — saldo + transazioni
- my_stencils — i miei stencil
- my_invoices — fatture
- my_tickets, get_ticket — ticket support
- send_message — invia messaggio/contatto
- download_stencil — scarica SVG/PNG di uno stencil pronto (1 credito; il primo del giorno e' gratis, ogni download sblocca lo stencil per sempre)
- buy_credits — checkout Stripe per pacchetto crediti
- extract_tattoo_stencil — estrae il design di un tatuaggio da una foto via AI (1 credito)

## Come ottenere una API key (e provare gratis)

I tool read-only sono liberi. I tool a crediti (extract_tattoo_stencil, download_stencil, ...)
richiedono una API key legata a un account:

1. Chiama `request_api_key(email)` con l'email dell'utente
2. L'utente clicca il link ricevuto: se non ha un account viene creato automaticamente
   **con un credito omaggio di benvenuto** (per provare un tool a pagamento)
3. L'utente atterra sulla pagina API key, genera il token `svm_...` e lo incolla all'agente
4. Usa il token come header `Authorization: Bearer svm_...` su /mcp/ e /api/agent
5. Ogni tool a crediti scala dal saldo dell'account; ricarica con `buy_credits`

Modello crediti stencil-maker: creare stencil e vedere le anteprime low-res
(`get_stencil_previews`) e' SEMPRE gratis. Il download del file finale SVG/PNG
(`download_stencil`) costa 1 credito
e ogni download sblocca quello stencil per sempre (ri-download gratuiti).

## Tattoo AR Try-On (flusso consigliato per agenti)

1. `extract_tattoo_stencil(image_url=..., mode="auto"|"color"|"bw")` — Bearer, 1 credito
2. Polla `get_tattoo_status(uuid)` finché `status=ready` → `preview_url` + `ar_try_on_link`
3. Condividi `ar_try_on_link` con l'utente: sul telefono apre la fotocamera con il design
   sovrapposto alla pelle (o su una foto del cliente), con condivisione WhatsApp e
   export PDF a scala reale per carta transfer (mirror, tiling multi-foglio, 203/300 dpi).

Hai già un design su questo dominio? `get_tattoo_ar_link(design_path)` genera il link AR diretto.

## Pagine principali

- [Home](https://stencilvector.com/)
- [Stencil Maker](https://stencilvector.com/stencil-maker)
- [Tattoo Stencil + AR Try-On](https://stencilvector.com/tattoo-stencil)
- [Pricing](https://stencilvector.com/pricing)
- [FAQ](https://stencilvector.com/faq)
- [Privacy](https://stencilvector.com/privacy)
- [Terms](https://stencilvector.com/terms)
- [Contact](https://stencilvector.com/contact)

## Contatti

- Email: info@stencilvector.com
- Per agenti AI: usare il tool `send_message` via MCP con token valido

## Note

- Stripe Tax aggiunge IVA italiana 22% al checkout per clienti EU
- Creare stencil e vedere le anteprime e' gratis; il download del file finale consuma 1 credito (sblocco permanente per stencil)
- API REST classica disponibile su https://stencilvector.com/api/* — vedi /docs per OpenAPI