English Français العربية

terminologia

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package terminologia
Claude Code 
claude mcp add terminologia -e 'TERMINOLOGIA_KEY=<your terminologia_key>' -e 'TERMINOLOGIA_URL=<TERMINOLOGIA_URL>' -- uvx terminologia==0.1.1 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "terminologia": {
            "command": "uvx",
            "args": [
                "terminologia==0.1.1",
                "mcp"
            ],
            "env": {
                "TERMINOLOGIA_KEY": "<your terminologia_key>",
                "TERMINOLOGIA_URL": "<TERMINOLOGIA_URL>"
            }
        }
    }
}

Environment variables

  • TERMINOLOGIA_KEY required secret Chave de produto da organização (sk_voa_) com escopo terminology:read.
  • TERMINOLOGIA_URL URL base FHIR; substitui o endpoint padrão.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. terminologia
  2. Início rápido
  3. CLI
  4. Conectar agentes
  5. Sistemas
  6. Atribuição
  7. Erros
  8. terminologia ou tiss.tuss?
  9. Licença

Documentação · tiss

terminologia

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

Início rápido

pip install terminologia

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

export TERMINOLOGIA_KEY=sk_voa_...

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

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)

CLI

ComandoUso
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 sistemasListar os sistemas
terminologia mcpIniciar 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

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

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

[mcp_servers.terminologia.env]
TERMINOLOGIA_KEY = "sk_voa_..."

Cursor (mcp.json):

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

Sistemas

NomeCanônico
cid10http://hl7.org/fhir/sid/icd-10
ciap2http://hl7.org/fhir/sid/icpc-2
tusshttps://voa.health/fhir/CodeSystem/tuss
tuss-diariashttps://voa.health/fhir/CodeSystem/tuss-diarias-taxas-gases-medicinais
tuss-materiaishttps://voa.health/fhir/CodeSystem/tuss-materiais-opme
tuss-medicamentoshttps://voa.health/fhir/CodeSystem/tuss-medicamentos
sigtaphttps://voa.health/fhir/CodeSystem/sigtap
anvisaurn:voa:anvisa:registro
cbohttps://voa.health/fhir/CodeSystem/cbo
loinchttp://loinc.org
ucumhttp://unitsofmeasure.org
tiss-50https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento
tiss-52https://voa.health/fhir/CodeSystem/tiss-tipo-consulta
tiss-60https://voa.health/fhir/CodeSystem/tiss-unidade-medida
tiss-76https://voa.health/fhir/CodeSystem/tiss-regime-atendimento
voa-categoriahttps://voa.health/fhir/CodeSystem/voa-categoria-servico

A allowlist de licença é definida pelo servidor.

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.

Erros

ExceçãoSignificado
ChaveInvalidaErrorChave ausente ou inválida
AcessoNegadoErrorA chave não tem acesso ao sistema
CotaExcedidaErrorCota excedida; consulte retry_after
RedeErrorFalha de conexão
TempoEsgotadoErrorTempo limite excedido
ServidorErrorErro 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.

Frequently asked questions

What is terminologia?

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

How do I install terminologia?

It runs on your machine. In Claude Code: claude mcp add terminologia -e 'TERMINOLOGIA_KEY=<your terminologia_key>' -e 'TERMINOLOGIA_URL=<TERMINOLOGIA_URL>' -- uvx terminologia==0.1.1 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does terminologia need an API key?

Yes. It expects TERMINOLOGIA_KEY, which you set in its configuration.

Is terminologia open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains terminologia?

It is published by Voa-Health. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.