terminologia

health.voaPublished by voa.healthv0.1.1Updated Oct 29, 2026

Cliente MCP para consultar terminologias de saúde da Voa.

VerifiedSTDIODesktop onlyKnowledge & Memory Data & Analytics

Server details

Identifier: health.voa/terminologia
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Oct 25, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to voa.health. It runs from a package rather than a hosted endpoint, so there is no endpoint to match against that domain.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/health.voa%2Fterminologia.svg)](https://sourceweft.com/mcp/health.voa%2Fterminologia?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP client for querying Voa's Brazilian health terminologies (CID-10, TUSS, SIGTAP, LOINC and more) over FHIR.

What you can do: Search concepts in a terminology system by free text, with an optional result limit
Look up a single code and validate whether it exists in the published version
Translate a code from one system to another and list the available systems
Query the 59 TISS domain tables and other code systems such as CID-10, CIAP-2, TUSS, SIGTAP, CNES, ANVISA, CBO, LOINC and UCUM
When to use it: Useful when an assistant needs to resolve, check or cross-map Brazilian health codes — diagnoses, procedures, materials, establishments or billing tables — during clinical, billing or integration work, instead of relying on an offline table.
Requirements: Runs locally as a Python package via uvx (terminologia[mcp]); needs a Voa organization product key in TERMINOLOGIA_KEY with the terminology:read scope, and network access to the Voa FHIR endpoint. TERMINOLOGIA_URL can point to a different base URL. Proxy variables must be set before the package is imported.

Before you install

The product key is a secret sent to Voa's service; keep it out of shared configs. Usage is subject to the organization's quota, and errors are raised for invalid keys, denied access, exceeded quota, network or server failures. Queries go to a third-party endpoint, so avoid sending patient-identifying data. Attribution rules apply to CIAP-2 and LOINC output.

Installation

In SourceWeft

Open terminologia in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Voa Health]

[CI] [PyPI] [Python] [Licença] [MCP]

Documentação · tiss

terminologia

Cliente Python e ferramentas MCP para consultar CID-10, CIAP-2, TUSS, TISS, SIGTAP, CNES, ANVISA, CBO, LOINC, UCUM e outros sistemas de terminologia em FHIR.

Início rápido

Crie uma chave de produto da organização em https://tiss-api.voa.health/org e configure:

Chaves sk_tiss_ existentes também podem ser usadas quando possuem o escopo terminology:read.

O endpoint padrão é https://terminologia.voa.health/api/v1/fhir. O argumento base_url do cliente tem precedência; sem ele, defina TERMINOLOGIA_URL para usar outro endpoint.

O cliente segue redirects apenas na mesma origem (esquema, host e porta). Qualquer mudança gera TerminologiaError antes do envio da requisição redirecionada.

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.

python

import terminologia
resultado = terminologia.cid10.buscar("dor torácica")for conceito in resultado:    print(conceito.coding())
consulta = terminologia.tuss.lookup("10101012")if consulta:    print(consulta.display)
for estabelecimento in terminologia.sistema("cnes").buscar("hospital das clínicas", n=5):    print(estabelecimento.code, estabelecimento.display)

import terminologia
resultado = terminologia.cid10.buscar("dor torácica")for conceito in resultado:    print(conceito.coding())
consulta = terminologia.tuss.lookup("10101012")if consulta:    print(consulta.display)
for estabelecimento in terminologia.sistema("cnes").buscar("hospital das clínicas", n=5):    print(estabelecimento.code, estabelecimento.display)

CLI

Comando	Uso
`terminologia buscar <sistema> <texto> [-n N]`	Buscar conceitos
`terminologia lookup <sistema> <código>`	Consultar um código
`terminologia validar <sistema> <código>`	Validar um código
`terminologia traduzir <sistema> <código> --para SISTEMA`	Traduzir um código
`terminologia sistemas`	Listar os sistemas
`terminologia mcp`	Iniciar o servidor MCP local

Use --json nos comandos, exceto mcp, para receber JSON. O código de saída é 0 para sucesso, 1 quando não há resultado ou o código é inválido e 2 para erros de uso, chave, acesso, cota, rede ou servidor.

Conectar agentes

Claude Code:

claude mcp add terminologia -e TERMINOLOGIA_KEY=sk_voa_... -- \  uvx --from "terminologia[mcp]" terminologia mcp

claude mcp add terminologia -e TERMINOLOGIA_KEY=sk_voa_... -- \  uvx --from "terminologia[mcp]" terminologia mcp

Codex (~/.codex/config.toml):

toml

[mcp_servers.terminologia]command = "uvx"args = ["--from", "terminologia[mcp]", "terminologia", "mcp"]
[mcp_servers.terminologia.env]TERMINOLOGIA_KEY = "sk_voa_..."

[mcp_servers.terminologia]command = "uvx"args = ["--from", "terminologia[mcp]", "terminologia", "mcp"]
[mcp_servers.terminologia.env]TERMINOLOGIA_KEY = "sk_voa_..."

Cursor (mcp.json):

json

{  "mcpServers": {    "terminologia": {      "command": "uvx",      "args": ["--from", "terminologia[mcp]", "terminologia", "mcp"],      "env": {        "TERMINOLOGIA_KEY": "sk_voa_..."      }    }  }}

{  "mcpServers": {    "terminologia": {      "command": "uvx",      "args": ["--from", "terminologia[mcp]", "terminologia", "mcp"],      "env": {        "TERMINOLOGIA_KEY": "sk_voa_..."      }    }  }}

Sistemas

Nome	Canônico
`cid10`	`http://hl7.org/fhir/sid/icd-10`
`ciap2`	`http://hl7.org/fhir/sid/icpc-2`
`tuss`	`https://voa.health/fhir/CodeSystem/tuss`
`tuss-diarias`	`https://voa.health/fhir/CodeSystem/tuss-diarias-taxas-gases-medicinais`
`tuss-materiais`	`https://voa.health/fhir/CodeSystem/tuss-materiais-opme`
`tuss-medicamentos`	`https://voa.health/fhir/CodeSystem/tuss-medicamentos`
`sigtap`	`https://voa.health/fhir/CodeSystem/sigtap`
`sigtap-grupo`	`https://voa.health/fhir/CodeSystem/sigtap-grupo`
`sigtap-sub-grupo`	`https://voa.health/fhir/CodeSystem/sigtap-sub-grupo`
`sigtap-servico`	`https://voa.health/fhir/CodeSystem/sigtap-servico`
`sigtap-registro`	`https://voa.health/fhir/CodeSystem/sigtap-registro`
`sigtap-financiamento`	`https://voa.health/fhir/CodeSystem/sigtap-financiamento`
`sigtap-modalidade`	`https://voa.health/fhir/CodeSystem/sigtap-modalidade`
`anvisa`	`urn:voa:anvisa:registro`
`cbo`	`https://voa.health/fhir/CodeSystem/cbo`
`cfm-especialidade`	`https://voa.health/fhir/CodeSystem/cfm-especialidade`
`rol-ans`	`https://voa.health/fhir/CodeSystem/rol-ans`
`dut`	`https://voa.health/fhir/CodeSystem/rol-diretrizes-dut`
`cnes`	`urn:voa:br:cnes`
`ans-operadora`	`urn:voa:br:ans-registro`
`loinc`	`http://loinc.org`
`ucum`	`http://unitsofmeasure.org`
`voa-categoria`	`https://voa.health/fhir/CodeSystem/voa-categoria-servico`

Tabelas de domínio TISS (59)

Também acessíveis por terminologia.tiss_dominio(<número>).

Nome	Canônico
`tiss-23`	`https://voa.health/fhir/CodeSystem/tiss-carater-atendimento`
`tiss-25`	`https://voa.health/fhir/CodeSystem/tiss-codigo-despesa`
`tiss-26`	`https://voa.health/fhir/CodeSystem/tiss-conselho-profissional`
`tiss-27`	`https://voa.health/fhir/CodeSystem/tiss-debitos-creditos`
`tiss-28`	`https://voa.health/fhir/CodeSystem/tiss-dentes`
`tiss-29`	`https://voa.health/fhir/CodeSystem/tiss-diagnostico-imagem`
`tiss-30`	`https://voa.health/fhir/CodeSystem/tiss-escala-capacidade-funcional`
`tiss-31`	`https://voa.health/fhir/CodeSystem/tiss-estadiamento-tumor`
`tiss-32`	`https://voa.health/fhir/CodeSystem/tiss-faces-dente`
`tiss-33`	`https://voa.health/fhir/CodeSystem/tiss-finalidade-tratamento`
`tiss-34`	`https://voa.health/fhir/CodeSystem/tiss-forma-pagamento`
`tiss-35`	`https://voa.health/fhir/CodeSystem/tiss-grau-participacao`
`tiss-36`	`https://voa.health/fhir/CodeSystem/tiss-indicador-acidente`
`tiss-37`	`https://voa.health/fhir/CodeSystem/tiss-indicador-debito-credito`
`tiss-38`	`https://voa.health/fhir/CodeSystem/tiss-mensagens`
`tiss-39`	`https://voa.health/fhir/CodeSystem/tiss-motivo-encerramento`
`tiss-40`	`https://voa.health/fhir/CodeSystem/tiss-origem-guia`
`tiss-41`	`https://voa.health/fhir/CodeSystem/tiss-regime-internacao`
`tiss-42`	`https://voa.health/fhir/CodeSystem/tiss-regioes-boca`
`tiss-43`	`https://voa.health/fhir/CodeSystem/tiss-sexo`
`tiss-44`	`https://voa.health/fhir/CodeSystem/tiss-situacao-inicial-dente`
`tiss-45`	`https://voa.health/fhir/CodeSystem/tiss-status-solicitacao`
`tiss-46`	`https://voa.health/fhir/CodeSystem/tiss-status-cancelamento`
`tiss-47`	`https://voa.health/fhir/CodeSystem/tiss-status-protocolo`
`tiss-48`	`https://voa.health/fhir/CodeSystem/tiss-tecnica-utilizada`
`tiss-49`	`https://voa.health/fhir/CodeSystem/tiss-tipo-acomodacao`
`tiss-50`	`https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento`
`tiss-51`	`https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento-odontologia`
`tiss-52`	`https://voa.health/fhir/CodeSystem/tiss-tipo-consulta`
`tiss-53`	`https://voa.health/fhir/CodeSystem/tiss-tipo-demonstrativo`
`tiss-54`	`https://voa.health/fhir/CodeSystem/tiss-tipo-guia`
`tiss-55`	`https://voa.health/fhir/CodeSystem/tiss-tipo-faturamento`
`tiss-56`	`https://voa.health/fhir/CodeSystem/tiss-natureza-guia`
`tiss-57`	`https://voa.health/fhir/CodeSystem/tiss-tipo-internacao`
`tiss-58`	`https://voa.health/fhir/CodeSystem/tiss-tipo-quimioterapia`
`tiss-59`	`https://voa.health/fhir/CodeSystem/tiss-unidade-federacao`
`tiss-60`	`https://voa.health/fhir/CodeSystem/tiss-unidade-medida`
`tiss-61`	`https://voa.health/fhir/CodeSystem/tiss-via-acesso`
`tiss-62`	`https://voa.health/fhir/CodeSystem/tiss-via-administracao`
`tiss-63`	`https://voa.health/fhir/CodeSystem/tiss-grupos-procedimentos-ans`
`tiss-65`	`https://voa.health/fhir/CodeSystem/tiss-metastases`
`tiss-66`	`https://voa.health/fhir/CodeSystem/tiss-nodulo`
`tiss-67`	`https://voa.health/fhir/CodeSystem/tiss-tumor`
`tiss-68`	`https://voa.health/fhir/CodeSystem/tiss-categoria-despesa`
`tiss-69`	`https://voa.health/fhir/CodeSystem/tiss-versao-componente-comunicacao`
`tiss-70`	`https://voa.health/fhir/CodeSystem/tiss-forma-envio`
`tiss-71`	`https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento-operadora-intermediaria`
`tiss-72`	`https://voa.health/fhir/CodeSystem/tiss-tipo-identificacao-beneficiario`
`tiss-73`	`https://voa.health/fhir/CodeSystem/tiss-etapas-autorizacao`
`tiss-74`	`https://voa.health/fhir/CodeSystem/tiss-motivos-ausencia-codigo-validacao`
`tiss-75`	`https://voa.health/fhir/CodeSystem/tiss-cobertura-especial`
`tiss-76`	`https://voa.health/fhir/CodeSystem/tiss-regime-atendimento`
`tiss-77`	`https://voa.health/fhir/CodeSystem/tiss-saude-ocupacional`
`tiss-78`	`https://voa.health/fhir/CodeSystem/tiss-tipo-pagamento`
`tiss-79`	`https://voa.health/fhir/CodeSystem/tiss-modelos-remuneracao`
`tiss-80`	`https://voa.health/fhir/CodeSystem/tiss-formato-documento`
`tiss-81`	`https://voa.health/fhir/CodeSystem/tiss-tipo-documento`
`tiss-82`	`https://voa.health/fhir/CodeSystem/tiss-centro-consumo`
`tiss-87`	`https://voa.health/fhir/CodeSystem/tiss-terminologias-unificadas`

A allowlist de licença é definida pelo servidor.

Atribuição

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.

Erros

Exceção	Significado
`ChaveInvalidaError`	Chave ausente ou inválida
`AcessoNegadoError`	A chave não tem acesso ao sistema
`CotaExcedidaError`	Cota excedida; consulte `retry_after`
`RedeError`	Falha de conexão
`TempoEsgotadoError`	Tempo limite excedido
`ServidorError`	Erro retornado pelo serviço

terminologia ou tiss.tuss?

tiss.tuss consulta a tabela TUSS offline embutida no pacote tiss. terminologia é o cliente online da terminologia servida pela Voa, cobre todos os sistemas e valida na versão publicada. Requer chave e está sujeito à cota da organização.

Licença

Apache-2.0. Consulte LICENSE.

Source: README.md at commit fc20ae9

Tools

SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

v0.1.1LatestOct 29, 2026
v0.1.0Oct 26, 2026
v0.1.0a2Oct 25, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts