rnds-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Confira CPF, CNS e CNES, consulte os códigos da RNDS e valide Bundles FHIR antes do envio, tudo em código aberto: uma biblioteca Python offline, uma CLI, um MCP local para o seu agente de IA e um cliente opcional para a RNDS.
Projeto da Voa Health, não afiliado ao Ministério da Saúde nem ao DATASUS.
Usa Claude Code, Codex ou Cursor? Conecte o MCP e peça em português, por exemplo "valide este Bundle antes do envio à RNDS". VejaConectar agentes.
Início rápido
pip install rndsfrom rnds import cnes, cns, cpf, validar
cpf.valido("987.654.321-00")
cns.valido("712345678901236")
cnes.valido("1234567")
bundle = {"resourceType": "Bundle", "type": "collection", "entry": []}
[(achado.code, achado.severity) for achado in validar(bundle)]Cada achado traz um código estável, a gravidade, o caminho no Bundle e uma mensagem curta. Requer Python 3.10+ e nenhuma dependência de execução.
Related MCP server: mcp-icd10
CLI
Instale a CLI com pip install rnds ou execute sem instalar com
uvx rnds validate bundle.json.
Comando | Uso |
| Normaliza e confere um CPF. |
| Normaliza e confere um CNS. |
| Normaliza e confere um CNES. |
| Lista os CodeSystems e ValueSets incluídos. |
| Lista os conceitos de um sistema. |
| Confere um código pelo código de saída, sem saída JSON; |
| Valida um Bundle de um arquivo ou da entrada padrão. |
| Lista os endereços RNDS de homologação e produção. |
| Inicia o MCP local em stdio; requer |
As consultas saem em JSON. Os códigos de saída são 0 para sucesso, 1 para
identificador ou código inválido e Bundle com erros, e 2 para uso inválido ou
entrada ilegível.
$ rnds cpf 987.654.321-00
{"identifica_pessoa": true, "sistema": "http://rnds.saude.gov.br/fhir/r4/NamingSystem/cpf", "tipo": "cpf", "valido": true, "valor": "98765432100"}Para quem é
Você é | O rnds ajuda a |
Desenvolvedor de prontuário ou sistema de saúde | conferir identificadores e códigos e validar o Bundle antes de chamar a RNDS |
Estabelecimento credenciado na RNDS | autenticar com o certificado ICP-Brasil, consultar cadastros e enviar documentos com o cliente opcional |
Agente de IA | montar |
Como funciona
O ciclo antes do envio é sempre o mesmo:
Confira CPF, CNS e CNES com
rnds.cpf,rnds.cnsernds.cnes.Converta sistemas locais para os oficiais com
rnds.sistemas.para_oficial.Valide os códigos com
rnds.codigos.valido.Valide o Bundle com
rnds.validaraté zerar os erros.Envie com
ClienteEhr.enviar, que valida de novo e bloqueia erros antes da rede.
O que vem no pacote
Biblioteca Python: CPF, CNS, CNES, sistemas oficiais, códigos e validação de Bundles, sem rede.
Catálogo de códigos: 28 CodeSystems e 25 ValueSets do Guia de Implementação RNDS 1.0.0.
MCP local: 3 ferramentas em stdio para agentes.
Cliente RNDS (Alpha): autenticação mTLS, consultas FHIR e envio de Bundles com o extra
rnds[cliente].
Por que confiar
Offline e determinístico: biblioteca, CLI e MCP rodam na sua máquina, sem rede nem telemetria; a mesma entrada dá sempre a mesma saída.
Sem dependências: o pacote base usa apenas a biblioteca padrão; MCP e cliente são extras opcionais.
Fontes versionadas: os códigos vêm do Guia de Implementação RNDS e os endereços, do guia de integração, listados em Fontes de dados.
À prova de prompt injection: o texto dos conceitos é dado, nunca instrução.
Envio sem surpresa: o cliente nunca repete operações nem segue redirecionamentos, e seus logs não contêm documentos nem identificadores.
Conectar agentes
ChatGPT via HTTP
O pacote ChatGPT expõe somente rnds_codigos por HTTP
remoto com OAuth. Consulta códigos públicos incluídos no pacote, sem dados de
paciente ou identificadores; não valida Bundles nem envia documentos à RNDS.
O MCP local em stdio abaixo mantém todas as ferramentas.
Para gerar dist/rnds-chatgpt-plugin.zip com plugin.json na raiz, execute
na raiz do repositório:
mkdir -p dist
(cd plugins/chatgpt && zip -r ../../dist/rnds-chatgpt-plugin.zip .)MCP local em stdio
O MCP local roda offline e mantém os dados na máquina:
claude mcp add rnds -- uvx --from "rnds[mcp]" rnds mcpFerramenta | Uso |
| Normaliza e confere CPF, CNS ou CNES e devolve o sistema oficial. |
| Lista sistemas, conceitos ou confere um código. |
| Valida um Bundle FHIR e lista os achados. |
Agentes encontram instruções em AGENTS.md.
Codex e Cursor
No Codex, adicione a ~/.codex/config.toml:
[mcp_servers.rnds]
command = "uvx"
args = ["--from", "rnds[mcp]", "rnds", "mcp"]No Cursor, adicione ao mcp.json:
{
"mcpServers": {
"rnds": {
"command": "uvx",
"args": ["--from", "rnds[mcp]", "rnds", "mcp"]
}
}
}Validar um Bundle
from rnds import validar
bundle = {"resourceType": "Bundle", "type": "collection", "entry": []}
achados = validar(bundle)rnds validate bundle.json
cat bundle.json | rnds validate -O que é verificado
A validação verifica que a entrada seja um Bundle, que fullUrl não se repita,
que referências relativas (Tipo/id e Tipo/id/_history/v) ou URN
(urn:uuid: e urn:oid:) sejam resolvidas, que CPF, CNS e CNES sejam válidos para
seus sistemas, que sistemas urn:voa:br: mapeados indiquem o sistema oficial,
que códigos pertençam aos CodeSystems incluídos e que o display corresponda ao
conceito. O arquivo pode ter até 10 MB e 64 níveis de aninhamento.
Não são verificadas referências absolutas http(s), referências contidas
iniciadas por #, perfis completos de StructureDefinition nem binding de
ValueSet por elemento.
Código | Gravidade | Significado |
|
| A entrada não é um Bundle FHIR. |
|
| O |
|
| A referência não foi resolvida no Bundle. |
|
| O CPF é inválido para o sistema informado. |
|
| O CNS é inválido para o sistema informado. |
|
| O CNES é inválido para o sistema informado. |
|
| O sistema local pode ser convertido para o oficial. |
|
| O código não existe no CodeSystem incluído. |
|
| O display difere do conceito incluído. |
Cliente RNDS (Alpha)
Instale com pip install "rnds[cliente]". O cliente foi testado somente com
respostas simuladas, sem homologação real. O credenciamento no DATASUS e o
certificado ICP-Brasil são responsabilidade do integrador. Produção não é
ambiente para testes.
Exemplo sintético de homologação, com autorização fictícia (não executável no serviço):
from datetime import datetime, timedelta, timezone
from rnds.cliente import ClienteEhr, Token
autorizacao = Token("autorizacao-sintetica", datetime.now(timezone.utc) + timedelta(minutes=30))
bundle = {"resourceType": "Bundle", "type": "collection", "entry": []}
with ClienteEhr(autorizacao, "712345678901236", "homologacao") as cliente:
envio = cliente.enviar(bundle)
avisos = envio.avisosO Bundle acima ilustra a chamada, não um documento completo aceito pela RNDS.
Para autenticação real, crie o contexto com contexto_mtls(pfx, senha) e obtenha
a autorização com obter_token(contexto, ambiente). Em produção, informe a UF
em ClienteEhr(..., "producao", uf="sp").
Consultas, envio e erros
Método | Uso |
| Consulta um paciente por exatamente um identificador. |
| Consulta um profissional por exatamente um identificador. |
| Consulta as lotações de um profissional no estabelecimento. |
| Consulta um estabelecimento. |
| Lê o CapabilityStatement do serviço. |
| Valida e envia um Bundle. |
| Consulta o contexto de atendimento. |
enviar valida localmente por padrão: erros bloqueiam a rede, avisos seguem em
Envio.avisos. validar=False desativa essa validação. O corpo não é
remodelado. Sucesso exige HTTP 201 e Location; Envio.id_rnds desconsidera
/_history/.... Nenhuma operação é repetida automaticamente e redirecionamentos
não são seguidos.
Exceção | Quando repetir |
| Corrigir os achados em |
| Seguro: falha de conexão antes do envio, ou transporte de operação idempotente |
| Não repetir envio antes de reconciliar: pode ter sido aceito |
| Corrigir o endereço, sem seguir automaticamente |
| Corrigir autenticação antes de nova tentativa |
| Corrigir permissão antes de nova tentativa |
| Conferir o recurso antes de nova tentativa |
| Corrigir a requisição; consultar |
| Consultas/contexto podem ser repetidos após diagnóstico; não reenviar documentos às cegas |
No envio, falhas de leitura/escrita, interrupções, HTTP 5xx e confirmação
incompleta geram ResultadoIncerto. contexto_atendimento é idempotente como
as consultas e devolve o objeto JSON sem remodelá-lo. Não registre esse retorno:
ele pode conter autorização de acesso. Os logs do cliente contêm somente
operação, status e duração.
Substituir um documento
Não existe endpoint separado para substituição. Envie um novo Bundle contendo na Composition o relacionamento abaixo, com o identificador RNDS anterior:
relacionamento = {
"code": "replaces",
"targetReference": {"reference": "Composition/documento-sintetico-anterior"},
}
# Na nova Composition: "relatesTo": [relacionamento].Isso corresponde a Composition.relatesTo com code=replaces e
targetReference.reference = "Composition/<id_rnds anterior>".
O cliente não altera o Bundle do chamador.
Referência
Símbolos da biblioteca
Símbolo | Uso |
| Normaliza e confere um CPF. |
| Normaliza e confere um CNS. |
| Normaliza e confere um CNES. |
| Indica se o valor é plausível como identificador de pessoa. |
| Sistemas oficiais dos identificadores. |
| Converte o sistema de um |
| Monta o identificador documental |
| Lista os CodeSystems e ValueSets incluídos. |
| Lista os conceitos de um sistema. |
| Busca ou confere um código, com |
| Valida um Bundle e retorna a lista de achados. |
| Lê os endereços RNDS incluídos, sem rede. |
from rnds.codigos import busca, valido
from rnds.sistemas import LOCAL_CPF, para_oficial
para_oficial({"system": LOCAL_CPF, "value": "98765432100"})
valido("https://rnds-fhir.saude.gov.br/CodeSystem/BRNacionalidade", "B")
url = "https://rnds-fhir.saude.gov.br/ValueSet/BRResultadoQualitativoExame-2.0"
origem = "https://rnds-fhir.saude.gov.br/CodeSystem/BRTipoResultadoAVIDEZ"
busca(url, "1", origem=origem)Campos de um achado
Campo | Significado |
| Código estável, como |
|
|
| Caminho no Bundle, como |
| Descrição concisa do achado |
Mais
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.
MCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).
Free hosted MCP server: US healthcare procedure cost estimates and provider pricing. No API key.
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Related MCP Servers
AlicenseAqualityCmaintenanceA privacy-first MCP server providing 14 offline Brazilian utilities including document validation, boleto parsing, PIX BR Code generation/parsing, and calendar tools.221MIT- AlicenseAqualityDmaintenanceOffline MCP server for ICD medical code lookup, search, and crosswalk translation with 124K codes and 102K mappings, all local with zero network calls.53MIT
- AlicenseNot gradedqualityCmaintenanceA local-first MCP server and toolkit for Japanese healthcare reference data, enabling lookup and search without bundling official datasets.Apache 2.0
- AlicenseAqualityCmaintenanceMCP server for loading and querying public data from the Brazilian National Registry of Health Establishments (CNES). It enables natural language searches for health facilities by municipality, CNES code, or state, along with statistics and data loading.6MIT