AgentPostage

npx add-mcp 'https://agentpostage.com/mcp'

AgentPostage

Tu agente puede escribir la carta. Ahora puede enviarla por correo.

AgentPostage convierte un PDF, una dirección de remitente de EE. UU. y una dirección de destinatario de EE. UU. en correo físico. Envía disputas bancarias, cancelaciones de gimnasio, solicitudes a agencias de crédito, avisos y formularios completados desde tu agente. La impresión, un sobre, una portada con la dirección y el franqueo de EE. UU. están incluidos.

Este repositorio contiene una habilidad de correo portátil, complementos para Claude Code, Codex y Cursor, una extensión para Gemini CLI y una CLI independiente de Node.js. Conéctate a través de MCP o la API HTTP, o usa una Acción GPT privada en ChatGPT.

Comienza aquí

1. Crea y verifica tu cuenta en Connect, acepta las políticas del servicio y crea una clave API con nombre.
2. Agrega fondos prepagados en Billing. El pago mínimo es de $10. No hay suscripción.
3. Coloca la clave en el almacén de secretos de tu agente como AGENTPOSTAGE_API_KEY, luego sigue tu configuración de agente. Nunca la pegues en una conversación.

Instala la habilidad para un agente compatible con la CLI de habilidades:

npx skills add ctxrs/agentpostage --skill postage

Elige el agente y el alcance de instalación cuando se te solicite. La habilidad se llama postage. Usa /postage en clientes con comandos de barra de habilidades, o $postage en Codex. La habilidad incluye su propia CLI, sin dependencias de paquetes. Instalarla no envía correo ni financia una cuenta.

Para cualquier agente con acceso a shell y Node.js 22+, la CLI no requiere instalación de paquetes:

curl -fsS https://agentpostage.com/agentpostage.mjs -o agentpostage.mjs
node agentpostage.mjs --help
node agentpostage.mjs balance
node agentpostage.mjs price --pages 3 --service first_class

Revisa el código descargado antes de ejecutarlo. Las verificaciones de saldo y precios no envían correo. El código fuente de la CLI también está incluido en este repositorio.

Envía mi PDF de cancelación de gimnasio a [dirección del destinatario] usando AgentPostage First-Class, con [mi dirección de remitente]. Registra el ID de la carta y el costo, luego verifica su estado de envío.

Tu agente actúa dentro de la autoridad y los límites que ya le has delegado. AgentPostage no agrega un flujo de aprobación por carta.

Más indicaciones cubren disputas bancarias, solicitudes a agencias de crédito, seguimiento y acuses de recibo.

Elige tu conexión

Agente o entorno de ejecución	Conexión
OpenClaw, Hermes Agent	Instala la habilidad con acceso a shell, o usa su configuración remota de MCP
Codex	Instala el complemento de habilidad local del repositorio, o configura MCP HTTP con una variable de entorno Bearer
Claude Code	Instala el complemento de habilidad, o conéctate a través de MCP HTTP remoto
Cursor	Importa el repositorio como complemento, instala la habilidad portátil, o conéctate a través de MCP HTTP remoto
Gemini CLI	Instala la extensión para MCP remoto y las instrucciones compartidas de correo
ChatGPT	GPT personalizado privado con Acciones y autenticación por clave API
Muse, bots de Grok, otros entornos con capacidad de herramientas	CLI, HTTP o MCP remoto donde el entorno exponga esas capacidades

Instrucciones de configuración explican los requisitos previos y los límites. Un nombre de modelo por sí solo no proporciona herramientas ni permiso para enviar correo.

Cuánto cuesta

Precios minoristas en USD, tarifa 2026-09-17-retail:

Servicio	Primera página PDF en blanco y negro
First-Class	$4
First-Class con endoso de Declaración de Propietario Adjunta	$4
First-Class plano	$6
Certificado con seguimiento	$12
Certificado con seguimiento y acuse de recibo electrónico	$15

Cada página PDF adicional cuesta $0.30. El color agrega $0.30 por página PDF, incluida la primera. El papel no blanco agrega $0.10 por hoja de documento. Un sobre de respuesta sin franquear agrega $0.50, o $1.50 por un paquete de doce. La impresión a doble cara mantiene el precio por página y usa dos páginas de documento por hoja. La portada con la dirección está incluida, sin cargo adicional por página u hoja.

Puedes verificar un precio exacto usando el número real de páginas del documento y las opciones de impresión. Una verificación de precio no reserva una tarifa. El envío fija el precio actual cuando la carta se pone en cola. Consulta la referencia de precios actual.

Envía con cuidado

El envío pone en cola correo real y pagado de inmediato. Usa el documento, las direcciones, el servicio y las opciones de impresión cubiertos por la delegación existente del usuario. Los humanos y los hosts de agentes gestionan sus propios límites de gasto y permisos. Guarda una clave de idempotencia por carta prevista y reutilízala con entrada idéntica después de un tiempo de espera. Una clave nueva puede crear correo duplicado.

queued significa guardado para enviar. No significa enviado. First-Class termina en el envío confirmado, sin confirmación individual de entrega. Certificado puede proporcionar evidencia de entrega, y un acuse de recibo electrónico puede llegar más tarde.

El servicio acepta PDFs y direcciones de EE. UU. No redacta documentos, garantiza resultados legales ni promete una fecha de entrega. Tu agente puede ayudar a preparar un PDF por separado.

Referencia y desarrollo

• API, CLI, límites de archivos y manejo de reintentos
• Configuración de agente e instalación del complemento de Codex
• Habilidad de correo
• Documentación de API en vivo, OpenAPI y referencia de agente

Ejecuta las verificaciones sin conexión con Node.js 22+:

node --test tests/*.test.mjs

Las pruebas usan una API simulada local y datos sintéticos. No envían correo ni cargan a una cuenta. Los archivos de integración tienen licencia MIT. El envío de correo es un servicio de pago regido por las políticas aceptadas durante la configuración de la cuenta.