MCP Server for Sankhya ERP help center + community (Bettermode) — unified hybrid search (RRF cross-source) over 6,123 articles + 7,618 community posts. Streamable HTTP + Bearer auth. Read-only.
Strong foundation with 10 well-named, read-only tools backed by detailed descriptions (avg 180 chars). All tools have input schemas with type definitions and parameter descriptions. Naming follows verb_noun convention (search_, get_, list_). However, output schemas are not explicitly documented in the visible code, and error handling guidance is minimal. Tool descriptions are LLM-optimized but lack explicit 'when to use' guidance and dependency hints between tools. No evidence of per-tool error recovery patterns or actionable error messages.
Conteudo completo de um artigo do help center Sankhya — retorna titulo, breadcrumb, corpo formatado em Markdown, URL, datas (criacao/atualizacao/edicao), autor, labels e status de obsolescencia. Use apos search_knowledge_unified para obter detalhes de um artigo especifico. Somente leitura.
Conteudo completo de um post da comunidade Sankhya (Bettermode) — retorna titulo, corpo formatado em Markdown, autor, datas, espaco (space) e URL. Use apos search_knowledge_unified com source=community para obter detalhes de um post especifico. Somente leitura.
Prompts, relatorios e investigacoes da base Sankhya — executa prompt parametrizado para troubleshooting de erro, consulta rapida, explicacao de modulo ou comparacao entre artigos do help center Sankhya. Use quando precisar de um workflow estruturado em vez de buscas livres. O campo name deve ser um dos prompts listados em sankhya_ajuda_list_prompt_catalog. Retorna mensagens Markdown.
Lista todas as categorias do help center Sankhya — retorna ID, nome, descricao e numero de artigos por categoria. Use antes de filtrar buscas por category_id ou para explorar a estrutura da base. Consulta local, sem side effects.
Lista espacos (spaces) da comunidade Sankhya (Bettermode) — retorna ID, nome, descricao e numero de posts por espaco. Use para explorar a estrutura da comunidade ou filtrar buscas por espaco. Consulta local, sem side effects.
Output schemas not documented in visible code. Tool descriptions state what is returned (e.g., 'retorna titulo, breadcrumb, corpo formatado') but no formal JSON Schema for responses. LLMs cannot plan downstream tool calls without knowing response structure.
No error handling guidance in tool descriptions. All tools are read-only, but descriptions do not explain what happens on invalid input (e.g., article_id not found, invalid URI format). No recovery hints like 'Try search_knowledge_unified first to find valid IDs.'
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | <=2025-11-25 | v2 |
Recursos, dados e URIs do servidor MCP da base Sankhya — lista todas as URIs sankhya-ajuda:// com nome, tipo de conteudo (mimeType) e indicacao de template parametrizavel. Use quando precisar descobrir quais dados da base de ajuda Sankhya estao acessiveis via protocolo de recursos MCP. Retorna tabela Markdown. Consulta local.
Prompts, templates e workflows disponiveis no servidor MCP da base Sankhya — catalogo de prompts pre-configurados com nome, descricao e argumentos necessarios para cada um. Use quando precisar saber quais analises e investigacoes guiadas a base de ajuda Sankhya oferece como slash commands. Retorna tabela Markdown. Consulta local.
Lista secoes do help center Sankhya — retorna ID, nome, descricao, categoria pai e numero de artigos. Pode filtrar por category_id ou parent_section_id para navegacao hierarquica. Consulta local.
Conteudo de um recurso MCP da base Sankhya — le dados de uma URI sankhya-ajuda:// especifica para obter categorias, secoes ou artigos da documentacao do Sankhya. Use quando precisar acessar dados do Sankhya via protocolo de recursos MCP em vez de chamar as tools de dominio. Retorna Markdown formatado ou JSON para sync_state. Somente leitura.
Busca hibrida unificada sobre artigos do help center Sankhya e posts da comunidade Bettermode — combina semantica + FTS via RRF. Retorna top-N com breadcrumb, categoria, secao e fonte (help ou community). Use mode=hybrid (default) para melhor relevancia, semantic para sinonimos, keyword para codigo de erro/nome exato. Corpus: 6.123 artigos + 7.618 posts. Somente leitura.
Tool composition guidance missing. Descriptions do not explain the intended workflow (e.g., 'Call list_categories first, then list_sections to navigate hierarchy' or 'Use search_knowledge_unified to find article_id, then call get_article_details'). Agents must infer dependencies.
Parameter 'arguments' in sankhya_ajuda_get_prompt_by_name is typed as 'object' with no schema. Description says 'use sankhya_ajuda_list_prompt_catalog for detailsʼ but does not specify what keys/types arguments accepts. LLMs cannot validate input without a schema.
Pagination not explicitly documented. search_knowledge_unified accepts 'limit' (max 50) but no mention of offset/cursor for iterating beyond top-N results. Large result sets may require pagination guidance.