SAT69 — Listas negras del SAT (69, 69-B, 69-B Bis y CSD)

io.github.edbrorPublished by GitHub account edbrorv1.1.0Updated Nov 2, 2026

Verifica RFCs contra las listas del SAT (69, 69-B EFOS, 69-B Bis, CSD): veredicto de riesgo fiscal.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Checks Mexican RFC tax IDs against the SAT's public 69, 69-B (EFOS), 69-B Bis and CSD blacklists and returns a fiscal risk verdict.

What you can do
  • Verify a single RFC and get a risk verdict from CRITICO to LIMPIO, or NO_VERIFICADO when a list lacks data
  • Validate up to 500 RFCs in a batch and get only the findings, ordered by severity
  • Search by name or company name with accent-insensitive full-text search
  • Check data status: SAT-declared validity, record counts and last import
  • Refresh the listings by downloading and syncing the SAT CSV files
  • Produce a natural-language executive brief for a portfolio of up to 500 RFCs
When to use it
Useful for tax, compliance, procurement or accounts-payable work where an assistant must screen suppliers or a client portfolio against Mexico's SAT blacklists and summarize the fiscal risk. Also handy for bulk checks of RFC lists before invoicing or onboarding.
Requirements
Remote endpoint with OAuth required; the README also describes a local Python install (pip, FastMCP) over stdio. Self-hosting needs MCP_API_KEY for bearer auth, optionally AUTHKIT_DOMAIN and BASE_URL for OAuth, and TURSO_DATABASE_URL plus TURSO_AUTH_TOKEN for durable storage; an optional FETCH_PROXY routes CSV downloads. The portfolio brief uses an LLM provider selectable via LLM_PROVIDER.
Before you install
Results reflect the last import of SAT public files and are explicitly not tax or legal advice. The refresh tool downloads and replaces the local dataset, and the README notes the replacement is destructive, guarded only by freshness checks. Self-hosting requires secrets such as MCP_API_KEY, TURSO_AUTH_TOKEN and LLM provider credentials; the portfolio brief sends resolved verdicts to a third-party LLM provider.

Installation

In SourceWeft

  1. Open SAT69 — Listas negras del SAT (69, 69-B, 69-B Bis y CSD) in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.edbror%2Fsat69-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "sat69-listas-negras-del-sat-69-69-b-69-b": {
      "type": "http",
      "url": "https://sat69.watr.mx/connect"
    }
  }
}

README

MCP SAT 69 / 69-B · WATR

Servidor MCP (Model Context Protocol) en Python / FastMCP para consultar las listas públicas del SAT:

  • Artículo 69-B del CFF (EFOS) — operaciones simuladas: Presunto, Desvirtuado, Definitivo, Sentencia Favorable.
  • Artículo 69-B Bis del CFF — transmisión indebida del derecho a disminuir pérdidas fiscales: Definitivo, Sentencia Favorable. Es señal de riesgo del contribuyente, pero no invalida sus CFDI por sí sola. Lista diminuta: 3 registros en todo el país (sep-2026), así que un conteo de un dígito es correcto, no una importación fallida.
  • Artículo 69 del CFF — situación fiscal firme: firmes, exigibles, no localizados, cancelados, condonados.

Misma arquitectura que el MCP de movilizaciones de la SSC-CDMX: FastMCP con transporte stdio + Streamable HTTP, OAuth 2.1 (WorkOS AuthKit) con fallback a bearer estático, persistencia en Turso (libSQL), proxy de descarga opcional, y despliegue en Render con cron externo (GitHub Actions). Sin OCR: los CSV del SAT ya vienen estructurados.

Tools

ToolQué hace
verificar_rfcVerifica un RFC → veredicto de riesgo (CRITICO…LIMPIO, o NO_VERIFICADO si alguna lista está sin datos).
verificar_loteValida hasta 500 RFCs; devuelve sólo hallazgos por severidad.
buscar_nombreBúsqueda por nombre/razón social (FTS5, insensible a acentos).
estado_datosVigencia declarada por el SAT, conteos y última importación.
actualizar_datosDescarga + sincroniza los listados (idempotente por hash, con guard de frescura).
resumen_carteraBrief ejecutivo en lenguaje natural de una cartera (hasta 500 RFCs).

Prioridad de severidad entre listas: 69-B > 69-B Bis > 69.

⚠️ resumen_cartera es el único tool con IA, y sólo redacta. El riesgo de cada RFC lo calcula el motor de reglas (determinista); el modelo recibe esos veredictos ya resueltos y escribe el brief — nunca decide un riesgo ni cambia uno. Proveedor conmutable con LLM_PROVIDER (qwen por default vía DashScope; también anthropic y gemini). Sin IA configurada el tool igual responde: devuelve los datos deterministas con resumen: null.

Riesgo: CRITICO (EFOS definitivo) · ALTO (EFOS presunto) · MEDIO (69 firme/exigible/no localizado) · BAJO (desvirtuado/sentencia favorable) · INFORMATIVO (69 cancelado/condonado) · LIMPIO.

Los resultados reflejan la última importación de los archivos públicos del SAT. No constituyen asesoría fiscal ni legal.

Arquitectura

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): /health (abierto), /refresh y /reload (bearer M2M), /mcp (OAuth o bearer).
  • pipeline.py — descarga → SHA-256 (omite si no cambió) → parse Latin-1 → guard de frescura → reemplazo en SQLite → push a Turso. El guard aborta el reemplazo si el archivo nuevo trae 0 filas habiendo datos, pierde más del 10% de las filas previas, o declara una fecha del SAT anterior a la ya importada: el reemplazo es destructivo y la fuente es de un tercero. El piso es relativo, no un mínimo absoluto, porque conviven listas de 243k filas y de 3.
  • database.py — SQLite + FTS5 con triggers; RFC por índice B-tree (camino caliente).
  • turso.py — sync durable Turso ↔ local.
  • risk.py — normalización de RFC + árbol de veredicto (69-B manda sobre 69).

Instalación local

bash
cd sat69-mcppython -m venv .venv && source .venv/bin/activatepip 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())"
# Probarpytest -q

Conectar en Claude Desktop / Cowork (stdio)

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

(o "command": "python", "args": ["-m", "sat69"] con el venv activo.)

Despliegue en Render

render.yaml provisiona el servicio web con runtime Python nativo (sin Docker):

  1. Sube el repo a GitHub y crea un Blueprint en Render apuntando a render.yaml.
  2. Variables (marcadas sync:false): MCP_API_KEY (bearer), opcional AUTHKIT_DOMAIN+BASE_URL (OAuth), TURSO_DATABASE_URL+TURSO_AUTH_TOKEN.
  3. Endpoint MCP: POST https://<servicio>.onrender.com/mcp.

Auth (dos modos, igual que movilizaciones)

  • Bearer estático (MCP_API_KEY): simple, protege /mcp, /refresh, /reload.
  • OAuth 2.1 (WorkOS AuthKit): define AUTHKIT_DOMAIN + BASE_URL y /mcp pasa a OAuth con Dynamic Client Registration; el bearer sigue protegiendo los endpoints M2M.

Refresco automático

.github/workflows/refresh.yml hace POST /refresh diario (11:30 UTC ≈ 05:30 CDMX). Secrets del repo: RENDER_BASE_URL, MCP_API_KEY. Manual: workflow_dispatch (con force).

Persistencia (Turso)

SQLite local (efímero en Render, /tmp) atiende las consultas; Turso es el almacén durable que sobrevive redeploys. Al arrancar se hace pull de Turso; tras cada actualizar_datos//refresh se hace push. Sin TURSO_*, corre en modo local puro.

Proxy de descarga (opcional)

FETCH_PROXY o DATAIMPULSE_* enrutan sólo la descarga de los CSV. En pruebas el SAT no bloqueó IPs de datacenter (descargas 200 directas), así que normalmente no hace falta; se conserva por paridad y resiliencia.

Fuentes de datos (SAT · Datos Abiertos)

  • 69-B: Listado_Completo_69-B.csv (~14 k registros, 20 columnas, header en línea 3).
  • 69: Firmes.csv, Cancelados.csv, NoLocalizados.csv, Exigibles.csv, Sentencias.csv, Condonados.csv (~½ millón de registros, 6 columnas). URLs en config.py.

Source: README.md at commit 63b3102

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v1.1.0LatestOct 12, 2026
  2. v1.0.0Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.