MCP SAT 69 / 69-B · WATR

Server MCP (Model Context Protocol) in Python / FastMCP zur Abfrage der öffentlichen Listen des SAT:

• Artikel 69-B des CFF (EFOS) — simulierte Geschäfte: mutmaßlich, entkräftet, endgültig, günstiges Urteil.

• Artikel 69 des CFF — bestandskräftige Steuersituation: rechtskräftig, fällig, nicht lokalisiert, annulliert, erlassen.

Gleiche Architektur wie das MCP für Einsätze der SSC-CDMX: FastMCP mit Transport stdio + Streamable HTTP, OAuth 2.1 (WorkOS AuthKit) mit Fallback auf statisches Bearer-Token, Persistenz in Turso (libSQL), optionaler Download-Proxy und Deployment auf Render mit externem Cron (GitHub Actions). Kein OCR: Die CSV-Dateien des SAT sind bereits strukturiert.

Tools

Risiko: CRITICO (EFOS endgültig) · ALTO (EFOS mutmaßlich) · MEDIO (69 rechtskräftig/fällig/nicht lokalisiert) · BAJO (entkräftet/günstiges Urteil) · INFORMATIVO (69 annulliert/erlassen) · LIMPIO.

Die Ergebnisse spiegeln den letzten Import der öffentlichen SAT-Dateien wider. Sie stellen keine steuerliche oder rechtliche Beratung dar.

Related MCP server: rues

Architektur

CSV del SAT (Latin-1)                     ┌────────── FastMCP ──────────┐
   │  fetcher (httpx + proxy opcional)    │ verificar_rfc / _lote        │
   ▼                                      │ buscar_nombre / estado_datos │
 pipeline (parse 69 / 69b)  ──►  SQLite ──┤ actualizar_datos             │
   │   (FTS5 unicode61, triggers)  ▲  │   └──────────┬──────────────────┘
   ▼                               │  │   stdio (server.py) + HTTP (web.py)
 Turso (libSQL, durable) ◄── push  │  └► pull al arranque      │
                                   └─────────────────── /health /refresh /reload

• server.py — FastMCP (stdio) + Tools + AuthKit.

• web.py — Starlette/uvicorn (HTTP): /refresh und /reload (M2M-Bearer), /mcp (OAuth oder Bearer).

• pipeline.py — Download → SHA-256 (überspringt, falls unverändert) → Latin-1-Parsing → Ersetzen in SQLite → Push zu Turso.

• database.py — SQLite + FTS5 mit Triggern; RFC über B-Baum-Index (Hot Path).

• turso.py — dauerhafte Synchronisierung Turso ↔ lokal.

• risk.py — RFC-Normalisierung + Veredikt-Baum (69-B hat Vorrang vor 69).

Lokale Installation

cd sat69-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Primera ingesta (descarga ~22 MB; el 69 son ~½ millón de filas)
python -c "from sat69 import database as db, config; db.init_db(config.settings.db_path)"
python -c "from sat69.pipeline import process_import; print(process_import())"

# Probar
pytest -q

Verbindung in Claude Desktop / Cowork (stdio)

{
  "mcpServers": {
    "sat69": { "command": "sat69-mcp" }
  }
}

(oder "command": "python", "args": ["-m", "sat69"] mit aktivem venv.)

Deployment auf Render

render.yaml stellt den Webdienst mit nativem Python-Runtime bereit (ohne Docker):

1. Lade das Repo auf GitHub hoch und erstelle einen Blueprint in Render, der auf render.yaml zeigt.

2. Variablen (markiert mit sync:false): MCP_API_KEY (Bearer), optional AUTHKIT_DOMAIN+BASE_URL (OAuth), TURSO_DATABASE_URL+TURSO_AUTH_TOKEN.

3. MCP-Endpoint: POST https://<servicio>.onrender.com/mcp.

Auth (zwei Modi, wie beim MCP für Einsätze)

• Statischer Bearer (MCP_API_KEY): einfach, schützt /mcp, /refresh, /reload.

• OAuth 2.1 (WorkOS AuthKit): Definiere AUTHKIT_DOMAIN + BASE_URL, und /mcp wechselt zu OAuth mit Dynamic Client Registration; der Bearer schützt weiterhin die M2M-Endpoints.

Automatische Aktualisierung

.github/workflows/refresh.yml führt täglich POST /refresh aus (11:30 UTC ≈ 05:30 CDMX). Repo-Secrets: RENDER_BASE_URL, MCP_API_KEY. Manuell: workflow_dispatch (mit force).

Persistenz (Turso)

Lokales SQLite (flüchtig auf Render, /tmp) bedient die Abfragen; Turso ist der dauerhafte Speicher, der Redeploys übersteht. Beim Start wird ein Pull von Turso durchgeführt; nach jedem actualizar_datos//refresh wird ein Push ausgeführt. Ohne TURSO_* läuft es im reinen lokalen Modus.

Download-Proxy (optional)

FETCH_PROXY oder DATAIMPULSE_* routen nur den Download der CSV-Dateien. In Tests blockierte der SAT keine Rechenzentrums-IPs (direkte Downloads mit 200), daher ist es normalerweise nicht erforderlich; es wird aus Parität und Resilienz beibehalten.

Datenquellen (SAT · Datos Abiertos)

• 69-B: Listado_Completo_69-B.csv (~14.000 Datensätze, 20 Spalten, Header in Zeile 3).

• 69: Firmes.csv, Cancelados.csv, NoLocalizados.csv, Exigibles.csv, Sentencias.csv, Condonados.csv (~½ Million Datensätze, 6 Spalten). URLs in config.py.