funifier-mcp 0.2.28 → 0.3.1

package/skills/funifier/references/create-trigger.md

@@ -45,23 +45,23 @@ Note que `aggregate` é uma **string** contendo JSON serializado (com `\n` e `\"
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "trigger event groovy java before_create after_win entity script achievement_type context_extra bulk csv after_bulk before_bulk" --skill funifier-create-trigger
+```
+funifier_search_docs "trigger event groovy java before_create after_win entity script achievement_type context_extra bulk csv after_bulk before_bulk"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/trigger.md`
-- `datasource-funifier-docs/knowledge/guides/triggers-guide.md`
-- `datasource-funifier-docs/knowledge/guides/java-entities.md`
-- `datasource-funifier-docs/knowledge/guides/java-managers.md`
-- `datasource-funifier-docs/knowledge/guides/trigger-examples.md`
+- `funifier_read_doc path=modules/trigger`
+- `funifier_read_doc path=guides/triggers-guide`
+- `funifier_read_doc path=guides/java-entities`
+- `funifier_read_doc path=guides/java-managers`
+- `funifier_read_doc path=guides/trigger-examples`
 
 ## Steps
 
@@ -105,9 +105,9 @@ O Funifier **sempre salva o documento** antes de executar o trigger.
 
 ## Leituras obrigatórias (não condicionais — leia antes de escrever qualquer Groovy)
 
-- `datasource-funifier-docs/knowledge/guides/java-entities.md`
-- `datasource-funifier-docs/knowledge/guides/java-managers.md`
-- `datasource-funifier-docs/knowledge/guides/trigger-examples.md`
+- `funifier_read_doc path=guides/java-entities`
+- `funifier_read_doc path=guides/java-managers`
+- `funifier_read_doc path=guides/trigger-examples`
 
 ---
 
@@ -144,7 +144,7 @@ Se existir e estiver correto, parar — não recriar.
 ### 3. Ler documentação obrigatória
 
 Leia os três arquivos listados acima antes de escrever qualquer código.
-Use também `datasource-funifier-docs/knowledge/guides/trigger-examples.md` para encontrar o padrão mais próximo do requisito.
+Use também `funifier_read_doc path=guides/trigger-examples` para encontrar o padrão mais próximo do requisito.
 
 ### 4. Escrever o script Groovy
 

package/skills/funifier/references/create-virtual-good.md

@@ -6,20 +6,20 @@ Create a Funifier virtual good — catalog items players can purchase with point
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "virtual good item catalog store purchase marketplace shop" --skill funifier-create-virtual-good
+```
+funifier_search_docs "virtual good item catalog store purchase marketplace shop"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/virtual-good.md`
-- `datasource-funifier-docs/knowledge/modules/point.md`
+- `funifier_read_doc path=modules/virtual-good`
+- `funifier_read_doc path=modules/point`
 
 ## Steps
 

package/skills/funifier/references/create-webhook.md

@@ -6,19 +6,19 @@ Create a Funifier webhook — push real-time event payloads to external endpoint
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "webhook integration external push event outbound realtime" --skill funifier-create-webhook
+```
+funifier_search_docs "webhook integration external push event outbound realtime"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/webhook.md`
+- `funifier_read_doc path=modules/webhook`
 
 ## Steps
 
@@ -43,7 +43,7 @@ funifier_list type=webhook search=<descricao>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/webhook.md
+funifier_read_doc path=modules/webhook
 ```
 
 ### 3. Criar o webhook

package/skills/funifier/references/create-websocket.md

@@ -6,19 +6,19 @@ Create a Funifier websocket configuration — real-time bidirectional communicat
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "websocket realtime live chat competition feedback socket bidirectional" --skill funifier-create-websocket
+```
+funifier_search_docs "websocket realtime live chat competition feedback socket bidirectional"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/websocket.md`
+- `funifier_read_doc path=modules/websocket`
 
 ## Steps
 
@@ -39,7 +39,7 @@ funifier_list type=websocket
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/websocket.md
+funifier_read_doc path=modules/websocket
 ```
 
 ### 3. Criar a configuração de WebSocket
@@ -60,7 +60,7 @@ funifier_save type=websocket payload=<json>
 
 ### 4. Integrar no frontend
 
-Para consumir via JavaScript, use a URL de WebSocket do Funifier e autentique com o Bearer token do jogador. Consulte `datasource-funifier-docs/knowledge/modules/websocket.md` para o protocolo de conexão específico da sua versão.
+Para consumir via JavaScript, use a URL de WebSocket do Funifier e autentique com o Bearer token do jogador. Consulte `funifier_read_doc path=modules/websocket` para o protocolo de conexão específico da sua versão.
 
 ### 5. Validar
 

package/skills/funifier/references/create-widget.md

@@ -6,19 +6,19 @@ Create a Funifier widget — embeddable visual components (rankings, challenge l
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "widget embed visual ranking leaderboard component intranet integration display" --skill funifier-create-widget
+```
+funifier_search_docs "widget embed visual ranking leaderboard component intranet integration display"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/widget.md`
+- `funifier_read_doc path=modules/widget`
 
 ## Steps
 
@@ -41,7 +41,7 @@ funifier_list type=widget search=<nome>
 ### 2. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/widget.md
+funifier_read_doc path=modules/widget
 ```
 
 ### 3. Criar o widget no Studio

package/skills/funifier/references/debug.md

@@ -6,25 +6,25 @@ Debug a Funifier resource — systematic diagnosis of triggers, schedulers, aggr
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "debug error log exception timeout groovy stack trace fix" --skill funifier-debug
+```
+funifier_search_docs "debug error log exception timeout groovy stack trace fix"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/guides/java-libraries.md`
-- `datasource-funifier-docs/knowledge/modules/trigger.md`
-- `datasource-funifier-docs/knowledge/guides/triggers-guide.md`
-- `datasource-funifier-docs/knowledge/guides/trigger-examples.md`
-- `datasource-funifier-docs/knowledge/modules/scheduler.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/modules/public.md`
+- `funifier_read_doc path=guides/java-libraries`
+- `funifier_read_doc path=modules/trigger`
+- `funifier_read_doc path=guides/triggers-guide`
+- `funifier_read_doc path=guides/trigger-examples`
+- `funifier_read_doc path=modules/scheduler`
+- `funifier_read_doc path=guides/aggregates`
+- `funifier_read_doc path=modules/public`
 
 ## Steps
 
@@ -81,7 +81,7 @@ Compare com o que a documentação exige.
 ### 5. Ler a documentação primária do módulo
 
 Leia o arquivo de doc específico para o módulo com problema:
-- Trigger → `datasource-funifier-docs/knowledge/modules/trigger.md` + guides
-- Scheduler → `datasource-funifier-docs/knowledge/modules/scheduler.md`
-- Aggregate → `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- Security/Auth → `datasource-funifier-docs/knowledge/modules/security.md`
+- Trigger → `funifier_read_doc path=modules/trigger` + guides
+- Scheduler → `funifier_read_doc path=modules/scheduler`
+- Aggregate → `funifier_read_doc path=guides/aggregates`
+- Security/Auth → `funifier_read_doc path=modules/security`

package/skills/funifier/references/help.md

@@ -6,19 +6,19 @@ Get help with Funifier — routes to the right documentation or skill based on y
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "help documentation guide module question how what funifier" --skill funifier-help
+```
+funifier_search_docs "help documentation guide module question how what funifier"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/index.md`
+- `funifier_read_doc path=index`
 
 ## Steps
 
@@ -69,7 +69,7 @@ Perguntar: o que você está tentando fazer na gamificação?
 ### 2. Consultar a documentação de índice
 
 ```
-datasource-funifier-docs/knowledge/index.md
+funifier_read_doc path=index
 ```
 
 ### 3. Redirecionar para a skill correta
@@ -78,4 +78,4 @@ Baseado na tabela acima, instrua o usuário a usar a skill específica.
 
 ### 4. Se não encontrar skill específica
 
-Consulte `datasource-funifier-docs/knowledge/index.md` e leia o módulo relevante diretamente.
+Consulte `funifier_read_doc path=index` e leia o módulo relevante diretamente.

package/skills/funifier/references/implement-frontend.md

@@ -6,24 +6,24 @@ Implement frontend code that consumes the Funifier API — authentication, data
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "frontend api authentication fetch jwt token javascript react angular static hosting" --skill funifier-implement-frontend
+```
+funifier_search_docs "frontend api authentication fetch jwt token javascript react angular static hosting"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/auth.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md`
-- `datasource-funifier-docs/knowledge/guides/database-access.md`
-- `datasource-funifier-docs/knowledge/modules/patterns.md`
-- `datasource-funifier-docs/knowledge/modules/action-log.md`
-- `datasource-funifier-docs/knowledge/modules/static-repo.md`
+- `funifier_read_doc path=modules/auth`
+- `funifier_read_doc path=guides/aggregates`
+- `funifier_read_doc path=guides/database-access`
+- `funifier_read_doc path=modules/patterns`
+- `funifier_read_doc path=modules/action-log`
+- `funifier_read_doc path=modules/static-repo`
 
 ## Steps
 
@@ -69,9 +69,9 @@ const basicToken = 'Basic ' + btoa('API_KEY:APP_SECRET');
 
 ### 1. Ler documentação de auth e padrões
 
-- `datasource-funifier-docs/knowledge/modules/auth.md`
-- `datasource-funifier-docs/knowledge/modules/patterns.md`
-- `datasource-funifier-docs/knowledge/guides/aggregates.md` (para relatórios)
+- `funifier_read_doc path=modules/auth`
+- `funifier_read_doc path=modules/patterns`
+- `funifier_read_doc path=guides/aggregates` (para relatórios)
 
 ### 2. Implementar autenticação
 
@@ -103,4 +103,4 @@ const report = await fetch('/v3/database/achievement/aggregate', {
 
 ### 5. Hospedar no Funifier (opcional)
 
-Para arquivos estáticos, leia `datasource-funifier-docs/knowledge/modules/static-repo.md`.
+Para arquivos estáticos, leia `funifier_read_doc path=modules/static-repo`.

package/skills/funifier/references/import-csv.md

@@ -6,19 +6,19 @@ Import or export Funifier platform data via CSV — bulk player import, performa
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "csv import export bulk data migration player dataset" --skill funifier-import-csv
+```
+funifier_search_docs "csv import export bulk data migration player dataset"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/csv-data.md`
+- `funifier_read_doc path=modules/csv-data`
 
 ## Steps
 
@@ -35,7 +35,7 @@ O módulo CSV permite importar dados em massa (jogadores, ações, etc.) e expor
 ### 1. Ler a documentação do módulo
 
 ```
-datasource-funifier-docs/knowledge/modules/csv-data.md
+funifier_read_doc path=modules/csv-data
 ```
 
 ### 2. Preparar o arquivo CSV

package/skills/funifier/references/manage-player.md

@@ -6,19 +6,19 @@ Register and manage Funifier players — CRUD workflow for participant onboardin
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "player user register onboarding participant status extra profile" --skill funifier-manage-player
+```
+funifier_search_docs "player user register onboarding participant status extra profile"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/player.md`
+- `funifier_read_doc path=modules/player`
 
 ## Steps
 

package/skills/funifier/references/manage-team.md

@@ -6,19 +6,19 @@ Create and manage Funifier teams — group players for collective challenges, te
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "team group department member collective ranking collaboration squad" --skill funifier-manage-team
+```
+funifier_search_docs "team group department member collective ranking collaboration squad"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/team.md`
+- `funifier_read_doc path=modules/team`
 
 ## Steps
 

package/skills/funifier/references/upload-file.md

@@ -6,19 +6,19 @@ Upload files to Funifier — images and documents for player avatars, challenge
 
 ## Before starting — find relevant docs
 
-Run lexical search to load only what you need:
+Use the `funifier_search_docs` MCP tool to load only what you need:
 
-```bash
-npx funifier-mcp search "upload image file avatar media asset s3 multipart" --skill funifier-upload-file
+```
+funifier_search_docs "upload image file avatar media asset s3 multipart"
 ```
 
-Read only files returned with score > 0.5 (this threshold is printed in the search output).
+Then read the most relevant results with `funifier_read_doc path=<path>`.
 
 ## Primary docs for this skill
 
-If search returns insufficient results, read directly:
+If search returns insufficient results, read these directly:
 
-- `datasource-funifier-docs/knowledge/modules/upload.md`
+- `funifier_read_doc path=modules/upload`
 
 ## Steps