# voa-tiss

> Ferramentas para validar documentos TISS e consultar TUSS, operadoras e dados da ANS.

- name: health.voa/tiss
- version: 0.3.0
- connection class: R0 (autonomous)
- trust: 96/100
- quality: 73/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/health.voa%2Ftiss
- tools: https://api.protogrid.dev/v1/servers/health.voa%2Ftiss/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "tiss": {
      "type": "http",
      "url": "https://tiss-api.voa.health/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% +updated-16d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 73/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: tiss_sadt_catalog (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); tiss_hash (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); tiss_autorizacao_build (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 3,024 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 10 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 26, about 3,024 tokens to load them all
- tool set hash: 13022203918b49fc13eeebc9f8c87a8a
- tools last changed: 2026-10-31T01:26:22.480Z
- badge: [![protogrid quality](https://protogrid.dev/badge/health.voa/tiss.svg)](https://protogrid.dev/servers/health.voa/tiss)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-31 `tiss_rejection_map` changed (outputSchema)
- 2026-10-23 `tiss_referencia` added
  - Consulta valores unitários de referência D-TISS da ANS por procedimento TUSS. Quando usar: para comparar valores informados por UF, modalidade, porte e semestre. Quando não usar: para glosa ou preço contratado de uma operadora; use as ferramentas de operadoras.
- 2026-10-22 `tiss_sandbox_autorizacao` added
  - Gera uma resposta SP/SADT sintética nos cenários disponíveis.
- 2026-10-22 `tiss_autorizacao_check` added
  - Valida uma solicitação SP/SADT e retorna uma decisão explicável.
- 2026-10-22 `tiss_autorizacao_parse` added
  - Interpreta solicitações e respostas de autorização SP/SADT.
- 2026-10-22 `tiss_autorizacao_build` added
  - Gera XML TISS 4.03.00 para solicitação ou resposta de autorização SP/SADT.
- 2026-10-22 `tiss_rejection_map` added
  - Agrega achados por prestador e mês, sem expor dados das guias; CPF é pseudonimizado. Quando usar: para analisar rejeições por prestador. Quando não usar: para consultar guias individuais ou corrigir lotes.
- 2026-10-22 `tiss_audit` changed (inputSchema, outputSchema)
- 2026-10-22 `tiss_sandbox_enviar_lote` changed (inputSchema)
- 2026-10-22 `tiss_validate` changed (outputSchema)

Full history: https://api.protogrid.dev/v1/servers/health.voa%2Ftiss/changes

## Remotes

- https://tiss-api.voa.health/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (26)

- `buscar_docs`: Busca trechos da documentação local da biblioteca. Quando usar: para encontrar instruções e referências da API. Quando não usar: para consultar dados clínicos ou códigos específicos.
- `glosa_explain`: Explica um código da Tabela 38 da ANS. Quando usar: ao interpretar uma glosa recebida. Quando não usar: para validar ou corrigir o lote.
- `operadora_lookup`: Busca operadoras ativas pelo nome, registro, CNPJ ou localidade. Quando usar: para localizar uma operadora na base pública. Quando não usar: para consultar vínculos hospitalares; use tiss_rede.
- `operadora_perfil`: Consulta o cadastro e a série semestral de glosa e pagamento de uma operadora na ANS. Quando usar: para conhecer uma operadora pelo registro ANS. Quando não usar: para buscar operadoras por nome.
- `operadora_rede`: Consulta os estabelecimentos vinculados a uma operadora. Quando usar: para identificar unidades da rede por UF. Quando não usar: para buscar o cadastro geral; use operadora_lookup.
- `tiss_apply_fixes`: Aplica correções JSON Patch de um relatório ao lote. Quando usar: depois de tiss_validate ou tiss_audit com achados corrigíveis. Quando não usar: para inventar dados ausentes; peça-os ao usuário.
- `tiss_audit`: Audita um lote JSON com regras locais e contexto da operadora. Quando usar: para identificar inconsistências administrativas. Quando não usar: para aplicar correções; use tiss_apply_fixes.
- `tiss_autorizacao_build`: Gera XML TISS 4.03.00 para solicitação ou resposta de autorização SP/SADT.
- `tiss_autorizacao_check`: Valida uma solicitação SP/SADT e retorna uma decisão explicável.
- `tiss_autorizacao_parse`: Interpreta solicitações e respostas de autorização SP/SADT.
- `tiss_build`: Gera o XML TISS 4.03.00 de um lote em JSON, com hash do epílogo. Consulte tiss://schemas/lote para o esquema estrutural. Quando usar: depois de validar o lote em JSON sem erros. Quando não usar: para corrigir achados; use tiss_apply_fixes.
- `tiss_dominio`: Consulta tabelas e códigos de domínio TISS. Quando usar: para localizar um código ou termo de domínio. Quando não usar: para buscar procedimentos TUSS; use tuss_search.
- `tiss_hash`: Calcula o hash do epílogo de um XML TISS. Quando usar: para conferir a integridade do XML. Quando não usar: para validar o conteúdo; use tiss_validate.
- `tiss_parse_demonstrativo`: Lê decisões de um demonstrativo. Quando usar: para identificar pagamentos e glosas. Quando não usar: para validar lotes.
- `tiss_plan_reconciliation`: Propõe vínculos entre decisões e guias. Quando usar: após ler um demonstrativo. Quando não usar: para alterar guias.
- `tiss_rede`: Consulta as operadoras vinculadas a um CNPJ ou CNES. Quando usar: para identificar vínculos de um estabelecimento. Quando não usar: para buscar o cadastro geral; use operadora_lookup.
- `tiss_referencia`: Consulta valores unitários de referência D-TISS da ANS por procedimento TUSS. Quando usar: para comparar valores informados por UF, modalidade, porte e semestre. Quando não usar: para glosa ou preço contratado de uma operadora; use as ferramentas de operadoras.
- `tiss_rejection_map`: Agrega achados por prestador e mês, sem expor dados das guias; CPF é pseudonimizado. Quando usar: para analisar rejeições por prestador. Quando não usar: para consultar guias individuais ou corrigir lotes.
- `tiss_sadt_catalog`: Retorna o catálogo SP/SADT. Quando usar: para conhecer campos e domínios. Quando não usar: para preencher uma guia sem dados.
- `tiss_sadt_missing`: Identifica campos obrigatórios SP/SADT ausentes. Quando usar: antes de renderizar uma guia. Quando não usar: para validar um lote.
- `tiss_sandbox_autorizacao`: Gera uma resposta SP/SADT sintética nos cenários disponíveis.
- `tiss_sandbox_demonstrativo`: Gera o demonstrativo de um protocolo simulado. Quando usar: após enviar um lote. Quando não usar: com protocolo de outra operadora.
- `tiss_sandbox_enviar_lote`: Envia um lote à operadora simulada. Quando usar: para testar integração local. Quando não usar: para transmitir dados reais.
- `tiss_validate`: Valida XML TISS ou lote em JSON. Quando usar: antes de gerar ou enviar um lote. Quando não usar: para corrigir achados sem aplicar o ciclo validar → tiss_apply_fixes → validar de novo.
- `tuss_lookup`: Busca um código TUSS exato. Quando usar: para consultar código ou vigência. Quando não usar: para buscar por descrição.
- `tuss_search`: Busca códigos TUSS por texto. Quando usar: para localizar procedimentos por descrição. Quando não usar: para validar XML.