# voa-tiss

> voa-tiss is an open-source MCP server for health and science. Validate Brazilian TISS health billing files and look up TUSS and ANS data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Web
- **Website:** https://tiss-api.voa.health
- **Repository:** https://github.com/voa-health/tiss
- **MCP Registry name:** health.voa/tiss
- **Categories:** health and science, legal and government
- **Listing updated:** 2026-11-14

## About

The TISS standard is used for billing between healthcare providers and insurers in Brazil, and this project is documentation-first and in Portuguese. A Python library runs offline, an HTTP API is hosted at tiss-api.voa.health, and a remote MCP exposes 25 tools to an agent. A local stdio MCP starts with tiss mcp.

The workflow it describes is validate, fix, revalidate and generate. Findings carry stable codes, a location and, where possible, a ready fix. Corrections are deterministic JSON Patch via apply_fixes, needs says what data to ask for, build_lote generates the XML and hash_epilogo computes the epilogue hash. After submission, parse_demonstrativo reads the insurer's return, glosa explains each code from Table 38 and plan_reconciliation reconciles paid against billed amounts.

It targets providers, health professionals, insurers (checking batches against their own rules), patients wanting plain-language glosa explanations, and public managers using open ANS data. A simulated insurer is available for testing and a GitHub Action validates batches in CI.

## Features

- **Offline validation:** Check TISS XML or JSON batches with stable finding codes.
- **Deterministic fixes:** apply_fixes produces JSON Patch corrections.
- **Batch generation:** build_lote generates XML and hash_epilogo computes the epilogue hash.
- **Glosa explanations:** Explains rejection codes from Table 38.
- **Reconciliation:** Reads remittance statements and reconciles paid against billed.
- **Open ANS data:** Look up TUSS codes, insurers and ANS data.

## Good for

- Catch billing errors before sending to the insurer
- Understand why a claim was glosada
- Look up a TUSS procedure code
- Reconcile what the insurer paid with what was billed
- Validate batches in a GitHub Actions pipeline

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tiss https://tiss-api.voa.health/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tiss-api.voa.health/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tiss": {
      "serverUrl": "https://tiss-api.voa.health/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `check`: Validate a batch
- `validate`: Validate a batch
- `apply_fixes`: Apply deterministic JSON Patch fixes
- `build_lote`: Generate the batch XML
- `hash_epilogo`: Compute the epilogue hash
- `parse_demonstrativo`: Read the insurer's return statement
- `glosa`: Explain a Table 38 code
- `plan_reconciliation`: Reconcile paid against billed

## FAQ

### Does validation need internet?

No. The Python library and CLI run offline.

### How do I add the MCP to Claude Code?

Run claude mcp add tiss -- uvx --from "tiss[mcp]" tiss mcp.

### What Python version is required?

Python 3.10 or later.

### Is there a test insurer?

Yes, a simulated operadora for testing without a real one.

### Is voa-tiss free?

Yes. voa-tiss is open source, so you can use and self-host it for free.

### How do I add voa-tiss to Claude Code?

Run this command in your terminal: claude mcp add --transport http tiss https://tiss-api.voa.health/mcp

### What are the best alternatives to voa-tiss?

The closest alternatives to voa-tiss are Tooluniverse, Oya Browser, NY LLC Publication (FileMyPublication), Later Stages and TribuJus.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/voa-tiss
