bncc-mcp

Servidor MCP da BNCC (Base Nacional Comum Curricular), o currículo oficial da educação básica brasileira.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Bncc Lookup: Retorna o registro completo e verificado de uma aprendizagem da BNCC pelo código (ex.: "EF67LP08", "EI02TS01", "EM13LGG103", "EF03CO05" do complemento de Computação; aceita minúsculas). I
  • Bncc Buscar: Busca um termo nos textos oficiais das aprendizagens (normalizada: acentos e maiúsculas não importam). Use para encontrar habilidades sobre um tema (ex.: texto="frações", componente="MA")
  • Bncc Listar: Lista aprendizagens de uma etapa com filtros estruturados (sem busca textual). EF: componente (sigla, ex.: LP) e/ou ano (1-9). EM: area (LGG, MAT, CNT, CHS) e/ou competencia (número) e/ou

What data it sees

Do you need an account

No: the server works without sign-in

Servidor MCP da BNCC (Base Nacional Comum Curricular), o currículo oficial da educação básica brasileira. Dá a agentes de IA acesso às 1.721 aprendizagens da BNCC e do complemento de Computação, extraídas dos documentos homologados pelo MEC e verificadas contra a fonte.

Cada habilidade e objetivo de aprendizagem traz o código, o texto oficial e a proveniência (a página do PDF de onde veio), o que permite ao agente citar a origem em vez de alucinar códigos: a numeração da BNCC tem lacunas legítimas, e o servidor responde explicando isso quando um código não existe.

Sete tools: bncc_lookup (busca por código), bncc_buscar (busca textual), bncc_listar, bncc_estatisticas, bncc_decodificar (explica a anatomia de um código como EF67LP08), bncc_progressao_ei e bncc_estrutura.

Casos de uso: planejamento de aulas alinhado ao currículo, geração de atividades e avaliações com habilidades corretas, análise de material didático, ferramentas para professores e edtechs brasileiras.

Não requer autenticação nem configuração: os dados são embutidos no servidor, sem chamadas de rede. Código MIT; dados sob CC BY 4.0.

How to connect

How to connect bncc-mcp to Claude

The server address to paste into Claude settings:

https://bncc-mcp--bncc-dev.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect bncc-mcp to ChatGPT

The server address to paste into ChatGPT settings:

https://bncc-mcp--bncc-dev.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect bncc-mcp to Cursor

The server address to paste into Cursor settings:

https://bncc-mcp--bncc-dev.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (7)

Raw names from tools/list. Only developers need these.

bncc_lookupRetorna o registro completo e verificado de uma aprendizagem da BNCC pelo código (ex.: "EF67LP08", "EI02TS01", "EM13LGG103", "EF03CO05" do complemento de Computação; aceita minúsculas). Inclui texto oficial, contexto pedagógico resolvido (componente, unidade temática/prática, objetos de conhecimento, competências) e a fonte oficial com página do PDF homologado. Use sempre que o usuário mencionar um código ou quando precisar do enunciado exato: nunca cite de memória.
bncc_buscarBusca um termo nos textos oficiais das aprendizagens (normalizada: acentos e maiúsculas não importam). Use para encontrar habilidades sobre um tema (ex.: texto="frações", componente="MA"). Retorna {total, exibindo, resultados}; se total > exibindo, refine os filtros ou aumente o limite. Componentes do EF: LP, AR, EF, LI, MA, CI, GE, HI, ER. O complemento de Computação (códigos CO) entra na busca por padrão.
bncc_listarLista aprendizagens de uma etapa com filtros estruturados (sem busca textual). EF: componente (sigla, ex.: LP) e/ou ano (1-9). EM: area (LGG, MAT, CNT, CHS) e/ou competencia (número) e/ou apenas_lp. EI: campo (EO, CG, TS, EF, ET) e/ou grupo_etario (01, 02, 03). Computação: componente=CO (EF), area=CO (EM) ou campo=CO (EI). Use para cobertura curricular ("todas as habilidades do 4º ano de Matemática") e navegação. Retorna {total, exibindo, resultados}.
bncc_decodificarExplica a anatomia de um código BNCC sem consultar o dataset: etapa, ano(s) ou bloco, componente/área, competência embutida (EM) e sequência; códigos CO do complemento de Computação também. Funciona para qualquer código gramaticalmente válido, mesmo que não exista (atenção: existência se confere com bncc_lookup). Use para validar/explicar códigos que o usuário digitou.
bncc_progressao_eiDado um objetivo da Educação Infantil (ex.: EI02TS01), retorna os objetivos do MESMO aspecto nas três faixas etárias (bebês, crianças bem pequenas, crianças pequenas) — o alinhamento horizontal oficial da BNCC (p. 26). Use para planejar continuidade/adaptação entre faixas. Só existe para códigos EI.
bncc_estruturaRetorna as coleções estruturais da BNCC: etapas, áreas do conhecimento, componentes curriculares (com quem tem habilidades próprias), competências gerais (10), competências específicas (105), recortes temporais, campos de experiências e modalidades (EJA). Sem argumento, retorna o índice de coleções disponíveis com contagens.
bncc_estatisticasContagens do dataset (total de aprendizagens por etapa, competências, alinhamentos) e a versão dos dados embutidos (data-version, commit de origem). Use para sanidade e para citar a versão do dado.