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.
RNDS para Python
Identificadores brasileiros e códigos da RNDS em uma biblioteca Python, CLI e servidor MCP. As ferramentas offline funcionam sem chamadas de rede.
Projeto de código aberto da Voa Health, não afiliado ao Ministério da Saúde nem ao DATASUS. O extra opcional pip install "rnds[cliente]" permite autenticação mTLS, consultas e envio de Bundles à RNDS via rnds.cliente. O MCP permanece offline.
Início rápido
pip install rnds
rnds cpf 987.654.321-00
rnds cns 712345678901236
rnds cnes 1234567
rnds codigosUse a biblioteca para validar identificadores:
from rnds import cns, cpf, cnes
cpf.valido("987.654.321-00")
cns.valido("712345678901236")
cnes.valido("1234567")Liste CodeSystems e ValueSets ou consulte conceitos offline:
from rnds.codigos import busca, conceitos, sistemas, valido
for sistema in sistemas():
print(sistema.nome, sistema.total)
url = "https://rnds-fhir.saude.gov.br/CodeSystem/BRNacionalidade"
print(conceitos(url))
print(valido(url, "B"))
url = "https://rnds-fhir.saude.gov.br/ValueSet/BRResultadoQualitativoExame-2.0"
origem = "https://rnds-fhir.saude.gov.br/CodeSystem/BRTipoResultadoAVIDEZ"
print(busca(url, "1"))
print(valido(url, "1", origem=origem))Converta um identificador local para o sistema oficial sem alterar seu valor:
from rnds.sistemas import LOCAL_CPF, para_oficial
identificador = para_oficial({"system": LOCAL_CPF, "value": "98765432100"})
print(identificador)Instale pip install "rnds[mcp]" para iniciar rnds mcp ou rnds-mcp. O servidor usa transporte stdio e consulta os mesmos dados locais da biblioteca, incluindo rnds_validate para validar Bundles.
Os valores nos exemplos são sintéticos. Apenas o cliente opcional acessa serviços hospedados.
Related MCP server: mcp-icd10
Validar um Bundle
Valide um Bundle FHIR localmente, sem conexão ou envio à RNDS:
from rnds import validar
bundle = {"resourceType": "Bundle", "type": "collection", "entry": []}
achados = validar(bundle)Também é possível validar um arquivo pela linha de comando ou ler da entrada padrão:
rnds validate bundle.json
cat bundle.json | rnds validate -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 empacotados e que o display corresponda ao conceito.
Erros retornam código de saída 1; somente avisos ou nenhum achado retornam 0.
Problemas de leitura, JSON ou limites retornam 2. O arquivo pode ter até 10 MB e
64 níveis de aninhamento.
A validação de referências não verifica referências absolutas http(s), referências
contidas iniciadas por # nem formatos fora de Tipo/id, Tipo/id/_history/v,
urn:uuid: e urn:oid:.
Este recurso não verifica perfis completos de StructureDefinition, binding de ValueSet por elemento, nem envia dados ou se conecta à RNDS.
Cliente RNDS (Alpha)
Instale com pip install "rnds[cliente]". 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.
Use contexto_mtls e obter_token para autenticação real. 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(cnes=..., cns_paciente=...) é
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; não contêm documentos ou identificadores.
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.
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