Skip to content
Back to search

po-intake-mcp

MCP server: purchase orders from email to a validated draft order. The model proposes, code validates, a person approves — nothing writes to the ERP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/diegoqprobst--po-intake-mcp/badge.svg)](/listings/diegoqprobst--po-intake-mcp)

HTML

<a href="/listings/diegoqprobst--po-intake-mcp"><img src="/api/listings/diegoqprobst--po-intake-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 80 lines
  1. # po-intake-mcp
  2. Servidor MCP que lleva órdenes de compra desde el correo hasta un **pedido en borrador validado**, sin que el modelo escriba nunca en el ERP.
  3. > El modelo propone. El código valida. Una persona aprueba.
  4. Todos los clientes, artículos, precios y correos de `data/` son inventados.
  5. ## Flujo
  6. ```
  7. correo (.eml) -> clasificación -> extracción -> reglas en código -> staging -> aprobación -> erp_outbox/
  8. ```
  9. 1. **Clasificación:** ¿es una OC?, ¿de qué cliente (por dominio del remitente)?, ¿en qué formato?
  10. 2. **Extracción, lo más barato primero:** CSV o Excel con código; formato conocido con plantilla; formato desconocido con un LLM, que viene apagado (`PO_LLM=off`). Si el LLM está apagado, la orden va a la cola de excepciones; no se adivina nada.
  11. 3. **Reglas en código:** cliente conocido, SKU, unidad, cantidad mínima, múltiplo de empaque, precio dentro del ±2 % de la lista, plazo de entrega, total y duplicados. Las reglas corren igual aunque haya extraído el LLM: el modelo no decide.
  12. 4. **Staging:** cada orden queda como borrador o como excepción con su motivo.
  13. 5. **Aprobación:** una persona aprueba o rechaza, y queda registrado quién y por qué.
  14. 6. **`erp_outbox/`:** `approve_order` solo deja un JSON neutro. El adaptador de NetSuite o SAP es una pieza aparte, la única que cambia con el ERP. Ninguna herramienta escribe en el ERP.
  15. **Trazabilidad por capas,** como en OneLake:
  16. - `bronze/`: el `.eml` original, identificado por su SHA-256.
  17. - `silver/`: cada orden con su extracción, el método, el modelo y el resultado de cada regla.
  18. - `gold/`: solo las órdenes aprobadas.
  19. ## Herramientas MCP
  20. | Herramienta | Qué hace |
  21. |---|---|
  22. | `list_inbox` | Lista los correos con remitente, asunto y adjuntos, y si ya se procesaron |
  23. | `process_email` / `process_inbox` | Clasifica, extrae, valida y deja cada orden como borrador o excepción |
  24. | `list_exceptions` | La cola de trabajo de una persona, con el motivo de cada excepción |
  25. | `get_order` | El registro completo, incluido el historial |
  26. | `revalidate_order` | Una persona corrige campos y las reglas vuelven a correr |
  27. | `approve_order` / `reject_order` | Aprueba o rechaza, dejando quién lo hizo y por qué |
  28. | `metrics` | Cantidades por estado y por método de extracción, tasa de órdenes sin intervención, llamadas al LLM y excepciones por regla |
  29. ## Demo con el inbox de ejemplo
  30. | Correo | Resultado | Motivo |
  31. |---|---|---|
  32. | 01 Lácteos, OC en el cuerpo del correo | **borrador** | pasa todas las reglas |
  33. | 02 Snacks, CSV adjunto | excepción | 22 millares no es múltiplo de 5 |
  34. | 03 Café, PDF con formato conocido | excepción | precio un 8 % sobre la lista |
  35. | 04 Remitente desconocido, PDF libre | excepción | formato desconocido y cliente desconocido |
  36. | 05 Lácteos, reenvío de la misma OC | excepción | duplicado |
  37. | 06 Consulta de stock | ignorado | no es una OC |
  38. ## Uso
  39. ```bash
  40. uv sync --all-groups
  41. uv run pytest -q # 13 pruebas, incluida una que levanta el servidor real por stdio
  42. uv run po-intake-mcp # servidor MCP por stdio
  43. ```
  44. En Claude Code:
  45. ```bash
  46. claude mcp add po-intake -- uv --directory /ruta/a/po-intake-mcp run po-intake-mcp
  47. ```
  48. LLM opcional, solo para formatos desconocidos:
  49. ```bash
  50. uv sync --extra llm
  51. PO_LLM=on PO_LLM_MODEL=claude-opus-5-5 uv run po-intake-mcp
  52. ```
  53. Usa salida estructurada con un JSON Schema, así que la respuesta siempre tiene la forma esperada. El modelo se cambia con `PO_LLM_MODEL`, para usar el más barato que alcance la precisión medida.
  54. ## Qué cambia en producción
  55. | Demo | Producción |
  56. |---|---|
  57. | Archivos `.eml` en `data/inbox/` | Microsoft Graph sobre un buzón compartido |
  58. | CSV de maestros | Vista de solo lectura del ERP o de Fabric |
  59. | `staging/` local | Lakehouse en OneLake (bronze, silver y gold) y Power BI sobre gold |
  60. | `erp_outbox/` | Adaptador de NetSuite o SAP con su propia autenticación |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.