terminologia
Provides search and lookup of Brazilian CNES (Cadastro Nacional de Estabelecimentos de Saúde) codes, allowing agents to query health establishment records by name or code through the terminology API.
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.
Busque, consulte, valide e traduza códigos de CID-10, CIAP-2, TUSS, tabelas de
domínio TISS, SIGTAP, CNES, ANVISA, CBO, LOINC, UCUM e outros sistemas, sempre
como Coding FHIR: um cliente Python sem dependências, uma CLI e um MCP local
para o seu agente de IA.
Usa Claude Code, Codex ou Cursor? Conecte o MCP e peça em português, por exemplo "qual o CID-10 de dor torácica?". VejaConectar agentes.
Início rápido
pip install terminologiaCrie a chave sk_voa_ da organização no
painel da organização e configure:
export TERMINOLOGIA_KEY=sk_voa_...import terminologia
for conceito in terminologia.cid10.buscar("dor torácica", n=3):
print(conceito.coding())
validacao = terminologia.cid10.validar("R07.4")
print(validacao.valido, validacao.conceito)
consulta = terminologia.tuss.lookup("10101012")
if consulta:
print(consulta.display)Cada conceito traz system, code, display e version, prontos para um
Coding FHIR. Requer Python 3.10+.
Related MCP server: snowstorm-mcp-server
Acesso e limites
Use uma chave de organização (sk_voa_) ou de membro (sk_user_), com escopo
terminology:read, criada no console.
Configure-a em TERMINOLOGIA_KEY. O MCP hospedado em
https://api.voa.health/mcp/terminology/ aceita Authorization: Bearer <chave>
ou OAuth.
A cota diária por organização é compartilhada entre Terminologia, RNDS e SNCR,
por chave e OAuth: 1.000 consultas com login, 10.000 para organizações
verificadas; organizações pessoais Pro/Trial/Ultra não têm limite.
Ao exceder a cota, HTTP 429 informa retry_after quando disponível e um link
para o console (o cabeçalho Retry-After também pode estar presente).
Quando a cobrança estiver habilitada, HTTP 402 traz
error_name: "PAYMENT_REQUIRED" e metadata.billing_url para pagamento.
Consulte os preços públicos via
GET /api/v2/product/terminology/pricing/.
CLI
Execute sem instalar com uvx terminologia buscar cid10 "dor torácica".
Comando | Uso |
| Busca conceitos pelo texto. |
| Consulta um código. |
| Valida um código. |
| Traduz um código para outro sistema. |
| Lista os sistemas. |
| Inicia o MCP local em stdio; requer |
Use --json nos comandos, exceto mcp, para receber JSON. Os códigos de saída
são 0 para sucesso, 1 quando não há resultado ou o código é inválido e 2
para uso inválido ou erros de chave, acesso, cota, rede ou servidor.
Como funciona
Você não precisa decorar códigos nem montar requisições FHIR à mão:
Busque o conceito pelo texto com
buscar.Confira o display oficial com
lookup.Valide o código com
validarantes de gravá-lo em um recurso FHIR.Use o
systemdevolvido comoCoding.system.
Cada busca informa em degradado quando a resposta é parcial; isso não
significa que o código não existe. CID-10 aceita o código com ou sem ponto.
Conectar agentes
O MCP local roda em stdio e expõe terminologia_buscar, terminologia_lookup,
terminologia_validar, terminologia_traduzir e terminologia_sistemas:
claude mcp add terminologia -e TERMINOLOGIA_KEY=sk_voa_... -- \
uvx --from "terminologia[mcp]" terminologia mcpAgentes encontram instruções em AGENTS.md e em llms.txt.
Codex e Cursor
No Codex, adicione a ~/.codex/config.toml:
[mcp_servers.terminologia]
command = "uvx"
args = ["--from", "terminologia[mcp]", "terminologia", "mcp"]
[mcp_servers.terminologia.env]
TERMINOLOGIA_KEY = "sk_voa_..."No Cursor, adicione ao mcp.json:
{
"mcpServers": {
"terminologia": {
"command": "uvx",
"args": ["--from", "terminologia[mcp]", "terminologia", "mcp"],
"env": {
"TERMINOLOGIA_KEY": "sk_voa_..."
}
}
}
}ChatGPT
O pacote ChatGPT reúne os manifests, a skill em português e
os casos sintéticos de revisão para consultas de terminologia sem dados de paciente.
Usa o MCP remoto https://api.voa.health/mcp/terminology/ (também o recurso OAuth),
com transporte streamable-http, OAuth em modo CIMD e o único escopo
voa:terminology:read. A descoberta OAuth fica em
https://api.voa.health/.well-known/oauth-protected-resource/terminology.
O pacote não executa o servidor stdio nem pede senha ou token na conversa. As cinco ferramentas são somente leitura. Não envie dados de paciente nem pedidos de diagnóstico ou conduta clínica. A conexão OAuth com o ChatGPT e a submissão no portal precisam de verificação separada; o pacote não indica disponibilidade no diretório.
Configuração
Variável | Uso |
| Chave |
| Endpoint FHIR; o padrão é |
Os argumentos api_key e base_url de Terminologia têm precedência sobre as
variáveis. Cada consulta entra na cota da organização; ao excedê-la, o cliente
levanta CotaExcedidaError com retry_after.
O cliente segue redirects apenas na mesma origem (esquema, host e porta) e
levanta TerminologiaError antes de enviar a chave a outra origem.
O transporte usa um opener próprio criado ao importar o pacote. Defina
HTTP_PROXY, HTTPS_PROXY e NO_PROXY antes do import; openers globais de
urllib.request.install_opener() não são usados.
Sistemas
Nome | Sistema | Canônico |
| CID-10 — variante brasileira |
|
| CIAP-2 — Classificação Internacional de Atenção Primária |
|
| TUSS Tabela 22 — procedimentos |
|
| TUSS Tabela 18 — diárias, taxas e gases medicinais |
|
| TUSS Tabela 19 — materiais e OPME |
|
| TUSS Tabela 20 — medicamentos |
|
| SIGTAP — procedimentos do SUS |
|
| SIGTAP — grupos de procedimento |
|
| SIGTAP — subgrupos de procedimento |
|
| SIGTAP — serviços especializados |
|
| SIGTAP — instrumentos de registro |
|
| SIGTAP — tipos de financiamento |
|
| SIGTAP — modalidades de atendimento |
|
| ANVISA — produtos e apresentações |
|
| CBO 2002 — ocupações |
|
| CFM — especialidades médicas |
|
| Rol de Procedimentos e Eventos em Saúde da ANS |
|
| Rol da ANS — diretrizes de utilização (DUT) |
|
| CNES — estabelecimentos de saúde |
|
| ANS — operadoras ativas |
|
| LOINC — exames e observações |
|
| UCUM — unidades de medida |
|
| Voa — categoria de serviço |
|
Também acessíveis por terminologia.tiss_dominio(<número>).
Nome | Tabela | Canônico |
| TISS Tabela 23 — caráter do atendimento |
|
| TISS Tabela 25 — código da despesa |
|
| TISS Tabela 26 — conselho profissional |
|
| TISS Tabela 27 — débitos e créditos |
|
| TISS Tabela 28 — dentes |
|
| TISS Tabela 29 — diagnóstico por imagem |
|
| TISS Tabela 30 — escala de capacidade funcional (ECOG - escala de Zubrod) |
|
| TISS Tabela 31 — estadiamento do tumor |
|
| TISS Tabela 32 — faces do dente |
|
| TISS Tabela 33 — finalidade do tratamento |
|
| TISS Tabela 34 — forma de pagamento |
|
| TISS Tabela 35 — grau de participação |
|
| TISS Tabela 36 — indicador de acidente |
|
| TISS Tabela 37 — indicador de débito ou crédito |
|
| TISS Tabela 38 — mensagens (glosas, negativas e outras) |
|
| TISS Tabela 39 — motivo de encerramento |
|
| TISS Tabela 40 — origem da guia |
|
| TISS Tabela 41 — regime de internação |
|
| TISS Tabela 42 — regiões da boca |
|
| TISS Tabela 43 — sexo |
|
| TISS Tabela 44 — situação inicial do dente |
|
| TISS Tabela 45 — status da solicitação |
|
| TISS Tabela 46 — status do cancelamento |
|
| TISS Tabela 47 — status do protocolo |
|
| TISS Tabela 48 — técnica utilizada |
|
| TISS Tabela 49 — tipo de acomodação |
|
| TISS Tabela 50 — tipo de atendimento |
|
| TISS Tabela 51 — tipo de atendimento em odontologia |
|
| TISS Tabela 52 — tipo de consulta |
|
| TISS Tabela 53 — tipo de demonstrativo |
|
| TISS Tabela 54 — tipo de guia |
|
| TISS Tabela 55 — tipo de faturamento |
|
| TISS Tabela 56 — natureza da guia |
|
| TISS Tabela 57 — tipo de internação |
|
| TISS Tabela 58 — tipo de quimioterapia |
|
| TISS Tabela 59 — unidade da federação |
|
| TISS Tabela 60 — unidade de medida |
|
| TISS Tabela 61 — via de acesso |
|
| TISS Tabela 62 — via de administração |
|
| TISS Tabela 63 — grupos de procedimentos e itens assistenciais para envio à ANS |
|
| TISS Tabela 65 — metástases |
|
| TISS Tabela 66 — nódulo |
|
| TISS Tabela 67 — tumor |
|
| TISS Tabela 68 — categoria de despesa |
|
| TISS Tabela 69 — versão do componente de comunicação do padrão |
|
| TISS Tabela 70 — forma de envio do padrão |
|
| TISS Tabela 71 — tipo de atendimento por operadora intermediária |
|
| TISS Tabela 72 — tipo de identificação do beneficiário |
|
| TISS Tabela 73 — etapas de autorização |
|
| TISS Tabela 74 — motivos de ausência do código de validação |
|
| TISS Tabela 75 — cobertura especial |
|
| TISS Tabela 76 — regime de atendimento |
|
| TISS Tabela 77 — saúde ocupacional |
|
| TISS Tabela 78 — tipo de pagamento |
|
| TISS Tabela 79 — modelos de remuneração entre operadoras e prestadores |
|
| TISS Tabela 80 — formato do documento |
|
| TISS Tabela 81 — tipo do documento |
|
| TISS Tabela 82 — centro de consumo |
|
| TISS Tabela 87 — relação das terminologias unificadas na saúde suplementar |
|
O servidor define quais sistemas cada chave pode consultar.
Atribuição
CIAP-2 (ICPC-2) © WONCA International Classification Committee. Cite a WONCA ao exibir códigos CIAP-2.
This material contains content from LOINC® (http://loinc.org). LOINC is copyright © Regenstrief Institute, Inc. and the LOINC Committee and is available at no cost under the license at http://loinc.org/license.
A CLI imprime a atribuição em stderr ao consultar esses sistemas.
Referência
Símbolos da biblioteca
Símbolo | Uso |
| Atalhos para os sistemas mais usados. |
| Tabelas TUSS 19, 20 e 18. |
| Encontra um sistema pelo nome ou URL canônico. |
| Encontra uma tabela de domínio TISS pelo número. |
| Lista todos os sistemas. |
| Busca conceitos e retorna um |
| Consulta um código e retorna um |
| Valida um código e retorna uma |
| Cliente com chave, endpoint e |
| Associa um sistema a esse cliente. |
| Operações FHIR |
| Retorna o conceito como |
from terminologia import Terminologia
cliente = Terminologia(api_key="sk_voa_...", timeout=30)
for estabelecimento in cliente.sistema("cnes").buscar("hospital das clínicas", n=5):
print(estabelecimento.code, estabelecimento.display)Erros
Todas as exceções herdam de TerminologiaError, que traz status, codigo e
mensagem.
Exceção | Significado |
| Chave ausente ou inválida ( |
| A chave não tem acesso ao sistema ( |
| Cota excedida ( |
| Pagamento necessário ( |
| Falha de conexão. |
| Tempo limite excedido. |
| Erro retornado pelo serviço. |
terminologia ou tiss.tuss?
tiss.tuss consulta offline a tabela TUSS embutida no pacote
tiss. terminologia consulta online
todos os sistemas acima na versão publicada; requer chave e entra na cota da
organização.
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
WHO ICD-10/ICD-11 diagnosis codes. Lookup, search, chapters via official WHO API.
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Diagnoses, drugs & lab codes: ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10. 33 tools, MIT.
Ferramentas para validar documentos TISS e consultar TUSS, operadoras e dados da ANS.
Related MCP Servers
AlicenseAqualityBmaintenanceProvides AI agents with instant access to 10M+ OMOP medical vocabulary concepts for searching, mapping, and navigating clinical codes across SNOMED, ICD-10, RxNorm, LOINC, and more.1168 npm7MIT
snowstorm-mcp-serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to look up, search, validate, navigate hierarchies, and expand value sets for SNOMED CT clinical terminology through the Model Context Protocol.9Apache 2.0- AlicenseNot gradedqualityDmaintenanceEnables querying and browsing SNOMED CT medical terminology concepts, including search, details, and hierarchy navigation via MCP tools.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching clinical terms and codes across UMLS vocabularies, retrieving concept details, listing source-asserted atoms, and crosswalking codes between vocabularies via the NLM UMLS Terminology Services REST API.311 npmMIT