voa-tiss
Validate Brazilian TISS health billing files and look up TUSS and ANS data
- Pricing
- Open source
- Platforms
- API, CLI, Web
- Runs
- Remotely
- Version
- 0.3.0
- Listing updated
- 3 days ago
About voa-tiss
voa-tiss is an open-source MCP server for health and science. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http tiss https://tiss-api.voa.health/mcpAdd to Settings → Connectors → Add custom connector
https://tiss-api.voa.health/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tiss": {
"url": "https://tiss-api.voa.health/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tiss": {
"type": "http",
"url": "https://tiss-api.voa.health/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tiss": {
"serverUrl": "https://tiss-api.voa.health/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tiss": {
"type": "http",
"url": "https://tiss-api.voa.health/mcp"
}
}
}Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Open source
Open source; pip install tiss
Prices change. Check tiss-api.voa.health before you buy.
voa-tiss 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 to voa-tiss

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government
Later Stages
MCP serverCalifornia senior living and care provider records from state licensing and Medicare
- 6 tools
- Remote
- Free
- Health and science
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government

SupplyClub Catalog
MCP serverRussian statutes, Supreme Court guidance and court practice for AI assistants
- 3 tools
- Remote
- Free
- Legal and government