terminologia

[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

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.

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.

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

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

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

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.