elo-skills-mcp 1.0.0 → 2.0.1

package/LICENSE.md

@@ -0,0 +1,78 @@
+# Licença de Uso — Time ELO (`elo-skills-mcp`)
+
+Copyright © 2026 Ramonnielly Silva Morais. Todos os direitos reservados.
+
+Este é um software comercial. O pacote `elo-skills-mcp` e o Método ELO Criativo
+que ele acessa são propriedade de Ramonnielly Silva Morais e estão protegidos
+pela Lei nº 9.610/1998 (Direitos Autorais) e pela Lei nº 9.609/1998 (Programa
+de Computador).
+
+Adquira uma licença em https://www.elosense.com.br/tools
+
+---
+
+## 1. Concessão
+
+Mediante aquisição de uma chave de licença válida (`ELO_LICENSE_KEY`), a titular
+concede a você uma licença **pessoal, intransferível, não exclusiva e revogável**
+para instalar e executar este pacote, e para usar os resultados por ele gerados,
+inclusive para fins comerciais próprios ou de seus clientes.
+
+A licença vigora enquanto a chave estiver ativa e dentro do limite de
+dispositivos contratado.
+
+## 2. Restrições
+
+Sem autorização prévia e por escrito da titular, você **não pode**:
+
+- redistribuir, revender, sublicenciar, alugar, emprestar ou disponibilizar o
+  pacote a terceiros, no todo ou em parte;
+- compartilhar, publicar ou transferir sua chave de licença;
+- copiar, extrair, armazenar ou republicar os prompts, templates, rubricas e
+  demais conteúdos do Método ELO Criativo servidos pela API;
+- contornar, desabilitar ou interferir na validação de licença, no controle de
+  dispositivos ou em qualquer mecanismo técnico de proteção;
+- descompilar, desmontar ou fazer engenharia reversa do pacote ou da API, salvo
+  na medida expressamente autorizada por lei;
+- usar o pacote para treinar, ajustar ou avaliar modelos de aprendizado de
+  máquina, ou para construir produto ou serviço concorrente;
+- remover ou alterar avisos de autoria, marca ou licença.
+
+## 3. Propriedade
+
+O software é licenciado, não vendido. Todos os direitos não concedidos
+expressamente permanecem com a titular. O Método ELO Criativo, o C.R.I.A., o
+Efeito-Vórtice e demais denominações e frameworks autorais são de titularidade
+exclusiva de Ramonnielly Silva Morais.
+
+O conteúdo que **você** produz com o auxílio das ferramentas é seu.
+
+## 4. Dados e funcionamento
+
+O pacote valida a licença a cada chamada e registra uso para fins de segurança,
+suporte e controle de dispositivos. Os templates do método não são gravados em
+disco: ficam em memória durante a sessão. Sem validação bem-sucedida em até 72
+horas, a execução é bloqueada.
+
+## 5. Vigência e rescisão
+
+Esta licença termina automaticamente em caso de descumprimento de qualquer
+cláusula, sem prejuízo das medidas cabíveis. Encerrada a licença, cesse o uso e
+desinstale o pacote.
+
+## 6. Garantias e responsabilidade
+
+O software é fornecido "no estado em que se encontra", sem garantias de
+adequação a uma finalidade específica ou de operação ininterrupta. Na máxima
+extensão permitida em lei, a responsabilidade da titular fica limitada ao valor
+efetivamente pago pela licença nos 12 meses anteriores ao evento.
+
+## 7. Foro
+
+Aplica-se a legislação brasileira. Fica eleito o foro da comarca de João
+Pessoa/PB para dirimir controvérsias.
+
+---
+
+Dúvidas sobre licenciamento, uso em equipe ou condições especiais:
+**contato@ramonniellymorais.com.br**

package/README.md

@@ -0,0 +1,58 @@
+# Time ELO — `elo-skills-mcp`
+
+**O Método ELO Criativo dentro do seu Claude.** 14 agentes de estratégia de conteúdo — essência, branding, posicionamento, público, ideias, hooks, post, reels, carrossel, stories, legenda, storytelling, formatos, anúncios e análise de performance — escrevendo na sua voz, em português do Brasil.
+
+Criado por [Ramonnielly Morais](https://ramonniellymorais.com.br), estrategista de conteúdo e criadora do Método ELO Criativo (Essência · Ligação · Originalidade).
+
+> Produto de acesso pago. Requer uma **chave de licença** (`ELO_LICENSE_KEY`).
+> Adquira em **[elosense.com.br/tools](https://www.elosense.com.br/tools)** — R$ 447/ano.
+
+## Como usar (após a compra)
+
+Você recebe sua chave por e-mail com o passo a passo completo. Em resumo:
+
+```bash
+npm install -g elo-skills-mcp
+claude mcp add elo-skills --env ELO_LICENSE_KEY=SUA-CHAVE -- elo-skills-mcp
+```
+
+Reinicie o Claude Code e rode `elo_setup` para ensinar a sua marca aos agentes. Esse setup alimenta todos os outros — é o que faz a saída sair com a sua cara, e não com cara de IA genérica.
+
+Depois é só chamar o agente que resolve o seu problema do momento: `elo_post`, `elo_carrossel`, `elo_reels`, `elo_essencia`, `elo_analise`, e assim por diante.
+
+## Os 14 agentes
+
+| Frente | Agentes |
+|---|---|
+| **Marca** | essência · branding · posicionamento · público |
+| **Estratégia** | ideias · hooks · análise de performance |
+| **Peça** | post · reels · carrossel · stories · legenda |
+| **Estrutura** | storytelling · formatos |
+
+Mais o **Elo do Setup**, que aprende a sua marca e alimenta os 14, e as ferramentas de orquestração (`elo_criar` e `elo_gate`), que produzem em loop fechado e reprovam o que sai genérico.
+
+## Requisitos
+
+- [Claude Code](https://claude.ai/download)
+- [Node.js](https://nodejs.org) 18+
+- Conexão com a internet (os agentes validam a licença a cada uso)
+
+## Como funciona a proteção
+
+Este pacote é uma casca fina: traz apenas os metadados das ferramentas. O método
+não viaja no npm — cada agente busca o próprio template numa API autenticada, que
+valida a licença a cada chamada. O conteúdo fica em memória durante a sessão e
+nunca é gravado em disco.
+
+## Licença
+
+Software comercial. Uso pessoal mediante chave de licença válida. Redistribuição,
+revenda e engenharia reversa não autorizadas. Ver [LICENSE.md](./LICENSE.md).
+
+## Suporte
+
+Dúvida ou erro? **contato@ramonniellymorais.com.br**
+
+---
+
+© 2026 Ramonnielly Silva Morais — Método ELO Criativo.

package/package.json

@@ -1,12 +1,18 @@
 {
   "name": "elo-skills-mcp",
-  "version": "1.0.0",
-  "description": "Método ELO Criativo — Skills de Estratégia de Conteúdo para Claude",
+  "version": "2.0.1",
+  "description": "Time ELO — 14 agentes de estratégia de conteúdo do Método ELO Criativo, dentro do Claude. Escrevem na sua voz, em português do Brasil.",
   "main": "index.js",
   "type": "module",
   "bin": {
     "elo-skills-mcp": "index.js"
   },
+  "files": [
+    "index.js",
+    "src/",
+    "README.md",
+    "LICENSE.md"
+  ],
   "scripts": {
     "start": "node index.js",
     "dev": "node --watch index.js"
@@ -16,13 +22,44 @@
   },
   "keywords": [
     "mcp",
+    "model-context-protocol",
     "claude",
+    "claude-code",
+    "time-elo",
+    "elo",
+    "metodo-elo-criativo",
+    "agentes",
+    "agents",
+    "ia",
+    "ai",
+    "marketing",
+    "content-strategy",
+    "estrategia-de-conteudo",
     "conteudo",
-    "estrategia",
-    "elo"
+    "copywriting",
+    "brand-voice",
+    "voz-de-marca",
+    "storytelling",
+    "instagram",
+    "portugues",
+    "pt-br",
+    "brasil"
   ],
-  "author": "Ramonnielly Silva Morais",
-  "license": "UNLICENSED",
+  "author": {
+    "name": "Ramonnielly Silva Morais",
+    "email": "contato@ramonniellymorais.com.br",
+    "url": "https://ramonniellymorais.com.br"
+  },
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://www.elosense.com.br/tools",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramonniellymorais/elo-skills-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ramonniellymorais/elo-skills-mcp/issues",
+    "email": "contato@ramonniellymorais.com.br"
+  },
   "engines": {
     "node": ">=18.0.0"
   }

package/src/api-client.js

@@ -0,0 +1,90 @@
+// Cliente da API de prompts do Método ELO.
+// O método NÃO viaja no pacote npm: cada tool busca seu template aqui,
+// numa API autenticada que valida a licença server-side.
+//
+// Cache só em memória (some ao fechar o Claude) — nunca grava o método em disco.
+// Fallback offline limitado: usa cache em RAM por até HARD_OFFLINE_LIMIT desde a
+// última validação online bem-sucedida; passado esse limite, bloqueia mesmo offline.
+
+import { getDeviceHash, getDeviceLabel } from './device.js'
+
+const API_URL = process.env.ELO_API_URL || 'https://elo-skills-mcp.vercel.app'
+const TEMPLATE_TTL = 1000 * 60 * 20            // 20 min de cache em RAM por tool
+const HARD_OFFLINE_LIMIT = 1000 * 60 * 60 * 72 // 72h sem validação online → bloqueia
+
+const PURCHASE_URL = 'elosense.com.br/tools'
+const SUPPORT_EMAIL = 'contato@ramonniellymorais.com.br'
+
+const templateCache = new Map() // toolName -> { template, ts }
+let lastOnlineOk = 0
+
+export async function fetchTemplate(toolName) {
+  const key = process.env.ELO_LICENSE_KEY
+  if (!key) throw new Error(missingKeyMessage())
+
+  const now = Date.now()
+  const cached = templateCache.get(toolName)
+  if (cached && now - cached.ts < TEMPLATE_TTL) return cached.template
+
+  try {
+    const res = await fetch(`${API_URL}/api/tool`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${key}`
+      },
+      body: JSON.stringify({
+        tool: toolName,
+        device_hash: getDeviceHash(key),
+        device_label: getDeviceLabel()
+      })
+    })
+
+    if (res.status === 401 || res.status === 403) {
+      const { reason } = await safeJson(res)
+      throw new Error(licenseError(reason))
+    }
+    if (res.status === 429) {
+      throw new Error('❌ Muitas requisições em pouco tempo. Aguarde alguns minutos e tente de novo.')
+    }
+    if (!res.ok) throw new Error(`Erro ${res.status} ao buscar a skill.`)
+
+    const data = await safeJson(res)
+    if (!data.template) throw new Error('Resposta inválida do servidor.')
+
+    templateCache.set(toolName, { template: data.template, ts: now })
+    lastOnlineOk = now
+    return data.template
+
+  } catch (err) {
+    if (err.message?.startsWith('❌')) throw err
+    // Falha de rede: usa cache em RAM se ainda dentro da janela offline
+    if (cached && now - lastOnlineOk < HARD_OFFLINE_LIMIT) return cached.template
+    throw new Error('❌ Sem conexão com o servidor das skills ELO. Verifique sua internet e tente de novo.')
+  }
+}
+
+function missingKeyMessage() {
+  return (
+    '❌ Licença não encontrada.\n\n' +
+    'Adicione sua chave de licença no arquivo de configuração do Claude Code:\n\n' +
+    '"ELO_LICENSE_KEY": "SUA-CHAVE-AQUI"\n\n' +
+    `Adquira sua licença em: ${PURCHASE_URL}`
+  )
+}
+
+function licenseError(reason) {
+  switch (reason) {
+    case 'not_found':        return `❌ Chave de licença inválida. Verifique a chave ou adquira em ${PURCHASE_URL}`
+    case 'revoked':          return `❌ Sua licença foi revogada. Entre em contato: ${SUPPORT_EMAIL}`
+    case 'refunded':         return '❌ Esta licença foi reembolsada e está inativa.'
+    case 'expired':          return `❌ Sua licença expirou. Renove em ${PURCHASE_URL}`
+    case 'suspended':        return `❌ Sua licença está suspensa. Entre em contato: ${SUPPORT_EMAIL}`
+    case 'too_many_devices': return `❌ Limite de dispositivos atingido para esta licença. Entre em contato: ${SUPPORT_EMAIL}`
+    default:                 return `❌ Não foi possível validar sua licença. Adquira ou renove em ${PURCHASE_URL}`
+  }
+}
+
+async function safeJson(res) {
+  try { return await res.json() } catch { return {} }
+}

package/src/device.js

@@ -0,0 +1,35 @@
+// Identidade de dispositivo para binding de licença.
+// Gera um id estável por máquina (guardado em ~/.elo/device.json) e
+// só envia ao servidor o HASH combinado com a chave — nunca o id cru.
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs'
+import { homedir, hostname } from 'os'
+import { join } from 'path'
+import { createHash, randomUUID } from 'crypto'
+
+const ELO_DIR = join(homedir(), '.elo')
+const DEVICE_PATH = join(ELO_DIR, 'device.json')
+
+function getDeviceId() {
+  if (!existsSync(ELO_DIR)) mkdirSync(ELO_DIR, { recursive: true })
+  if (existsSync(DEVICE_PATH)) {
+    try {
+      const saved = JSON.parse(readFileSync(DEVICE_PATH, 'utf-8'))
+      if (saved.id) return saved.id
+    } catch { /* recria abaixo */ }
+  }
+  const id = randomUUID()
+  writeFileSync(DEVICE_PATH, JSON.stringify({ id, created_at: new Date().toISOString() }, null, 2))
+  return id
+}
+
+// Hash estável do dispositivo combinado com a chave. O servidor limita
+// quantos hashes distintos uma licença pode ter (max_activations).
+export function getDeviceHash(licenseKey) {
+  return createHash('sha256').update(`${getDeviceId()}:${licenseKey}`).digest('hex')
+}
+
+// Rótulo amigável só para suporte ("MacBook da Ramon"). Não identifica de forma única.
+export function getDeviceLabel() {
+  try { return hostname() } catch { return 'unknown' }
+}

package/src/license.js

@@ -1,66 +1,18 @@
-// Validação de licença via Supabase
-// Tabela: licenses (key TEXT, active BOOLEAN, expires_at TIMESTAMPTZ, owner_name TEXT)
+// Checagem local mínima: só confirma que a chave está presente.
+// A validação REAL (ativa / expirada / revogada / dispositivos) acontece
+// server-side, na API de prompts, a cada chamada de tool. Nenhuma URL ou
+// chave de Supabase vive mais no pacote.
 
-const SUPABASE_URL = 'https://dzicopswqijljhrimtee.supabase.co'
-const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImR6aWNvcHN3cWlqbGpocmltdGVlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzU2NzExNjUsImV4cCI6MjA5MTI0NzE2NX0.JgL9jhJIxqQLm8aeKNLKh8HOS2idGqUOslwAqJUMoaY'
+const PURCHASE_URL = 'elosense.com.br/tools'
 
-let cache = null
-let cacheTime = 0
-const CACHE_TTL = 1000 * 60 * 60 // 1 hora
-
-export async function validateLicense() {
+export function assertLicensePresent() {
   const key = process.env.ELO_LICENSE_KEY
-
   if (!key) {
     throw new Error(
       '❌ Licença não encontrada.\n\n' +
       'Adicione sua chave de licença no arquivo de configuração do Claude Code:\n\n' +
       '"ELO_LICENSE_KEY": "SUA-CHAVE-AQUI"\n\n' +
-      'Adquira sua licença em: ramonniellymorais.com.br/elo-skills'
+      `Adquira sua licença em: ${PURCHASE_URL}`
     )
   }
-
-  // Cache válido — não bate no Supabase a cada chamada
-  const now = Date.now()
-  if (cache && now - cacheTime < CACHE_TTL) return cache
-
-  try {
-    const res = await fetch(
-      `${SUPABASE_URL}/rest/v1/licenses?key=eq.${encodeURIComponent(key)}&select=active,expires_at,owner_name`,
-      {
-        headers: {
-          'apikey': SUPABASE_ANON_KEY,
-          'Authorization': `Bearer ${SUPABASE_ANON_KEY}`
-        }
-      }
-    )
-
-    if (!res.ok) throw new Error('Erro ao verificar licença.')
-
-    const data = await res.json()
-
-    if (!data.length) {
-      throw new Error('❌ Chave de licença inválida. Verifique a chave ou adquira em ramonniellymorais.com.br/elo-skills')
-    }
-
-    const license = data[0]
-
-    if (!license.active) {
-      throw new Error('❌ Sua licença está desativada. Entre em contato: contato@ramonniellymorais.com.br')
-    }
-
-    if (license.expires_at && new Date(license.expires_at) < new Date()) {
-      throw new Error('❌ Sua licença expirou. Renove em ramonniellymorais.com.br/elo-skills')
-    }
-
-    cache = license
-    cacheTime = now
-    return license
-
-  } catch (err) {
-    if (err.message.startsWith('❌')) throw err
-    // Fallback offline: se Supabase estiver fora, usa cache anterior
-    if (cache) return cache
-    throw new Error('❌ Não foi possível verificar a licença. Verifique sua conexão.')
-  }
 }

package/src/make-tool.js

@@ -0,0 +1,32 @@
+// Fábrica de tools "finas". Os metadados (name/description/inputSchema) ficam
+// locais e públicos — o MCP precisa deles para listar. O TEMPLATE do método é
+// buscado na API autenticada em runtime e renderizado em memória com o contexto
+// de marca local (que nunca vai ao servidor).
+
+import { getBrandConfig, formatBrandContext } from './brand.js'
+import { fetchTemplate } from './api-client.js'
+import { renderTemplate } from './render.js'
+
+function resolveContext(marca) {
+  const config = getBrandConfig(marca || 'minha-marca')
+  if (!config) {
+    return `⚠️ Marca "${marca || 'minha-marca'}" não configurada. Use elo_setup primeiro.`
+  }
+  return formatBrandContext(config)
+}
+
+export function makeTool({ name, description, inputSchema, prepare }) {
+  return {
+    name,
+    description,
+    inputSchema,
+    handler: async (args = {}) => {
+      const { marca, ...params } = args
+      const ctx = resolveContext(marca)
+      const data = prepare ? prepare(params) : params
+      const template = await fetchTemplate(name) // valida licença server-side; lança erro amigável
+      const body = renderTemplate(template, data)
+      return { content: [{ type: 'text', text: `${ctx}\n\n---\n\n${body}` }] }
+    }
+  }
+}

package/src/render.js

@@ -0,0 +1,32 @@
+// Renderizador leve estilo mustache para os templates do método.
+// Suporta:
+//   {{var}}            → substitui pelo valor (vazio se ausente)
+//   {{#var}}...{{/var}} → inclui o bloco só se var for "verdadeiro"
+//   {{^var}}...{{/var}} → inclui o bloco só se var for "falso" (else)
+//
+// Os templates vêm da API autenticada; o cliente injeta os params aqui,
+// em memória, e nunca grava o método em disco.
+
+function isTruthy(v) {
+  if (Array.isArray(v)) return v.length > 0
+  return v !== undefined && v !== null && v !== '' && v !== false && v !== 0
+}
+
+export function renderTemplate(template, data = {}) {
+  // Seções (normais e invertidas) — resolvidas primeiro
+  let out = template.replace(
+    /\{\{([#^])(\w+)\}\}([\s\S]*?)\{\{\/\2\}\}/g,
+    (_, kind, key, inner) => {
+      const show = kind === '#' ? isTruthy(data[key]) : !isTruthy(data[key])
+      return show ? inner : ''
+    }
+  )
+
+  // Variáveis simples
+  out = out.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+    const v = data[key]
+    return v === undefined || v === null ? '' : String(v)
+  })
+
+  return out
+}

package/src/server.js

@@ -1,7 +1,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js'
-import { validateLicense } from './license.js'
+import { assertLicensePresent } from './license.js'
 import * as tools from './tools/index.js'
 
 // Lista de todas as ferramentas registradas
@@ -9,7 +9,7 @@ const ALL_TOOLS = Object.values(tools)
 
 export async function createServer() {
   const server = new Server(
-    { name: 'elo-skills-mcp', version: '1.0.0' },
+    { name: 'elo-skills-mcp', version: '2.0.0' },
     { capabilities: { tools: {} } }
   )
 
@@ -26,12 +26,13 @@ export async function createServer() {
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params
 
-    // Valida licença antes de qualquer execução
-    // Setup é liberado sem licença para facilitar o onboarding
+    // Checagem local de presença da chave antes de qualquer execução.
+    // A validação real (ativa/expirada/revogada) é server-side, na API de prompts.
+    // Setup é liberado sem licença para facilitar o onboarding.
     const FREE_TOOLS = ['elo_setup']
     if (!FREE_TOOLS.includes(name)) {
       try {
-        await validateLicense()
+        assertLicensePresent()
       } catch (err) {
         return {
           content: [{ type: 'text', text: err.message }],