{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qcvufefr73q6","handle":"saft-mcp","url":"https://wellknown.network/agents/saft-mcp","links":{"self":"https://wellknown.network/agents/saft-mcp/record.json","html":"https://wellknown.network/agents/saft-mcp","markdown":"https://wellknown.network/agents/saft-mcp/record.md","api":"https://wellknown.network/api/v1/agents/saft-mcp","status":"https://wellknown.network/api/v1/agents/saft-mcp/status","claim":"https://wellknown.network/agents/saft-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/saft-mcp/claim.json","badge":"https://wellknown.network/agents/saft-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/saft-mcp/history","tools":"https://wellknown.network/api/v1/agents/saft-mcp/tools"},"ard":{"identifier":"urn:air::server:saft-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"saft-mcp","summary":"MCP server for parsing and analyzing Portuguese SAF-T XML files","description":"<div align=\"center\">\n\n# SAF-T MCP Server\n\n**Parse and analyze Portuguese SAF-T tax files with AI assistants**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org)\n[![SAF-T PT 1.04_01](https://img.shields.io/badge/SAF--T%20PT-1.04__01-green?style=flat-square)](https://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/SAFT_PT/Paginas/news-saf-t-702.aspx)\n\n[Getting Started](#quick-start) &#183; [Available Tools](#available-tools) &#183; [Configuration](#configuration)\n\n*[Versao em Portugues](README.pt.md)* &#183; *13 tools &#183; 152 tests*\n\n</div>\n\n---\n\nA **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.\n\n### What is SAF-T PT?\n\nSAF-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.\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- **Python 3.11+** and [uv](https://docs.astral.sh/uv/) (recommended) or pip\n- A **SAF-T PT XML file** exported from any Portuguese billing/accounting software (PHC, Sage, Primavera, etc.)\n\n### 1. Clone and install\n\n```bash\ngit clone https://github.com/bybloom-ai/saft-mcp.git\ncd saft-mcp\nuv sync\n```\n\n### 2. Add to your AI assistant\n\n<details open>\n<summary><strong>Claude Code</strong></summary>\n\n```bash\nclaude mcp add saft-mcp -- /path/to/saft-mcp/.venv/bin/pyth…","publisher":null,"homepage":"https://github.com/bybloom-ai/saft-mcp","repository":"https://github.com/bybloom-ai/saft-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["audit","invoices","mcp","portugal","saft","saft-pt","tax"],"pricing":null,"endpoints":[{"url":"pypi:saft-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":1,"provenance":"declared"},{"slug":"finance.accounting","name":"Accounting","confidence":1,"provenance":"declared"},{"slug":"commerce.payments","name":"Payments","confidence":0.814,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["commerce","dev","documents","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"saft-mcp","registry":"pypi","observedAt":"2026-10-22T19:27:56.852Z","publishedAt":"2026-02-25T21:25:43.078465Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"saft-mcp","url":"https://pypi.org/project/saft-mcp/","firstSeenAt":"2026-09-10T11:27:41.926Z","fetchedAt":"2026-10-22T19:26:31.773Z","normalizedAt":"2026-10-22T19:26:31.773Z"}]},"firstSeenAt":"2026-09-10T11:27:41.926Z","updatedAt":"2026-10-22T19:27:56.852Z"}