tecconcursos-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TEC_EXPORTS_DIR | No | Path to the folder containing your exported TecConcursos data. If not set, the default folder is ~/TecConcursos/exports. | ~/TecConcursos/exports |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Lê arquivos exportados do TecConcursos numa pasta local e analisa o desempenho do estudante. Não acessa o site. Há dois tipos de dado: (1) planilhas oficiais de Estatísticas (Desempenho/Atividades), resumos por matéria e assunto, uma por data; use desempenho_assuntos e progresso; (2) exports por questão (CSV/JSON/PDF de caderno); use desempenho, pontos_fracos, questoes_erradas, buscar_questao. Comece por resumo_geral. Filtros de texto aceitam trechos sem acento (ex.: materia='penal').
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_exportsA | Lista os arquivos de export encontrados, quantas questões cada um rendeu e erros de leitura. |
| resumo_geralB | Visão geral: última planilha de Estatísticas (por matéria) e/ou exports por questão. |
| desempenhoB | Taxa de acerto agrupada por materia, assunto, banca, orgao, cargo ou ano. Filtros opcionais restringem as questões consideradas (ex.: agrupar_por='assunto', materia='penal'). |
| pontos_fracosB | Grupos com pior taxa de acerto, ignorando os com poucas questões (min_questoes). Inclui |
| questoes_erradasB | Questões que você errou, mais recentes primeiro — para montar revisão. |
| buscar_questaoB | Busca por palavras (todas precisam aparecer) no código, matéria, assunto, enunciado e alternativas. |
| desempenho_assuntosB | Acertos por matéria/assunto. fonte='tec': planilha de Desempenho mais recente do TecConcursos. nivel: 0 = matérias, 1 = assuntos de 1º nível (padrão), 2+ = subassuntos; None = todos. fonte='qconcursos': soma de todos os dias salvos; nivel 0 = disciplinas, 1 = assuntos. ordenar: 'fracos' (pior taxa primeiro, com Wilson para desempatar), 'fortes' ou 'volume'. |
| progressoB | Evolução no tempo, no total e por matéria. fonte='tec': um ponto por planilha exportada (cada uma cobre o período escolhido no site). fonte='qconcursos': um ponto por dia coletado. |
| salvar_estatisticas_qconcursosA | Grava as estatísticas de UM dia do QConcursos (qconcursos_AAAA-MM-DD.json na pasta de exports).
|
| preparar_lancamentos_mentoriaA | Calcula o que lançar nas Metas Diárias da mentoria a partir da planilha de Desempenho mais recente.
|
| registrar_lancamentos_mentoriaA | Anota localmente (mentoria_lancados.json) o que JÁ foi salvo na mentoria, para não lançar de novo.
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| coletar_qconcursos | Roteiro para ler, dia a dia, Minhas Estatísticas do QConcursos e salvar localmente. |
| lancar_metas_mentoria | Roteiro: ler as metas de hoje, preparar, confirmar com o usuário, preencher e registrar. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Several tools target the same underlying data with only subtly different framing: `desempenho` (grouped by materia/assunto/banca/...) heavily overlaps `desempenho_assuntos` (acertos por matéria/assunto), and `pontos_fracos` is essentially `desempenho` sorted ascending with a min-questions filter. `resumo_geral`, `listar_exports` and `progresso` also blur together around 'what data do I have'. The mentoria pair (preparar vs registrar) is clearly distinct, but the analytics cluster will invite misselection.
All names are Portuguese snake_case, readable and consistent in style, with clear verb_noun forms for actions (`listar_exports`, `buscar_questao`, `salvar_estatisticas_qconcursos`, `registrar_lancamentos_mentoria`). The deviation is that several read tools are bare noun phrases (`desempenho`, `desempenho_assuntos`, `progresso`, `pontos_fracos`) with no verb, so the action is not encoded in the name.
11 tools is a well-scoped size for an analytics-plus-mentoria server, and each covers a plausible workflow step. The count is slightly inflated by near-duplicates (`desempenho_assuntos`, `pontos_fracos`) that could arguably be parameter modes of `desempenho`.
Read coverage is strong (overview, performance, weak points, wrong questions, search, progress) and both write paths exist (saving QConcursos days, recording mentoria launches). However there is no tool to read back `mentoria_lancados.json`, so the agent cannot check what was already launched — a dead end for the stated anti-duplicate workflow — and there is no undo/removal for recorded launches or any ingestion path for TecConcursos spreadsheets beyond the exports folder.