Skip to content
MCP server

voa-tiss

Validate Brazilian TISS health billing files and look up TUSS and ANS data

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://tiss-api.voa.health/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tiss": {
      "url": "https://tiss-api.voa.health/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government
  6. Russian statutes, Supreme Court guidance and court practice for AI assistants

    • 3 tools
    • Remote
    • Free
    • Legal and government