MCP server for parsing and analyzing Portuguese SAF-T XML files
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"saft-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<div align="center"> # SAF-T MCP Server **Parse and analyze Portuguese SAF-T tax files with AI assistants** [](LICENSE) [](https://python.org) [](https://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/SAFT_PT/Paginas/news-saf-t-702.aspx) [Getting Started](#quick-start) · [Available Tools](#available-tools) · [Configuration](#configuration) *[Versao em Portugues](README.pt.md)* · *13 tools · 152 tests* </div> --- A **Model Context Protocol (MCP) server** that enables AI assistants like Claude, Cursor, and Windsurf to load, validate, and analyze Portuguese [SAF-T](https://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/SAFT_PT/Paginas/default.aspx) (Standard Audit File for Tax Purposes) XML files. Load a SAF-T file and immediately query invoices, get revenue summaries, VAT breakdowns, and validate compliance with Portuguese tax rules. ### What is SAF-T PT? SAF-T PT is a mandatory XML file that all Portuguese companies must be able to export from their accounting/billing software. It contains the company's invoices, payments, customers, products, tax entries, and more. This MCP server turns that XML into a queryable data source for AI assistants. --- ## Quick Start ### Prerequisites - **Python 3.11+** and [uv](https://docs.astral.sh/uv/) (recommended) or pip - A **SAF-T PT XML file** exported from any Portuguese billing/accounting software (PHC, Sage, Primavera, etc.) ### 1. Clone and install ```bash git clone https://github.com/bybloom-ai/saft-mcp.git cd saft-mcp uv sync ``` ### 2. Add to your AI assistant <details open> <summary><strong>Claude Code</strong></summary> ```bash claude mcp add saft-mcp -- /path/to/saft-mcp/.venv/bin/pyth…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.