{
  "$schema": "https://modelcontextprotocol.io/schema/mcp-server-manifest.json",
  "name": "transforma-franquias-agent-tools",
  "version": "2.4.0",
  "description": "Manifesto de Ferramentas para Agentes de IA e LLMs da Transforma Franquias (Agent Tool Manifest). Fornece ferramentas HTTP/REST para cálculo de score de franqueabilidade, auditoria jurídica sob a Lei 13.966/2019, simulação financeira de redes e consulta de geomarketing.",
  "homepage": "https://transformafranquias.com.br/agentes",
  "tools": [
    {
      "name": "calculate_franchisability_score",
      "description": "Calcula o score de maturidade e franqueabilidade de uma empresa (0-100) com base nos 8 pilares oficiais da Transforma Franquias.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "businessName": { "type": "string", "description": "Nome da empresa avaliada" },
          "yearsInOperation": { "type": "number", "description": "Anos de operação da unidade piloto" },
          "monthlyRevenueAverage": { "type": "number", "description": "Faturamento médio mensal em Reais (BRL)" },
          "netMarginPercentage": { "type": "number", "description": "Margem líquida percentual (ex: 22 para 22%)" },
          "processesStandardized": { "type": "string", "enum": ["total", "parcial", "nenhuma"], "description": "Grau de formalização e manuais de processos" },
          "founderDependency": { "type": "string", "enum": ["baixa", "media", "alta"], "description": "Dependência da operação em relação ao fundador" },
          "inpiStatus": { "type": "string", "enum": ["registrado", "depositado", "nenhum"], "description": "Situação do registro da marca no INPI" },
          "segment": { "type": "string", "description": "Segmento de mercado (ex: alimentacao, estetica, saude)" }
        },
        "required": ["yearsInOperation", "monthlyRevenueAverage", "netMarginPercentage"]
      }
    },
    {
      "name": "simulate_franchise_financials",
      "description": "Simula os parâmetros econômico-financeiros para franqueadora e franqueado (taxa de franquia, royalties, fundo de marketing, payback e margem líquida).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "monthlyRevenueAverage": { "type": "number", "description": "Faturamento bruto mensal estimado da unidade" },
          "netMarginAverage": { "type": "number", "description": "Margem líquida operacional antes dos royalties (%)" },
          "initialSetupCost": { "type": "number", "description": "Custo de montagem física e equipamentos (BRL)" },
          "segment": { "type": "string", "description": "Segmento de atuação (ex: alimentacao, servicos, saude)" }
        },
        "required": ["monthlyRevenueAverage", "netMarginAverage", "initialSetupCost"]
      }
    },
    {
      "name": "audit_cof_compliance_lei13966",
      "description": "Audita os itens obrigatórios de uma Circular de Oferta de Franquia (COF) e valida o cumprimento do prazo decadencial de 10 dias da Lei Federal nº 13.966/2019.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "deliveredDaysBeforeContract": { "type": "number", "description": "Dias corridos entre a entrega da COF e a assinatura/pagamento" },
          "hasAuditedFinancialStatements2Years": { "type": "boolean", "description": "Possui balanços dos 2 últimos exercícios (Art. 2º, II)" },
          "hasInpiProcessNumber": { "type": "boolean", "description": "Contém situação e número do processo no INPI (Art. 2º, XIII)" },
          "hasCompleteFranchiseeList": { "type": "boolean", "description": "Lista de franqueados atuais e desligados nos últimos 24 meses (Art. 2º, IX e X)" },
          "hasTerritoryExclusivityDefined": { "type": "boolean", "description": "Regras claras de exclusividade e e-commerce (Art. 2º, XI e XII)" }
        },
        "required": ["deliveredDaysBeforeContract"]
      }
    },
    {
      "name": "get_regional_market_kpis",
      "description": "Retorna indicadores de geomarketing, faturamento do franchising, número de unidades e cidades prioritárias para qualquer um dos 27 estados do Brasil.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "uf": { "type": "string", "description": "Sigla do estado com 2 letras (ex: SP, RJ, MG, PR, SC, BA, GO)" }
        },
        "required": ["uf"]
      }
    },
    {
      "name": "query_franchising_rag",
      "description": "Consulta a base de conhecimento estruturada e diretrizes legais da Lei 13.966/2019 sobre formatação e expansão de redes de franquias.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Pergunta técnica sobre franquias, COF, contratos ou formatação" }
        },
        "required": ["query"]
      }
    }
  ],
  "endpoints": {
    "http": "https://transformafranquias.com.br/api/agent"
  }
}