tecconcursos-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tecconcursos-mcp Qual minha taxa de acerto por matéria?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tecconcursos-mcp
⚠️ Projeto pessoal, independente e não oficial. Não tem vínculo com TecConcursos, QConcursos, Tutory ou qualquer mentoria, nem é endossado por eles. Os nomes são marcas dos respectivos donos e aparecem aqui só para dizer com quais serviços a ferramenta funciona.
O servidor não abre conexões de rede, não pede login, não guarda senhas ou cookies e não baixa nem redistribui conteúdo das plataformas (questões, comentários, aulas). Ele trabalha com os seus próprios dados de desempenho: arquivos que você exportou e números que você (ou seu assistente, no seu navegador e na sua sessão) leu das suas páginas de estatísticas. Veja Uso responsável.
Servidor MCP que transforma seus dados de desempenho em ferramentas para o Claude (ou qualquer cliente MCP). Com ele, você pode perguntar coisas como:
"Qual minha taxa de acerto por matéria?"
"Quais assuntos de Direito Penal eu mais erro?"
"Monta uma revisão com as questões de Física que errei na banca Cebraspe."
"Acha as questões sobre cadeia de custódia nos meus cadernos."
Como tirar os dados do TecConcursos
O site tem export oficial em Estatísticas:
Estatísticas → Desempenho: escolha o período, marque Selecionar Todos e clique em Exportar para planilha. Essa planilha traz acertos e erros por matéria e assunto. Ela chega por e-mail em alguns minutos: salve o anexo
.xlsxem~/Downloads.(Opcional) Estatísticas → Atividades → Exportar para planilha. Baixa na hora, mas só traz quantas questões você resolveu.
Rode
tecconcursos-mcp importar. O comando procura essas planilhas em~/Downloadspelo cabeçalho, copia para a pasta de exports comodesempenho_AAAA-MM-DD.xlsxe pula as repetidas.
Cada planilha vira um ponto na sua evolução. Ela não diz o período que cobre: a data é a do
download. Para os pontos serem comparáveis, exporte sempre com o mesmo tipo de período (ex.: toda
domingo, "últimos 7 dias"). Se quiser registrar o período, renomeie para
desempenho_2026-11-01_a_2026-11-07.xlsx.
Related MCP server: cf-analyser
Painel de progresso
tecconcursos-mcp importar # traz os exports novos de ~/Downloads
tecconcursos-mcp painel --abrir # gera <exports>/painel.html e abre no navegadorO painel é um HTML único que funciona offline: taxa de acerto por matéria ao longo do tempo, questões por planilha, assuntos para revisar e a tabela completa. Tem tema claro e escuro.
QConcursos (sem export)
O QConcursos não exporta, mas a página Minhas Estatísticas aceita qualquer período pela URL
(/usuario/estatisticas/disciplinas?gt=AAAA-MM-DD<=AAAA-MM-DD). O prompt coletar_qconcursos
orienta o Claude, no seu navegador já logado, a:
ler a tabela de Disciplina e de Assunto de cada dia ainda não salvo;
salvar cada dia com
salvar_estatisticas_qconcursosemqconcursos_AAAA-MM-DD.json.
Os dias nunca se sobrepõem, então somar dá o total exato. O roteiro proíbe clicar em "zerar", que apaga as estatísticas no site.
progresso(fonte="qconcursos")mostra um ponto por dia.desempenho_assuntos(fonte="qconcursos")soma todos os dias.resumo_gerale o painel mostram o QConcursos em bloco separado do TecConcursos.
Na página de Assuntos, uma questão pode contar em vários assuntos (o total por assunto passa do total de questões) e não aparece a disciplina de cada assunto. Use os assuntos para achar pontos fracos, não para somar volume.
Lançar nas Metas Diárias da mentoria (Tutory)
Se sua mentoria usa a plataforma Tutory (página Metas Diárias), o Claude pode lançar ali as questões que você fez no TecConcursos. O servidor não acessa a mentoria: ele só calcula o que lançar, e quem preenche é o Claude no seu navegador (ex.: Claude in Chrome), depois da sua confirmação.
No TecConcursos, exporte o Desempenho do período ainda não lançado (ex.: hoje) e rode
tecconcursos-mcp importar.No Claude, use o prompt
lancar_metas_mentoria. O roteiro é:ler as metas de hoje;
preparar_lancamentos_mentoria, que casa cada meta com uma matéria do TEC ("Simulado de Língua Portuguesa (VTM)" → "Língua Portuguesa (Português)");mostrar a tabela e pedir sua confirmação;
marcar "Meta concluída" e preencher Questões feitas / Questões corretas;
registrar_lancamentos_mentoria.
O que foi lançado fica em
mentoria_lancados.json. A mesma planilha não é lançada duas vezes.
Opcional, mentoria.json na pasta de exports:
{
"url": "https://SUA-MENTORIA.tutory.com.br/painel/metas",
"materias": { "Simulado de Direito Penal (VTM)": "Direito Penal" }
}materias força pares meta → matéria do TEC quando o nome não bate sozinho.
Ferramentas
Planilhas oficiais de Estatísticas (resumos por matéria e assunto):
Ferramenta | O que faz |
| Acertos por matéria ( |
| Evolução da taxa de acerto e do volume, um ponto por planilha, no total e por matéria |
| Para cada meta do dia, a matéria do TEC e as questões/acertos a lançar |
| Grava as estatísticas de um dia do QConcursos (lidas da página pelo Claude) |
| Anota localmente o que já foi lançado (única ferramenta que escreve, só na pasta de exports) |
Exports por questão (CSV/JSON/PDF de caderno):
Ferramenta | O que faz |
| Visão geral: última planilha de Estatísticas e/ou questões carregadas, taxa de acerto e período |
| Taxa de acerto agrupada por |
| Grupos com pior desempenho, ignorando amostras pequenas (usa limite inferior de Wilson para desempatar) |
| Questões erradas, mais recentes primeiro, com filtros por matéria, assunto, banca e ano |
| Busca por palavras no código, matéria, assunto, enunciado e alternativas |
| Arquivos encontrados, quantas questões cada um rendeu e erros de leitura |
Todas são somente leitura, exceto salvar_estatisticas_qconcursos e registrar_lancamentos_mentoria, que gravam só na pasta de exports. Os filtros de texto ignoram acentos e maiúsculas, e aceitam trechos
(materia="penal" encontra "Direito Penal").
Formatos aceitos
Coloque os exports numa pasta, que pode ter subpastas. O servidor lê:
Formato | Situação |
| ✅ Desempenho e Atividades (detectado pelo cabeçalho |
| ✅ Separador |
| ✅ Todas as abas; a primeira linha é o cabeçalho |
| ✅ Lista de objetos ou |
| 🧪 Experimental: usa heurísticas sobre o texto |
As colunas são reconhecidas por vários nomes. Por exemplo, Matéria/Disciplina, Sua resposta/Resposta marcada,
Resultado/Situação/Acertou. Se o export trouxer gabarito e resposta, o acerto é
calculado sozinho. A lista completa está em parsers/tabular.py.
Se a mesma questão aparecer em vários arquivos, fica a versão mais completa (a que tem resultado).
Instalação
Requer uv.
Claude Desktop
Edite o claude_desktop_config.json. No Claude Desktop, vá em Settings → Developer → Edit Config:
{
"mcpServers": {
"tecconcursos": {
"command": "uvx",
"args": ["--from", "git+https://github.com/andrevinic/tecconcursos-mcp", "tecconcursos-mcp"],
"env": { "TEC_EXPORTS_DIR": "/Users/voce/TecConcursos/exports" }
}
}
}Reinicie o Claude Desktop. As ferramentas aparecem no menu de conectores da conversa.
Claude Code
claude mcp add tecconcursos \
-e TEC_EXPORTS_DIR="$HOME/TecConcursos/exports" \
-- uvx --from git+https://github.com/andrevinic/tecconcursos-mcp tecconcursos-mcpOutros clientes MCP
O comando é uvx --from git+https://github.com/andrevinic/tecconcursos-mcp tecconcursos-mcp
(stdio), com a variável TEC_EXPORTS_DIR apontando para a pasta. Se você não definir a variável, a pasta padrão é
~/TecConcursos/exports.
Uso responsável
Esta ferramenta foi feita para você acompanhar o seu próprio estudo. Ao usá-la:
Respeite os Termos de Uso de cada plataforma. Você é responsável por como usa a sua conta. Na dúvida, use só o export oficial e consulte os termos do serviço.
Só os seus dados, na sua sessão.
Nada aqui contorna login, paywall, captcha ou limite de acesso.
Não use a ferramenta para acessar dados de terceiros nem para coletar o acervo de questões dos sites.
Só números, não conteúdo.
A coleta do QConcursos guarda contagens de certas/erradas por disciplina e o nome dos assuntos, nunca o texto das questões.
Não publique questões, gabaritos ou comentários das plataformas: são conteúdo protegido por direito autoral.
Volume humano. Os roteiros leem uma página por vez, com pausa entre elas, e só quando você pede. Não os transforme em robôs agendados contra os sites.
Nada destrutivo.
Os roteiros proíbem clicar em "zerar" estatísticas.
Os lançamentos na mentoria só acontecem depois da sua confirmação explícita, com os números mostrados antes.
Sem garantia. As plataformas podem mudar páginas e termos a qualquer momento; a ferramenta pode parar de funcionar ou deixar de ser permitida. O software é fornecido "como está" (licença MIT).
Privacidade
Tudo roda na sua máquina. O servidor não abre conexões de rede. Seus exports e coletas ficam na pasta de
exports (fora do repositório; o .gitignore também bloqueia exports/). O que vai para o modelo é só o que as
ferramentas devolvem: estatísticas e, em questoes_erradas/buscar_questao, o texto de questões que estejam
em arquivos seus. Nunca faça commit dos seus exports.
Contribuindo
O PDF e os nomes de coluna variam, e é aí que a ajuda mais conta. Se um export seu não for reconhecido:
Rode
listar_exportse veja o erro.Abra uma issue com o cabeçalho das colunas, ou um trecho anonimizado do PDF. Não publique questões, comentários nem estatísticas reais das plataformas: use dados inventados.
Para desenvolver:
git clone https://github.com/andrevinic/tecconcursos-mcp && cd tecconcursos-mcp
uv run --extra dev pytestOs testes usam só dados inventados. Mantenha assim.
Licença
MIT. Veja LICENSE.
Available Tools
11 toolsbuscar_questaoBRead-onlyIdempotent
Busca por palavras (todas precisam aparecer) no código, matéria, assunto, enunciado e alternativas.
Inputs: termo (required), banca, limite, materia. Returns: object
desempenhoBRead-onlyIdempotent
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').
Inputs: ano, banca, materia, agrupar_por, +1 more. Returns: object
desempenho_assuntosBRead-onlyIdempotent
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'.
Inputs: fonte, nivel, limite, materia, +2 more. Returns: object
listar_exportsARead-onlyIdempotent
Lista os arquivos de export encontrados, quantas questões cada um rendeu e erros de leitura.
Inputs: no named parameters. Returns: object
pontos_fracosBRead-onlyIdempotent
Grupos com pior taxa de acerto, ignorando os com poucas questões (min_questoes).
Inclui indice_confianca (limite inferior de Wilson) para desempatar amostras pequenas.
Inputs: banca, limite, materia, agrupar_por, +1 more. Returns: object
preparar_lancamentos_mentoriaARead-onlyIdempotent
Calcula o que lançar nas Metas Diárias da mentoria a partir da planilha de Desempenho mais recente.
metas: títulos das metas de hoje ainda não concluídas, como aparecem na página
(ex.: ["Simulado de Informática", "Simulado de Direito Constitucional (VTM)"]).
Não acessa a mentoria: só devolve, por meta, a matéria do TecConcursos casada e as questões/acertos.
Mostre o resultado ao usuário e peça confirmação antes de preencher qualquer coisa.
Inputs: metas (required). Returns: object
progressoBRead-onlyIdempotent
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.
Inputs: fonte, materia. Returns: object
questoes_erradasBRead-onlyIdempotent
Questões que você errou, mais recentes primeiro — para montar revisão.
Inputs: ano, banca, limite, assunto, +1 more. Returns: object
registrar_lancamentos_mentoriaA
Anota localmente (mentoria_lancados.json) o que JÁ foi salvo na mentoria, para não lançar de novo.
planilha: o campo planilha devolvido por preparar_lancamentos_mentoria.
lancamentos: itens efetivamente salvos, cada um com meta, materia_tec, questoes e acertos.
Inputs: planilha (required), lancamentos (required). Returns: object
resumo_geralBRead-onlyIdempotent
Visão geral: última planilha de Estatísticas (por matéria) e/ou exports por questão.
Inputs: no named parameters. Returns: object
salvar_estatisticas_qconcursosAIdempotent
Grava as estatísticas de UM dia do QConcursos (qconcursos_AAAA-MM-DD.json na pasta de exports).
data: AAAA-MM-DD (a página foi filtrada com início = fim = esse dia).
disciplinas/assuntos: [{"nome": ..., "certas": int, "erradas": int}] lidos da tabela.
Salvar o mesmo dia de novo sobrescreve. Veja o prompt coletar_qconcursos.
Inputs: data (required), disciplinas (required), assuntos. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
UN FAOSTAT global food & agriculture statistics over a local SQLite mirror, via MCP.
Read-only MCP tools for public works, builders, ratings, timelines and nearby services in Brazil.
AI-powered commodity price forecasts and Brazil trade intelligence via MCP. Access Brazilian exports and imports from MDIC/ComexStat since 2000, by HS4, HS6 and NCM code, partner country, USD FOB and kilograms — plus crop production, supply & demand, climate data and production forecasts for major commodities including soybeans, coffee, corn, beef and cocoa. Compare trade flows, markets, countries and time periods with like-for-like windows. Every answer identifies the measurement period and data source. 15 read-only tools. Metered in credits. Connect directly via Streamable HTTP — no installation required: https://mcp.kyrodata.com/mcp Authentication: Bearer key or OAuth 2.1 (PKCE). Official MCP registry: com.kyrodata/kyrodata
Turn an Excel or CSV export into a dashboard, or check the numbers in a text against it. No account.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides a local CBT exam system as MCP tools for Codex, managing study sessions, scoring, wrong answer tracking, and review queues with deterministic Python engine and optional Notion integration.MIT
- FlicenseNot gradedqualityCmaintenanceEnables analyzing Codeforces activity through local MCP tools, including weekly practice summaries, problem recommendations, user comparisons, weak-topic detection, contest tracking, and rating progress.-
- FlicenseNot gradedqualityCmaintenanceProvides local MCP tools for searching, filtering, adding, updating, and analyzing a catalog of study projects, with statistics and GitHub publication readiness checks, all backed by SQLite.-
- AlicenseBqualityBmaintenanceEnables answering questions about your disc golf rounds, courses, hole-by-hole scores and scoring trends, plus practice-throw speed, distance, spin and angle, read entirely from your own CSV exports with no credentials or network access.13MIT