{
  "$schema": "https://modelcontextprotocol.io/schema/server-card.json",
  "serverInfo": {
    "name": "howmuchme-server",
    "version": "1.4.0",
    "title": "HowMuchMe MCP Server",
    "description": "Knowledge, price estimation, and quote request deep-link provider for Italian home renovation, maintenance, and professional services."
  },
  "name": "howmuchme-server",
  "version": "1.4.0",
  "title": "HowMuchMe MCP Server",
  "description": "Knowledge, price estimation, and quote request deep-link provider for Italian home renovation, maintenance, and professional services.",
  "capabilities": {
    "resources": true,
    "tools": true,
    "prompts": false
  },
  "resources": [
    {
      "uri": "https://www.howmuchme.com/ai-agents",
      "name": "HowMuchMe Technical Documentation for AI Agents (HTML)",
      "mimeType": "text/html; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/llms.txt",
      "name": "HowMuchMe AI Index & Summary",
      "mimeType": "text/plain; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/llms-full.txt",
      "name": "HowMuchMe Full Knowledge Base & 2026 Price Guide",
      "mimeType": "text/plain; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/llms-action.txt",
      "name": "HowMuchMe Action Deep-Link Specifications",
      "mimeType": "text/plain; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/catalogo-lavorazioni.json",
      "name": "HowMuchMe Canonical Category & Job Catalog (JSON)",
      "mimeType": "application/json; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/openapi.json",
      "name": "HowMuchMe OpenAPI Specification",
      "mimeType": "application/json; charset=utf-8"
    },
    {
      "uri": "https://www.howmuchme.com/sitemap.xml",
      "name": "HowMuchMe Sitemap",
      "mimeType": "application/xml; charset=utf-8"
    }
  ],
  "tools": [
    {
      "name": "precompila_preventivo",
      "description": "Genera e restituisce l'URL del deep-link precompilato per la richiesta di preventivo gratuito su HowMuchMe (Web App a 4 step con Step 3 precompilato per revisione e invio finale). Non effettua chiamate transazionali dirette né invia preventivi in background: produce l'URL strutturato da proporre all'utente per la revisione e conferma umana.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "categoriaId": {
            "type": "integer",
            "description": "ID numerico della categoria/lavorazione presente nel catalogo canonico (es. 201 Rifacimento Bagno, 506 Infissi, 601 Elettrico, 1002 App Mobile, 1410 Investigatore Privato, vedi catalogo-lavorazioni.json)"
          },
          "citta": {
            "type": "string",
            "description": "Nome del comune o città italiana dove eseguire il lavoro"
          },
          "cap": {
            "type": "string",
            "description": "CAP di 5 cifre numeriche coerente con la città. Se l'utente specifica un CAP (quartiere o frazione), mantenere esattamente quello fornito senza sostituirlo con il CAP generico del capoluogo."
          },
          "titolo": {
            "type": "string",
            "maxLength": 120,
            "description": "Titolo breve della richiesta (max 120 caratteri)"
          },
          "descrizione": {
            "type": "string",
            "maxLength": 3000,
            "description": "Descrizione estesa delle opere, materiali o dettagli tecnici (max 3000 caratteri)"
          },
          "metriQuadri": {
            "type": "number",
            "description": "Metratura stimata in mq"
          },
          "esecuzioneId": {
            "type": "integer",
            "description": "Tempistica: 1=Urgente (48h), 2=Entro 1 settimana, 3=Entro 1 mese, 4=Entro 3 mesi, 5=Flessibile"
          },
          "preferenzaId": {
            "type": "integer",
            "description": "Criterio di selezione: 1=Qualità prima del prezzo, 2=Miglior rapporto qualità/prezzo, 3=Prezzo più basso, 4=Esperienza/Referenze, 5=Prossimità"
          },
          "ai": {
            "type": "integer",
            "enum": [
              1
            ],
            "default": 1,
            "description": "Flag obbligatorio che identifica le richieste generate da assistenti AI (valore 1)"
          }
        },
        "required": [
          "categoriaId",
          "titolo",
          "descrizione",
          "ai"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL completo del deep-link precompilato verso la Web App HowMuchMe (https://app.howmuchme.com/richiesta/nuova?...)"
          }
        },
        "required": [
          "url"
        ]
      }
    }
  ]
}
